代理工具架構建構

代理工具架構建構 是做什麼的？

當您正在改善代理如何規劃、呼叫工具、從錯誤中恢復以及收斂至完成時，請使用此技能。

核心模型

代理輸出品質受到以下因素限制：

1. 行動空間品質
2. 觀察回饋品質
3. 恢復品質
4. 上下文預算品質

行動空間設計

1. 使用穩定且明確的工具名稱。
2. 保持輸入結構以 schema 為優先，並盡量窄化。
3. 回傳確定性的輸出形狀。
4. 除非無法隔離，否則避免使用萬用工具。

粒度規則

• 對高風險操作（部署、遷移、權限）使用微工具。
• 對常見的編輯/讀取/搜尋循環使用中工具。
• 僅在往返開銷是主要成本時使用巨工具。

觀察設計

每個工具回應應包含：

• status: success|warning|error
• summary: 一行結果
• next_actions: 可操作的後續步驟
• artifacts: 檔案路徑 / ID

錯誤恢復合約

對於每個錯誤路徑，應包含：

• 根本原因提示
• 安全重試指令
• 明確的停止條件

上下文預算

1. 保持系統提示精簡且不變。
2. 將大型指引移至按需載入的技能中。
3. 優先使用檔案參考，而不是內嵌長文件。
4. 在階段邊界進行壓縮，而非依據任意 token 門檻。

架構模式指引

• ReAct：最適合探索性任務，路徑不確定。
• 函式呼叫：最適合結構化確定性流程。
• 混合模式（推薦）：ReAct 規劃 + 型別工具執行。

基準測試

追蹤：

• 完成率
• 每個任務的重試次數
• pass@1 與 pass@3
• 每個成功任務的成本

反模式

• 工具數量過多且語意重疊。
• 工具輸出不透明，無恢復提示。
• 僅回傳錯誤輸出，無後續步驟。
• 上下文過載，充斥不相關的參考。