ツール

Claude Managed Agentsは、Claudeがセッション内で自律的に使用できる組み込みツールのセットを提供します。エージェント設定でツールを指定することで、どのツールを利用可能にするかを制御できます。

Claude Managed Agentsは、ユーザー定義のカスタムツールもサポートしています。アプリケーションがこれらのツールを個別に実行し、その結果をClaudeに返すと、Claudeはそれを使用してタスクを続行します。MCPサーバーのツールをエージェントに提供するには、代わりにMCPコネクタを使用してください。



利用可能なツール

エージェントツールセットには以下のツールが含まれています。エージェント設定にツールセットを含めると、すべてがデフォルトで有効になります。configs配列でツールを参照するには、「名前」列の値を使用してください。

ツールの出力が100,000トークンを超えると、自動的にサンドボックス内のファイルに書き込まれます。モデルはファイルパスとともに切り詰められたプレビューを受け取り、そこから完全な内容を読み取ることができます。



ツールセットの設定

エージェントを作成する際に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に提供できるコンテキストが多いほど、Claudeはいつどのようにツールを使用するかをより適切に判断できます。各ツールの説明は3〜4文を目安とし、ツールが複雑な場合はそれ以上にしてください。
• 関連する操作をより少ないツールに統合してください。 すべてのアクションに対して個別のツール（create_pr、review_pr、merge_pr）を作成するのではなく、actionパラメータを持つ単一のツールにグループ化してください。より少なく、より高機能なツールにすることで、選択の曖昧さが減り、Claudeがツール群を扱いやすくなります。
• ツール名に意味のある名前空間を使用してください。 ツールが複数のサービスやリソースにまたがる場合は、名前にリソースのプレフィックスを付けてください（例：db_queryやstorage_read）。これにより、ツールライブラリが拡大してもツール選択が明確になります。
• ツールのレスポンスは重要な情報のみを返すように設計してください。 不透明な内部参照ではなく、意味的で安定した識別子（例：スラッグやUUID）を返し、Claudeが次のステップを判断するために必要なフィールドのみを含めてください。肥大化したレスポンスはコンテキストを無駄にし、Claudeが重要な情報を抽出しにくくなります。



次のステップ