Tools
開啟 Dashboard → Tools,先確認目前 Profile,再檢查所需能力。這裡列出執行環境可用的工具;目前對話向模型宣告了哪些工具,還取決於工作階段選擇和作用域。
找到對應入口
| 頁面分類 | 可做的操作 |
|---|---|
| Built-in | 檢視內建定義;進入 Codemode 設定 |
| MCP | 檢視已啟用 Server 目前提供的工具 |
| Image、Video | 設定圖片理解、圖片產生和影片理解模型路由 |
| Voice | 設定語音辨識與語音合成路由 |
| Web Search | 設定公開網頁搜尋後端 |
開啟一項內建或 MCP 工具,可以核對來源、Toolset、描述、輸入 Schema、逾時以及可見/儲存輸出預算。定義和預算在這裡唯讀。MCP 的遠端定義來自 Server 目錄,要改變暴露方式請到 MCP。
結果被截短時,應按照結果提示繼續讀取,或用 tool_result_read 讀取可完整檢查的邏輯結果引用;頁面有預算值不代表每次結果都儲存了完整正文。詳見內建工具參考。
設定 Codemode
入口是 Tools → Built-in → codemode。它讓模型用 JavaScript 呼叫目前工作階段已有工具;腳本用法和模型 API 見 Codemode。頁面上的兩種儲存操作作用不同。
給後續工作階段設定預設值
在 Profile 區域選擇啟用方式和模式,點選 Save:
| 啟用方式 | 含義 |
|---|---|
| Use current tool selection | 沿用工具選擇和 MCP 自動啟用規則,不代表關閉 |
| Enable | 為新工作階段預設選擇新增 Codemode |
| Disable | 為新工作階段顯式排除 Codemode |
on 保留直接工具入口,也允許腳本;only 隱藏請求中可由腳本呼叫的直接宣告,這些工具仍可透過 Codemode 使用。模式是 Profile 共享設定,在下一次準備請求時採用,不修改已準備的請求。模式本身不會啟用 Codemode,也不是 Role。
儲存 Profile 預設值不會重選已有工作階段。其他工具規則和排除項保持其作用;若單獨修改 Codemode 必須同時改變其他規則,儲存會失敗並保留原設定。
頁面區分 Applied 與 Saved, not yet applied。手工編輯設定檔後,應在這裡明確儲存,或重啟 Gateway;Provider reload 不負責套用工具設定。
修改一個已有工作階段
- 在 Session override 選擇目標工作階段並檢視狀態。
- 等待工作階段空閒,且沒有排隊輸入。
- 選擇啟用/停用,再點選 Apply to Session。
- 檢視回傳狀態,確認操作生效。
該操作只切換 Codemode,保留工作階段其他活動工具和選擇規則;不會擴大受限工作階段原有的允許清單。因此 Profile 預設已經啟用時,舊的受限工作階段仍可能拒絕啟用。Not loaded yet 表示尚未觀察到該工作階段的常駐工具狀態,不能據此判斷已經關閉。工作階段沒有單獨的模式欄位。
MCP 與工具搜尋是否一起改變
不會。MCP 設定可在規則允許時自動啟用 Codemode;沿用目前選擇會保留這個行為,顯式排除仍然優先。停用 Codemode 不會停用 MCP 或 tool_search;已允許且活動的工具搜尋仍能發現間接 MCP 工具。頁面會提示剩餘可用路徑。
工具搜尋說明下一個請求中的啟用規則;CLI 參數與手工設定見 Toolset 工具組。
設定和檢查功能後端
Web Search 卡片可以選擇 Provider、Endpoint 和認證資料並驗證。圖片、影片與語音卡片重複使用模型設定入口,設定各自路由。
CLI 可檢視或檢查同一套能力:
anyy tools list
anyy tools websearch
anyy tools image --probe
anyy tools image generation --probe
anyy tools video understanding --probe
anyy tools voice tts --probe
anyy tools voice stt --probe
後端已設定,不代表已有工作階段會立即宣告該工具。先確認後端可用,再核對 Profile、Toolset 和工作階段選擇;Codemode 則使用上面的工作階段專用操作。
常見問題
| 現象 | 排查位置 |
|---|---|
| 頁面列出工具,對話卻看不到 | 工作階段活動選擇、工具組和父任務限制 |
| MCP 工具缺失 | Server 是否啟用、連線狀態、Exposure 和發現工具 |
| Codemode 的 Profile 儲存成功,舊工作階段仍關閉 | 對目標空閒工作階段另外執行 Apply to Session |
| 輸出只剩摘要 | 結果的繼續讀取提示、邏輯引用與實際保留方式 |