工具

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

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



可用工具

代理工具集包含以下工具。當您在代理設定中包含此工具集時，所有工具預設皆為啟用狀態。請使用「名稱」欄中的值在 configs 陣列中參照工具。

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



設定工具集

建立代理時，使用 agent_toolset_20260401 啟用完整工具集。使用 configs 陣列來停用特定工具或覆寫其設定。每個 config 項目也可以設定 permission_policy，用於控制該工具的呼叫是自動核准還是需要確認。請參閱權限政策以了解可用的政策類型。

ant beta:agents create <<'YAML'
name: Coding Assistant
model: claude-opus-4-8
tools:
  - type: agent_toolset_20260401
    configs:
      - name: web_fetch
        enabled: false
YAML



停用特定工具

若要停用某個工具，請在代理 tools 陣列的工具集物件中，於該工具的 config 項目設定 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 }
  ]
}



自訂工具

除了內建工具之外，您還可以定義自訂工具。自訂工具類似於 Messages API 中的使用者定義的用戶端工具。

每個自訂工具都定義了一份契約：您指定可用的操作及其回傳內容，而 Claude 則決定何時以及如何呼叫它們。模型本身從不執行任何操作。它會發出結構化的請求，由您的程式碼執行該操作，然後將結果回傳至對話中。請參閱工作階段事件串流，了解如何在工作階段期間接收自訂工具呼叫並回傳結果。

ant beta:agents create <<'YAML'
name: Weather Agent
model: claude-opus-4-8
tools:
  - type: agent_toolset_20260401
  - type: custom
    name: get_weather
    description: Get current weather for a location
    input_schema:
      type: object
      properties:
        location:
          type: string
          description: City name
      required:
        - location
YAML

在代理上定義自訂工具後，代理會在工作階段期間呼叫這些工具。



自訂工具定義的最佳實務

• 提供極為詳細的說明。 這是影響工具效能最重要的因素。您的說明應解釋該工具的功能以及何時使用（以及何時不該使用）。說明每個參數的含義及其如何影響工具的行為。指出任何重要的注意事項或限制。您提供給 Claude 關於工具的上下文越多，它就越能判斷何時以及如何使用這些工具。每個工具說明應至少包含三到四個句子，若工具較為複雜則應更多。
• 將相關操作整合為較少的工具。 與其為每個動作建立單獨的工具（create_pr、review_pr、merge_pr），不如將它們整合為單一工具並搭配 action 參數。較少但功能更強大的工具可減少選擇上的模糊性，並讓 Claude 更容易瀏覽您的工具介面。
• 在工具名稱中使用有意義的命名空間。 當您的工具橫跨多個服務或資源時，請在名稱前加上資源前綴（例如 db_query 或 storage_read）。隨著您的工具庫擴大，這可使工具選擇更加明確。
• 設計工具回應時僅回傳高價值資訊。 回傳語意化且穩定的識別碼（例如 slug 或 UUID），而非不透明的內部參照，並僅包含 Claude 判斷下一步所需的欄位。臃腫的回應會浪費上下文，並使 Claude 更難提取重要資訊。



後續步驟