--- title: リファレンス url: https://platform.claude.com/docs/ja/managed-agents/reference description: Claude Managed Agentsのイベントタイプ、セルフホストワーカーのCLIフラグ、サポートされているMCPサーバーの種類、レート制限、およびブランディングガイドライン。 featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- このページでは、Claude Managed Agentsのリファレンス資料をまとめています。タスク指向のガイドについては、各セクションのリンクを参照してください。セッションリソースに対する操作については、[セッション操作](https://platform.claude.com/docs/ja/managed-agents/session-operations)を参照してください。 ## イベントタイプ 永続化されるイベントタイプの文字列は`{domain}.{action}`という命名規則に従います。ストリーム専用のイベントデルタ（「イベントデルタ」タブを参照）は例外です。イベントの送信、ストリーミング、一覧表示については、[セッションイベントストリーム](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming)を参照してください。Webhookのイベントタイプは[Webhookのサブスクライブ](https://platform.claude.com/docs/ja/managed-agents/webhooks#supported-event-types)に別途記載されており、一部の名前はストリームのものと異なります（たとえば、`session.status_idle`ではなく`session.status_idled`）。 | タイプ | 説明 | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `user.message` | テキスト、画像、またはドキュメントコンテンツを含むユーザーメッセージ。 | | `user.interrupt` | 実行中のエージェントを停止します。[ワークフロー実行](https://platform.claude.com/docs/ja/managed-agents/workflow-runs#interrupt-a-session-with-runs-open)は終了しません。 | | `user.custom_tool_result` | エージェントからのカスタムツール呼び出しへの応答。 | | `user.tool_confirmation` | 権限ポリシーで確認が必要な場合に、エージェントまたはMCPのツール呼び出しを承認または拒否します。 | | `user.define_outcome` | エージェントが目指すべき[アウトカム](https://platform.claude.com/docs/ja/managed-agents/define-outcomes)を定義します。 | | `user.tool_result` | `self_hosted`[環境](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes)を使用するセッション専用です。`agent_toolset`の結果を提供するのはお客様のインテグレーションの責任です。SDKヘルパーとCLIはこれを自動的に行います。 | | タイプ | 説明 | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `agent.message` | エージェントのレスポンスのコンテンツブロック。 | | `agent.thinking` | エージェントが「extended thinking」（拡張思考）を通じて処理を進めていることを示します。これは進捗シグナルのみであり、思考の内容は含まれません。 | | `agent.tool_use` | エージェントが事前構築済みのエージェントツール（bash、ファイル操作など）を呼び出します。`evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`)と、通常は`evaluation` (csharp, go: `Evaluation`)を含みます（[各呼び出しがどのように評価されたかを確認する](https://platform.claude.com/docs/ja/managed-agents/permission-policies#see-how-each-call-was-evaluated)を参照）。 | | `agent.tool_result` | 事前構築済みのエージェントツールの実行結果。 | | `agent.mcp_tool_use` | エージェントがMCPサーバーのツールを呼び出します。`evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`)と、通常は`evaluation` (csharp, go: `Evaluation`)を含みます（[各呼び出しがどのように評価されたかを確認する](https://platform.claude.com/docs/ja/managed-agents/permission-policies#see-how-each-call-was-evaluated)を参照）。 | | `agent.mcp_tool_result` | MCPツールの実行結果。 | | `agent.custom_tool_use` | エージェントがカスタムツールのいずれかを呼び出します。`user.custom_tool_result`イベントで応答してください。 | | `agent.thread_context_compacted` | 「context window」（コンテキストウィンドウ）に収まるように会話履歴が圧縮されました。 | | `agent.thread_message_received` | [マルチエージェント](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration)セッションにおいて、このイベントを含むストリームのスレッドに別のスレッドからのメッセージが届きました。プライマリスレッドでは、エージェントがセッションが実行するエージェントにレポートまたは質問を送信しました。 | | `agent.thread_message_sent` | [マルチエージェント](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration)セッションにおいて、このイベントを含むストリームのスレッドが別のスレッドにメッセージを送信しました。プライマリスレッドでは、セッションが実行するエージェントが別のエージェントにタスクまたはフォローアップメッセージを送信しました。 | これらのイベントのメッセージコンテンツには、`redacted`コンテンツブロック`{"type": "redacted"}`が含まれる場合があります。これはAnthropicのモデルポリシーによって非公開とされたコンテンツのプレースホルダーです。このブロックには他のフィールドはありません。redactedブロックはプラットフォームが出力するコンテンツにのみ現れます。これを含むユーザーイベントは400エラーで拒否されます。 | タイプ | 説明 | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `session.status_running` | エージェントがアクティブに処理中です。 | | `session.status_idle` | エージェントが現在のタスクを完了し、入力を待っています。エージェントが停止した理由を示す`stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`)を含みます。 | | `session.status_rescheduled` | 一時的なエラーが発生し、セッションが自動的に再試行しています。 | | `session.status_terminated` | 回復不能なエラーが発生したか、アーカイブされたため、セッションが終了しました。 | | `session.deleted` | セッションが削除されました。アクティブなイベントストリームを終了し、このセッションについてそれ以降のイベントは出力されません。 | | `session.updated` | セッション更新リクエストによって少なくとも1つのフィールドが変更されました。変更されたフィールドのみを含みます。更新は次のターンで適用されます。 | | `session.error` | 処理中にエラーが発生しました。`retry_status` (java, php: `retryStatus`; csharp, go: `RetryStatus`)を持つ型付きの`error` (csharp, go: `Error`)オブジェクトを含みます。 | | `session.usage` | セッションの累積使用量と追跡された定価ベースのコストのスナップショット。セッションの使用量の合計と、セッションに[予算](https://platform.claude.com/docs/ja/managed-agents/budgets)がある場合はその予算を含みます。 | | `session.thread_created` | [マルチエージェント](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration)のスレッドが作成されました。`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)を含みます。これは[ワークフロー実行](https://platform.claude.com/docs/ja/managed-agents/workflow-runs#a-runs-threads)のスレッドの場合はその実行のIDであり、それ以外のスレッドの場合は`null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`)です。 | | `session.thread_status_running` | セッションスレッドが実行を開始しました。すべてのセッションはプライマリスレッドについてこれを出力します。[マルチエージェント](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration)セッションでは、子スレッドの遷移もプライマリストリームにクロスポストされます。 | | `session.thread_status_idle` | セッションスレッドがターンを終了し、入力を待っています。`stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`)を含みます。 | | `session.thread_status_rescheduled` | セッションスレッドで一時的なエラーが発生し、自動的に再試行しています。 | | `session.thread_status_terminated` | セッションスレッドが終了し、それ以降の入力を受け付けません。たとえば、アーカイブされた場合や回復不能なエラーが発生した場合です。アドバイザースレッドも、その相談が終了すると終了します。ワークフロー実行のスレッドはサーバー自身がアーカイブします。 | エージェントで[動的ワークフロー](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration#dynamic-workflows)が有効になっているセッションでは、以下の`workflow_run.*`イベントがセッションのストリームに届きます。 | タイプ | 説明 | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workflow_run.created` | ワークフロー実行が作成されました。`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)、実行の`name` (csharp, go: `Name`)と`description` (csharp, go: `Description`)、および実行に対して宣言されたフェーズである`phases` (csharp, go: `Phases`)を含みます。続いてステータスイベントが送信されますが、中断の後は送信されない場合があります。 | | `workflow_run.status_running` | ワークフロー実行が実行中です。実行が開始されたとき（`workflow_run.created`からしばらく後になる場合があります）と、予算による一時停止から再開したときに送信されます。中断後の再開では送信されない場合があります。開始時からアイドル状態の実行では、先に`workflow_run.status_idle`を受け取る場合があります。`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)を含みます。 | | `workflow_run.status_idle` | ワークフロー実行がアイドル状態になりました。たとえばセッションの予算に達して一時停止した場合です。中断後の一時停止では送信されない場合があります。`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)を含みます。 | | `workflow_run.status_ended` | ワークフロー実行が終了しました。`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)と`result` (csharp, go: `Result`)を含み、その`type` (csharp, go: `Type`)が実行の終了のしかたを示します。 | | `workflow_run.error` | ワークフロー実行のエラー、またはサーバーが拒否した開始。エラーで終了する実行は、`workflow_run.status_ended`の前に同じエラーでこれを受け取ります。`error` (csharp, go: `Error`)と`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)を含み、後者は実行が作成されなかった場合は`null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`)です。 | | `workflow_run.phase_started` | ワークフロー実行がいずれかのフェーズに入りました。`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)と`workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`)を含みます。 | | `workflow_run.phase_ended` | ワークフロー実行がフェーズを離れました。`workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`)、`workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`)、および`phase_started_id` (java: `phaseStartedId`; php: `phaseStartedID`; csharp, go: `PhaseStartedID`)を含みます。 | スパンイベントは、タイミングと使用量の追跡のためにアクティビティをラップするオブザーバビリティマーカーです。 | タイプ | 説明 | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `span.model_request_start` | モデル推論呼び出しが開始されました。 | | `span.model_request_end` | モデル推論呼び出しが完了しました。トークン数を含む`model_usage` (java, php: `modelUsage`; csharp, go: `ModelUsage`)を含みます。 | | `span.outcome_evaluation_start` | [アウトカム](https://platform.claude.com/docs/ja/managed-agents/define-outcomes)の評価が開始されました。 | | `span.outcome_evaluation_ongoing` | 進行中の[アウトカム](https://platform.claude.com/docs/ja/managed-agents/define-outcomes)評価中のハートビート。 | | `span.outcome_evaluation_end` | [アウトカム](https://platform.claude.com/docs/ja/managed-agents/define-outcomes)の評価サイクルが完了しました。`needs_revision`の結果は別のサイクルが続くことを意味します。`satisfied`、`max_iterations_reached`、`failed`、`interrupted`は終端状態です。 | | タイプ | 説明 | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `system.message` | 付随するターンおよび以降のすべてのターンに適用される、特権的なシステムレベルのコンテキストを追加します。これを受け付けるモデルについては、[サポートされているモデル](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#supported-models)を参照してください。サポートされていないプライマリモデルでは、このイベントは`model_does_not_support_mid_conversation_system`で拒否されます。 | イベントデルタは、ストリーム専用のプレビューイベントです。`event_deltas` (curl: `event_deltas[]`; cli: `--event-delta`; java, php: `eventDeltas`; csharp, go: `EventDeltas`)パラメータでオプトインしたストリーム接続（セッションレベルまたはスレッドごと）で出力され、セッションのイベント履歴に永続化されることはありません。オプトイン、蓄積、および照合の方法については、[イベントデルタでレスポンスをプレビューする](https://platform.claude.com/docs/ja/managed-agents/event-deltas)を参照してください。 | タイプ | 説明 | | ------------- | ----------------------------------------------------------------------------------------------------------------------- | | `event_start` | プレビュー対象のイベントの生成が開始されました。これから届くイベントの`type` (csharp, go: `Type`)と`id` (csharp, go: `ID`)を含みます。ストリーム専用で、永続化されることはありません。 | | `event_delta` | `event_id` (java: `eventId`; php: `eventID`; csharp, go: `EventID`)で識別される、プレビュー対象のイベントの増分コンテンツ。ストリーム専用で、永続化されることはありません。 | ## セルフホストワーカー `self_hosted`環境を駆動する事前構築済みワーカーの`ant beta:worker` CLIフラグ、環境変数、ファイルシステムパス、およびSDKヘルパーオプションについては、[セルフホストワーカーリファレンス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-reference)を参照してください。 ## サポートされるMCPサーバータイプ Claude Managed Agentsは、HTTPエンドポイントを公開する[リモートMCPサーバー](https://platform.claude.com/docs/ja/agents-and-tools/remote-mcp-servers)、または[MCPトンネル](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/overview)を介したプライベートMCPサーバーに接続します。サーバーはMCPプロトコルのストリーマブルHTTPトランスポートをサポートしている必要があります。非推奨のSSEトランスポートのみをサポートするサーバーも、自動フォールバックによって引き続き動作します。エージェントでのサーバーの宣言については、[MCPコネクター](https://platform.claude.com/docs/ja/managed-agents/mcp-connector)を参照してください。 MCPおよびMCPサーバーの構築に関する詳細については、[MCPドキュメント](https://modelcontextprotocol.io)を参照してください。 ## レート制限 Managed Agentsのエンドポイントには、組織ごとに「rate limit」（レート制限）が適用されます。 | 操作 | 制限 | | ---------------------------- | --------------- | | 作成エンドポイント（エージェント、セッション、環境など） | 1分あたり300リクエスト | | 読み取りエンドポイント（取得、一覧、ストリームなど） | 1分あたり1,200リクエスト | 組織レベルの[支出制限および使用量ティアのレート制限](https://platform.claude.com/docs/ja/api/rate-limits)も適用されます。 ## ブランディングガイドライン Claude Managed Agentsを統合するパートナーにとって、Claudeブランディングの使用は任意です。製品内でClaudeに言及する場合： **許可されるもの：** * 「Claude Agent」（ドロップダウンメニューに推奨） * 「Claude」（すでに「Agents」とラベル付けされたメニュー内の場合） * 「\{YourAgentName} Powered by Claude」（既存のエージェント名がある場合） **許可されないもの：** * 「Claude Code」または「Claude Code Agent」 * 「Claude Cowork」または「Claude Cowork Agent」 * Claude CodeブランドのASCIIアートやClaude Codeを模倣した視覚要素 製品は独自のブランディングを維持し、Claude Code、Claude Cowork、またはその他のAnthropic製品であるかのように見えてはなりません。ブランディングのコンプライアンスに関するご質問は、Anthropicの[営業チーム](https://www.anthropic.com/contact-sales)までお問い合わせください。