Tool Group · 跨資產預測
Cross-Asset Forecast
Cross-Asset Forecast 提供支援商品或指數的 quarter-end forecasted price 與 forecasted return。若商品覆蓋不確定，agent 必須先查支援清單。
驗證狀態：artifact-confirmed。範例與 assertions 由 validation/tool_usage_cases.json 管理。
Forecast 資料
Permission · standardBilling · x1Method · GETContainer · records / valuesOutput · data / raw
Tools
| Tool | API Path | Method | Container | 說明 | Best for |
|---|---|---|---|---|---|
get_cross_asset_forecast | /API/module5 | GET | records | 查詢商品或指數的 quarter-end forecasted price 與 forecasted return。 | 跨資產預測、季度展望 |
list_cross_asset_forecast_products | /API/module5_product_list | GET | values | 查詢 forecast 支援的商品或指數，避免對未覆蓋商品發起錯誤查詢。 | Forecast coverage discovery |
參數 Parameters
get_cross_asset_forecast
| 參數 | 型別 | 必填 | 預設 | 說明 |
|---|---|---|---|---|
code | string | ✅ | 2330 TT Equity | GAS Quant canonical 商品或指數代碼。 |
start_date | string (YYYY-MM-DD) | ✅ | — | 區間起日。 |
end_date | string (YYYY-MM-DD) | ✅ | — | 區間迄日。 |
output_mode | string | — | data | data / raw。 |
list_cross_asset_forecast_products
| 參數 | 型別 | 必填 | 預設 | 說明 |
|---|---|---|---|---|
query | string | — | "" | 不分大小寫的篩選字串。 |
limit | integer | — | 100 | 回傳上限，最大 500。 |
output_mode | string | — | data | data / raw。 |
get_cross_asset_forecast
- 適用：指定商品或指數的季底 forecast price 與 return。
- 必要資訊：
code、start_date、end_date。 - 不可臆測：商品支援狀態、預測值、日期與不確定性。
請查詢正式商品代碼 2330 TT Equity 在 2025-07-01 到 2025-07-31 的季底預測價格與預測報酬，並標示資料日期與限制。
回答應包含 canonical code、forecast horizon、forecasted price、forecasted return、資料日期、warnings 與非保證聲明。
支援商品
list_cross_asset_forecast_products
- 適用：解析 forecast coverage 與正式商品／指數代碼。
- 必要資訊：可提供
query與limit。 - 不可臆測：未出現在回傳結果中的 coverage。
請列出跨資產預測支援、代碼包含 2330 的商品或指數，最多 20 筆。
查不到時應回報無匹配結果並請使用者確認代碼，不可直接改查另一商品。
常見失敗
| 症狀 | 處理方式 |
|---|---|
| 商品不在 coverage | 先用支援商品清單搜尋 canonical code。 |
| 日期格式或範圍錯誤 | 使用 YYYY-MM-DD 並確認 start 不晚於 end。 |
| 回傳空資料 | 不可生成預測；回報商品、日期與來源診斷。 |
Forecast 僅是量化研究參考，不是保證價格、個人化目標價或交易指令。
回傳格式 Response
共用 envelope 見 工具總覽。
get_cross_asset_forecast→ records 容器：data.records（含 forecasted_quarter、forecasted price / return 等欄位）、data.columns、data.total_count、data.available_count。list_cross_asset_forecast_products→ values 容器：data.values（支援的商品 / 指數代碼）、data.total_count、data.available_count。
待 live 校正
records 的實際欄位名（forecasted price / return 的欄位）以 /API/module5 回傳為準，將以 dev 端實打結果補上。
AI 回應示意
使用者拿到的是 AI 依預測資料整理後的展望，而非原始 JSON。示意（內容依商品與當日資料而定）：
季底預測 · 指定商品｜資料日：依回傳
data_date
- forecasted price 與 forecasted return 的數值與對應 quarter
- 與目前水位的相對關係（偏多 / 偏空 / 持平）
- 不確定性與適用範圍提醒
- ⚠️ 量化研究參考，不代表保證價格或報酬
每段回應都會帶上 預測季別、資料日期 與 不確定性 / 非投資建議聲明。