文件
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 提供流程化呼叫層。