ツール

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

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



利用可能なツール

エージェントツールセットには以下のツールが含まれています。エージェント設定にツールセットを含めると、すべてがデフォルトで有効になります。configs配列の各エントリは、「名前」列の値を使用したnameで識別され、同じ値を持つオプションのtypeフィールドを受け入れます。web_searchおよびweb_fetchエントリは追加の設定を受け入れます。詳細はウェブ検索とウェブ取得のドメインを制限するを参照してください。

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



ツールセットの設定

エージェントを作成する際にagent_toolset_20260401を指定して、完全なツールセットを有効にします。特定のツールを無効にしたり、その設定を上書きしたりするには、configs配列を使用します。各設定エントリには、ツールの呼び出しが自動承認されるか確認が必要かを制御するpermission_policyも設定できます。利用可能なポリシータイプについては、権限ポリシーを参照してください。

web_searchおよびweb_fetchの設定エントリは、ドメインフィルターやその他のウェブ設定も受け入れます。詳細はウェブ検索とウェブ取得のドメインを制限するを参照してください。

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



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

ツールを無効にするには、エージェントのtools配列内のツールセットオブジェクトの設定エントリで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 }
  ]
}



ウェブ検索とウェブ取得のドメインを制限する

エージェントのウェブツールがアクセスできるサイトを制御するには、ツールセットのconfigs配列内のweb_searchおよびweb_fetchエントリにallowed_domains（ツールはこれらのホストにのみアクセス可能）またはblocked_domains（ツールはこれらのホストに決してアクセスできない）を設定します。各ツールは独自のリストを持つため、web_searchとweb_fetchで異なる制限を設定できます。リストに記載されたドメインは、そのホストとそのすべてのサブドメインをカバーします。実行時に、リストで許可されていないURLに対するweb_fetch呼び出しは、エージェントにエラー結果を返します（agent.tool_resultイベントでis_error: trueとなり、エラーコードurl_not_allowedを示すコンテンツが含まれます）。また、web_searchはリストで許可されていない結果を除外します。

以下のツールセットは、web_searchを2つのサイトに制限してその結果をローカライズし、web_fetchでは1つのホストをブロックしつつ、取得したコンテンツがコンテキストに入る量を制限します。

{
  "type": "agent_toolset_20260401",
  "configs": [
    {
      "type": "web_search",
      "name": "web_search",
      "allowed_domains": ["docs.example.com", "arxiv.org"],
      "user_location": {
        "type": "approximate",
        "country": "US",
        "timezone": "America/Los_Angeles"
      }
    },
    {
      "type": "web_fetch",
      "name": "web_fetch",
      "blocked_domains": ["ads.example.com"],
      "max_content_tokens": 50000
    }
  ]
}

以下のリクエストは、このツールセットを持つエージェントを作成し、レスポンスからconfigs配列を出力します。

ant beta:agents create --transform tools.0.configs <<'YAML'
name: Research Agent
model: claude-opus-5
tools:
  - type: agent_toolset_20260401
    configs:
      - type: web_search
        name: web_search
        allowed_domains: [docs.example.com, arxiv.org]
        user_location:
          type: approximate
          country: US
          timezone: America/Los_Angeles
      - type: web_fetch
        name: web_fetch
        blocked_domains: [ads.example.com]
        max_content_tokens: 50000
YAML

Claude Consoleでは、エージェントフォームのBuilt-in toolsカードにあるweb_searchおよびweb_fetchの行から許可ドメインまたはブロックドメインを設定します。max_content_tokensとuser_locationは、エージェント設定のRawビューで設定します。

enabledとpermission_policyに加えて、ウェブツールのエントリは以下の設定を受け入れます。



ドメインリストのルール

