ツール

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

カスタムユーザー定義ツールもサポートされています。アプリケーションがこれらのツールを個別に実行し、ツール結果をClaudeに送り返します。Claudeは結果を使用して、進行中のタスクを続行できます。

利用可能なツール

エージェントツールセットには、以下のツールが含まれています。エージェント設定にツールセットを含める場合、すべてがデフォルトで有効になります。

ツールセットの設定

エージェント作成時にagent_toolset_20260401を使用してフルツールセットを有効にします。configs配列を使用して、特定のツールを無効にするか、その設定をオーバーライドします。

特定のツールを無効にする

ツールを無効にするには、その設定エントリでenabled: falseを設定します：

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

特定のツールのみを有効にする

すべてをオフにして、必要なものだけを有効にするには、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の機能を拡張して、より多くの種類のタスクを実行できます。各ツールは契約を定義します。利用可能な操作とそれが返すものを指定し、Claudeはいつどのように呼び出すかを決定します。モデルは独自に何も実行しません。構造化されたリクエストを発行し、コードが操作を実行し、結果が会話に戻ります。

エージェントレベルでツールを定義したら、エージェントはセッションの過程でツールを呼び出します。完全なフローについては、セッションイベントストリームを参照してください。

カスタムツール定義のベストプラクティス

• 非常に詳細な説明を提供してください。 これはツールのパフォーマンスに最も重要な要因です。説明には、ツールが何をするのか、いつ使用すべきか（そしていつ使用すべきでないか）、各パラメータが何を意味するのか、ツールの動作にどのように影響するのか、および重要な注意事項や制限事項を説明する必要があります。Claudeのツールについて提供できるコンテキストが多いほど、いつどのようにそれらを使用するかを決定するのが上手になります。ツール説明ごとに少なくとも3～4文を目指し、ツールが複雑な場合はそれ以上を目指してください。
• 関連する操作を少数のツールに統合してください。 すべてのアクション（create_pr、review_pr、merge_pr）に対して個別のツールを作成するのではなく、actionパラメータを持つ単一のツールにグループ化してください。少数の、より機能的なツールは選択の曖昧性を減らし、Claudeがツール表面をナビゲートしやすくします。
• ツール名に意味のある名前空間を使用してください。 ツールが複数のサービスまたはリソースにまたがる場合、名前にリソースをプレフィックスします（例：db_query、storage_read）。これにより、ライブラリが成長するにつれてツール選択が曖昧でなくなります。
• ツール応答を設計して、高シグナル情報のみを返すようにしてください。 不透明な内部参照ではなく、セマンティック、安定した識別子（例：スラッグまたはUUID）を返し、Claudeが次のステップについて推論するために必要なフィールドのみを含めてください。肥大化した応答はコンテキストを浪費し、Claudeが重要なものを抽出するのを難しくします。