ツール

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が重要な情報を抽出することを難しくします。