このページでは、Claude Managed Agentsのリファレンス資料をまとめています。タスク指向のガイドについては、各セクションのリンクを参照してください。セッションリソースに対する操作については、セッション操作を参照してください。
すべてのManaged Agents APIリクエストには、managed-agents-2026-04-01ベータヘッダーが必要です。SDKはベータヘッダーを自動的に設定します。
永続化されるイベントタイプの文字列は {domain}.{action} という命名規則に従います。ストリーム専用のイベントデルタ(「イベントデルタ」タブを参照)は例外です。イベントの送信、ストリーミング、一覧表示については、セッションイベントストリームを参照してください。
| タイプ | 説明 |
|---|---|
user.message | テキストコンテンツを含むユーザーメッセージ。 |
user.interrupt | 実行中のエージェントを停止します。 |
user.custom_tool_result | エージェントからのカスタムツール呼び出しに対する応答。 |
user.tool_confirmation | 権限ポリシーが確認を要求する場合に、エージェントまたはMCPツールの呼び出しを承認または拒否します。 |
user.define_outcome | エージェントが達成を目指すアウトカムを定義します。 |
user.tool_result | self_hosted 環境を使用するセッションのみ対象。統合側が agent_toolset の結果を提供する責任を負います。SDKヘルパーとCLIはこれを自動的に行います。 |
以下は、self_hosted 環境を駆動する事前構築済みワーカー用の ant beta:worker CLIフラグです。環境のセットアップ、ワーカーの実行、SDKヘルパーオプションについては、セルフホストサンドボックスを参照してください。
| フラグ | 説明 |
|---|---|
--environment-id | 作業をポーリングする環境。ANTHROPIC_ENVIRONMENT_ID からも読み取ります。 |
--environment-key | この環境でワーカーを認証します。ANTHROPIC_ENVIRONMENT_KEY からも読み取ります。 |
--workdir | スキルがダウンロードされ、ツールがファイルを読み書きするディレクトリ。デフォルトは .(カレントディレクトリ)です。システムのデフォルト作業ディレクトリは /workspace です。 |
--on-work | ツールをプロセス内で実行する代わりに、取得した各作業項目に対して呼び出すスクリプト。セッションの詳細を環境変数として受け取ります。 |
--unrestricted-paths | ツール呼び出しが --workdir 外のパスにアクセスすることを許可します。 |
--max-idle | セッションが end_turn 停止理由でアイドル状態になった後、シャットダウンするまでの待機時間。デフォルトは 60s です。 |
--log-format | ログ出力形式。構造化ログの取り込みには json を使用します。デフォルトは text です。 |
Claude Managed Agentsは、HTTPエンドポイントを公開するリモートMCPサーバー、またはMCPトンネルを介したプライベートMCPサーバーに接続します。サーバーはMCPプロトコルのストリーム可能なHTTPトランスポートをサポートしている必要があります。エージェントでのサーバー宣言については、MCPコネクタを参照してください。
MCPおよびMCPサーバーの構築の詳細については、MCPドキュメントを参照してください。
Managed Agentsのエンドポイントは組織ごとにレート制限されます。
| 操作 | 制限 |
|---|---|
| 作成エンドポイント(エージェント、セッション、環境など) | 1分あたり300リクエスト |
| 読み取りエンドポイント(取得、一覧表示、ストリームなど) | 1分あたり1,200リクエスト |
組織レベルの支出制限および使用ティアのレート制限も適用されます。
Claude Managed Agentsを統合するパートナーにとって、Claudeブランディングの使用は任意です。製品内でClaudeに言及する場合:
許可されるもの:
許可されないもの:
製品は独自のブランディングを維持し、Claude Code、Claude Cowork、またはその他のAnthropic製品であるかのように見えてはなりません。ブランディングコンプライアンスに関するご質問は、Anthropicの営業チームにお問い合わせください。
Was this page helpful?