文件

Tools & MCP

以 docs 內建流程說明工具層能力如何與 API 協作,支援 agent 與自動化任務。

Tools & MCP#

Tools & MCP 提供 API 之外的工具呼叫介面,讓 agent 或自動化流程能用穩定的參數與輸出格式存取資料能力。

它不是獨立內容系統,而是同一套 docs 架構中的能力說明頁,便於與 API 文件一起維護。

適用情境#

以下情境適合優先使用 Tools & MCP:

  • AI agent 需要把查詢步驟拆成可重放、可追蹤的流程
  • 自動化任務需要固定輸入/輸出契約,避免整合歧義
  • 研究流程需要在多次執行中保持一致的資料呼叫方式

典型工作流程#

常見流程可分成四步:

  • 先定位資料主題與可用欄位
  • 再發送查詢並回收結構化結果
  • 檢查來源、lineage 與時間資訊
  • 將結果回填到策略或分析流程

可呼叫的工具型能力#

目前以 deterministic 能力為主:

  • 搜尋類工具:快速定位標的、主題與 endpoint
  • 查詢類工具:依 allowlist 取回欄位資料
  • 解釋類工具:回傳欄位來源、規則與 freshness 基礎

與一般 API 存取的差異#

一般 API 著重 request/response 契約;Tools & MCP 著重工作流程可組合、可追溯與 agent 友善整合。

兩者互補使用:API 提供底層資料能力,Tools & MCP 提供流程化呼叫層。