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。可見工具執行失敗則看認證資料、輸入校驗、作業系統權限和後端結果。工具組組織暴露與上下文額外成本,不授予系統權限。