• エントリにはallowed_domainsまたはblocked_domainsのいずれかを設定し、両方は設定しないでください。両方を設定したエントリは拒否されます。
• 各リストには1〜64個のドメインを含め、各ドメインは1〜255文字です。空のリストは拒否されます。制限を適用しない場合は、フィールドを省略するかnullを送信してください。
• 各ドメインは、登録可能なドメイン名またはそのサブドメインで、プレーンなホスト名として記述します。ASCII文字、数字、ハイフン、アンダースコア、ドットのみを使用し、スキーム、ポート、認証情報、ワイルドカード、空白を含めず、ハイフンで始まるまたは終わるラベルを含めず、このリストの後半で説明するオプションのweb_searchパスサフィックス以外のパスを含めません。https://example.com、example.com:443、*.example.comではなく、example.comを使用してください。ホスト名は大文字小文字を区別せずに比較され、末尾の単一の/は無視されます。
• リストに記載されたドメインは、そのホストとそのサブドメインに一致します。example.comはdocs.example.comをカバーしますが、docs.example.comはexample.comやapi.example.comをカバーしません。先頭のwww.は他のサブドメインと同様に扱われるため、www.example.comはexample.comをカバーしません。両方をカバーするには、ベアドメインをリストに記載してください。
• IPアドレスは、IPv4、IPv6、角括弧付き、127.1のような数値省略形のいずれの形式でも受け入れられません。代わりにサイトのドメイン名をリストに記載してください。
• com、co.uk、gov.ukなどのベアトップレベルドメインやレジストリサフィックスは拒否され、intranetのような単一ラベル名も拒否されます。example.co.ukのような完全なドメインをリストに記載してください。
• localhost、および.localhost、.local、.internal、.localdomain、.invalidで終わるホストは拒否されます。
• 国際化ドメイン名にはxn--（Punycode）形式を使用してください。非ASCII文字を含むドメインは拒否されます。
• web_fetchのドメインにはパスを含めることができません。example.com/*ではなくexample.comを使用してください。web_searchのドメインにはexample.com/blogのようなパスサフィックスを付けることができますが、そのパスにはスペース、?、#、または$ , | ^ !のいずれの文字も含めることができません。検索プロバイダーはパスサフィックスを厳密なホストルールではなくURLパターンとして照合するため、web_searchでもプレーンなホスト名を使用することをお勧めします。
• リスト内の重複ドメインは拒否されます。www.example.comとexample.comは異なるドメインとしてカウントされます。それぞれがカバーする範囲については、前述の一致ルールを参照してください。



設定が検証されるタイミング

形式および制限の違反は、エージェントを作成またはエージェントを更新する際、およびtoolsを指定してセッションを作成または更新する際に、400 invalid_request_errorで拒否されます。たとえば、両方のリストを設定したエントリのメッセージにはOnly one of allowed_domains or blocked_domains may be set.が含まれ、空のリストのメッセージにはallowed_domains: Empty list of domains is ambiguous. Provide at least one domain or null.が含まれます。形式ルールに違反するドメインのメッセージは、そのリストとゼロベースの位置を示します。たとえば、allowed_domains.0: IP addresses are not supported; provide a plain hostname like "example.com"のようになります。

同じリクエストでは、検索および取得プロバイダーに依存する3つの設定も拒否されます。Anthropicのクローラーがアクセスを許可されていないallowed_domains内のドメイン、検索プロバイダーがサポートしていないuser_location.country（メッセージはuser_location.country: not a country the search provider supportsで終わります）、および有効なIANA名ではないuser_location.timezoneです。セッションは、ツールを最初に初期化する際に設定を再度チェックします。以前に受け入れられた設定がその時点で有効でなくなった場合、セッションはsession.errorイベントを発行し、再試行せずにidleに戻ります。セッションのツールを更新して設定を修正し、新しいセッションが修正された設定で開始されるようにエージェントも更新してから、新しいuser.messageを送信して続行してください。



マルチエージェントセッション、アウトカム、セッション中の更新

マルチエージェントセッションでは、スレッドに適用されるすべてのドメインリストが同時に適用されます。コーディネーターのロスター内のエージェントは、自身のallowed_domainsとblocked_domains、それを呼び出したエージェントのリスト、およびコーディネーターの現在のリストに拘束されます。

• 許可リストはそれらすべてがカバーするドメインに絞り込まれ、ブロックリストは合算されるため、ロスターエージェントはツールがアクセスできる範囲を狭めることはできますが、広げることはできません。たとえば、blocked_domainsを設定したロスターエージェントは、コーディネーターのallowed_domainsを維持しつつ、その中でそれらのホストをブロックします。また、独自のallowed_domainsを設定したロスターエージェントは、自身のリストとコーディネーターのリストの両方がカバーするホストにのみアクセスできます。
• 結合された許可リストに共通のドメインがない場合、そのエージェントではツールは利用可能なままですが、すべての呼び出しは、許可されたドメインがないことを示すurl_not_allowedエラーで失敗し、ツールの説明もモデルにその旨を伝えます。これを避けるために、各ロスターエージェントの許可リストをコーディネーターの許可リストの範囲内に収めてください。
• max_content_tokensとuser_locationは結合されません。スレッドは、設定されていれば自身のツール設定の値を使用し、そうでなければそれを呼び出したエージェントの値、それもなければコーディネーターの現在の設定の値を使用します。
• {"type": "self"}ロスターエントリは独自のウェブ設定を持たず、コーディネーターの現在の設定に従います。
• アウトカム駆動セッションのグレーダーは、これらの設定に関係なく、web_searchとweb_fetchなしで実行されます。
• アイドル状態のセッションでは、ツールを更新することでリストを変更できます。新しいリストはセッションの残りの部分に適用されます。マルチエージェントセッションでは、すべてのスレッドが次のターンからそれらを適用しますが、ロスターエージェント自身のリストは、セッション作成時にそのエージェント定義で設定されたままです。



Messages APIツールとの違い

これらの設定は、Messages APIサーバーツールのドメインフィルタリングと同じallowed_domainsおよびblocked_domainsの語彙を使用しますが、Managed Agentsでは以下の違いがあります。

• 各リストは64ドメインに制限されています。
• web_fetch用にリストされたドメインにはパスを含めることができません。
• max_uses、citations、cache_controlはツールセットでは利用できません。



カスタムツール

組み込みツールに加えて、カスタムツールを定義できます。カスタムツールは、Messages APIのユーザー定義クライアントツールに相当します。

各カスタムツールは契約を定義します。利用可能な操作とそれらが返す内容を指定すると、Claudeがいつどのように呼び出すかを判断します。モデルは自身で何も実行しません。構造化されたリクエストを発行し、あなたのコードが操作を実行し、結果が会話に戻されます。セッション中にカスタムツール呼び出しを受信して結果を返す方法については、セッションイベントストリームを参照してください。

セッションがセルフホストサンドボックスで実行される場合、環境ワーカーはサンドボックスからカスタムツールを提供できます。これには、ネットワーク内のMCPサーバーをラップするツールも含まれます。

ant beta:agents create < agent.yaml

name: Weather Agent
model: claude-opus-5
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

エージェントにカスタムツールを定義すると、エージェントはセッション中にそれらを呼び出します。



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

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



次のステップ