跳至主要內容

Toolset 工具組

看到工具名之前,先分清兩層選擇:Profile/工作階段工具組和父任務限制決定哪些工具有資格進入工具清單;Session 再從目前工具清單選擇直接宣告和可呼叫工具。歷史儲存的名稱或 Schema 是證據,不是第二套阻止新工具註冊的權限門檻。

檢視目前工具清單​

Dashboard → Tools → Built-in 可以檢視來源、Toolset、定義、逾時與結果預算。這裡不是目前 Session 活動宣告清單,定義也不可直接編輯。Dashboard 沒有可任意切換每個預設工具組的通用編輯器;可選能力在對應入口設定,MCP 另外管理。

預設有資格的主要工具組如下:

組能力
file、terminal檔案和指令/程序
web公開網頁搜尋與獲取
artifact工作階段檔案的檢視、Pin 與匯出
sessions、memory歷史工作階段搜尋與長期記憶
tasks、automation個人任務和計畫工作
clarify結構化補充輸入
messaging目前通訊管道範圍內的投遞
skills代管 Skill 庫寫入;讀取依靠 read/bash
subagents委派、背景工作和子工作階段控制
tts設定路由後的語音合成

有資格不代表每項都預設活動。可移植工具的預設活動名稱是 read、bash、edit、write,產品工具另有預設活動條目。實際可用性還取決於認證資料和後端。

用參數選擇工作階段工具​

anyy --tools '+codemode,+tool_search'
anyy --resume SESSION_ID --tools '+codemode,+tool_search'
anyy chat --session SESSION_ID --tools 'read,bash' "只检查项目"

純名稱清單替換預設選擇;+name/-name 在 Profile 預設集合上增減,不是在復原工作階段目前活動集合上增減,不能與純名稱選擇混用。顯式空清單表示真正的空選擇。名稱、萬用字元及停用選項詳見對話工具選擇。

已有工作階段必須空閒且沒有待處理輸入,才能透過顯式附加改變選擇;不帶覆蓋參數時,熱工作階段保留目前狀態。參數規則保留在常駐 Session 中,不寫 config.yaml,也不跨 Gateway 重啟儲存。分支中記錄的活動名稱可以復原,再按目前 Profile 規則篩選;需要同一顯式規則時應重新在空閒時附加。

Codemode 與工具搜尋​

兩個內建工具預設都不活動。顯式選擇或適用 MCP 自動啟用規則可啟用;兩者獨立,切換 Codemode 不改變 tool_search 或 Role。

Profile 設定示例:

default_tools:
- "+codemode"
- "+tool_search"
codemode:
mode: on
inline_budget: 3000

mode 不是啟用切換開關。on 保留直接宣告,only 隱藏可經腳本呼叫的直接宣告,控制代碼仍可呼叫,canonical 宣告仍儲存。inline_budget 限制腳本內聯工具說明,不是整個工作階段上下文大小。沒有專用 Codemode CLI flag 或 Role 欄位。

推薦透過 Tools → Built-in → codemode 儲存預設值,並對選定的空閒工作階段另做 Apply to Session。Profile Save 不重選已有工作階段;工作階段 Apply 只切換 Codemode,不擴大該工作階段允許清單。手改檔案後要明確儲存或重啟,Provider reload 不套用工具設定。頁面說明列出狀態區別。

腳本在獨立 VM 中執行,首次載入也計入時限;無需 Node.js。成功 store 屬於所選工作階段分支並可在資料庫重開後讀取;逾時/失敗保留部分輸出但丟棄該腳本未提交 store,已發生的工具效果不還原。完整 API 見 Codemode,搜尋啟用見工具搜尋。

暴露方式與範圍​

Exposure作用
direct活動時通常直接宣告並可呼叫
codemode、deferred從註冊工具清單間接呼叫,不要求先有直接宣告
model-only可宣告給模型,腳本不能呼叫
hidden不宣告,也不可呼叫

MCP 使用 Server exposure 和有序 toolExposure,不產生 mcp-NAME 個人工具組。適用設定可自動啟用發現工具,但顯式排除和父任務限制優先;停用 Codemode 後,允許的活動工具搜尋仍可能找到間接 MCP 工具。

活動 Skill 僅在 Session 仍用 Profile 預設工具組時可請求附加組;顯式回合選擇或已縮小 Session 選擇優先。附件回合可加入作用域內的 artifact。子工作階段不能擴大父工作階段範圍,Role 本身不負責工具權限。

若工具缺失,依次核對產品組資格、Exposure、Session 選擇與父任務限制;MCP 還要檢查 Server 就緒和 offering。可見工具執行失敗則看認證資料、輸入校驗、作業系統權限和後端結果。工具組組織暴露與上下文額外成本,不授予系統權限。