このページでは、Claude Managed Agentsのリファレンス資料をまとめています。タスク指向のガイドについては、各セクションのリンクをたどってください。セッションリソースに対する操作については、セッション操作を参照してください。
Managed Agents APIリクエストにはmanaged-agents-2026-04-01ベータヘッダーが必要です。ただし、メモリストアエンドポイントは例外で、代わりにagent-memory-2026-07-22を使用します。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 の外部のパスを読み書きできるようにします。workdirチェックはファイルツールのみのガードレールであり、サンドボックスではありません。bashを制約するものではありません。 |
--max-idle | セッションが end_turn の停止理由でアイドル状態になった後、シャットダウンするまでの待機時間。デフォルトは 60s です。 |
--log-format | ログ出力形式。構造化ログの取り込みには json を使用します。デフォルトは text です。 |
Claude Managed Agentsは、HTTPエンドポイントを公開するリモートMCPサーバー、またはMCPトンネルを介したプライベートMCPサーバーに接続します。サーバーはMCPプロトコルのstreamable HTTPトランスポートをサポートしている必要があります。非推奨のSSEトランスポートのみをサポートするサーバーも、自動フォールバックによって引き続き動作します。エージェントでのサーバーの宣言については、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?