Claude Platform Docs
Managed Agents定義您的代理

工具

設定您的代理可使用的工具。

Claude Managed Agents 提供一組內建工具，Claude 可以在 session（工作階段）中自主使用這些工具。您可以透過在代理設定中指定工具，來控制哪些工具可供使用。

Claude Managed Agents 也支援自訂的使用者定義工具。您的應用程式會另行執行這些工具，並將結果回傳給 Claude，Claude 再利用這些結果繼續執行任務。若要為代理提供來自 MCP 伺服器的工具，請改用 MCP 連接器。

可用工具

代理工具集包含下列工具。當您在代理設定中納入此工具集時，所有工具預設皆為啟用。

工具名稱說明
Bashbash在 shell 工作階段中執行 bash 指令
Readread從沙箱檔案系統讀取檔案
Writewrite將檔案寫入沙箱檔案系統
Editedit在檔案中執行字串取代
Globglob使用 glob 模式進行快速檔案模式比對
Grepgrep使用正規表示式模式進行文字搜尋
Web fetchweb_fetch從 URL 擷取內容
Web searchweb_search在網路上搜尋資訊

當工具輸出超過 100,000 個字元（約 25,000 個 token）時，會自動寫入 sandbox（沙箱）中的檔案。模型會收到包含檔案路徑的截斷預覽，並可從該處讀取完整內容。

設定工具集

建立代理時，使用 agent_toolset_20260401 啟用完整工具集。使用 configs 陣列來停用特定工具或覆寫其設定。每個項目以其 name 識別，其值取自可用工具中的「名稱」欄。項目也接受一個選用的 type 欄位，其值相同。

每個設定項目也可以設定 permission_policy。此政策控制工具的呼叫是無需確認即執行、需要確認，還是由伺服器逐一評估。請參閱權限政策以了解可用的政策類型。

下列範例啟用工具集並停用 web_fetch：

ant apply agent.md
agent.md
---
name: Coding Assistant
model: claude-opus-5-5
tools:
  - type: agent_toolset_20260401
    configs:
      - name: web_fetch
        enabled: false
---

停用特定工具

若要停用某個工具，請在其 configs 項目中設定 enabled: false：

{
  "type": "agent_toolset_20260401",
  "configs": [
    { "name": "web_fetch", "enabled": false },
    { "name": "web_search", "enabled": false }
  ]
}

僅啟用特定工具

default_config 物件為工具集中的每個工具設定基準，而各工具的 configs 項目會覆寫它。若要從全部關閉開始，僅啟用您需要的工具，請將 default_config.enabled 設為 false：

{
  "type": "agent_toolset_20260401",
  "default_config": { "enabled": false },
  "configs": [
    { "name": "bash", "enabled": true },
    { "name": "read", "enabled": true },
    { "name": "write", "enabled": true }
  ]
}