リファレンス
Claude Managed Agentsのイベントタイプ、セルフホストワーカーのCLIフラグ、サポートされるMCPサーバータイプ、レート制限、およびブランディングガイドライン。
このページでは、Claude Managed Agentsのリファレンス資料をまとめています。タスク指向のガイドについては、各セクションのリンクを参照してください。セッションリソースに対する操作については、セッション操作を参照してください。
イベントタイプ
永続化されるイベントタイプの文字列は{domain}.{action}という命名規則に従います。ストリーム専用のイベントデルタ(「イベントデルタ」タブを参照)は例外です。イベントの送信、ストリーミング、一覧表示については、セッションイベントストリームを参照してください。WebhookのイベントタイプはWebhookのサブスクライブに別途記載されており、一部の名前はストリームのものと異なります(たとえば、session.status_idleではなくsession.status_idled)。
| タイプ | 説明 |
|---|---|
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です。 |
CLIワーカーはメモリストアをマウントしません。メモリストアをアタッチしたセッションも実行はされますが、エージェントはストアのmount_pathに何も見つけられず、変更はストアに同期されません。セルフホスト環境上のセッションでメモリストアを使用するには、代わりにSDKワーカーを実行してください。メモリストアの使用を参照してください。
サポートされるMCPサーバータイプ
Claude Managed Agentsは、HTTPエンドポイントを公開するリモートMCPサーバー、またはMCPトンネルを介したプライベートMCPサーバーに接続します。サーバーはMCPプロトコルのストリーマブルHTTPトランスポートをサポートしている必要があります。非推奨のSSEトランスポートのみをサポートするサーバーも、自動フォールバックによって引き続き動作します。エージェントでのサーバーの宣言については、MCPコネクターを参照してください。
MCPおよびMCPサーバーの構築に関する詳細については、MCPドキュメントを参照してください。
レート制限
Managed Agentsのエンドポイントには、組織ごとに「rate limit」(レート制限)が適用されます。
| 操作 | 制限 |
|---|---|
| 作成エンドポイント(エージェント、セッション、環境など) | 1分あたり300リクエスト |
| 読み取りエンドポイント(取得、一覧、ストリームなど) | 1分あたり1,200リクエスト |
組織レベルの支出制限および使用量ティアのレート制限も適用されます。
ブランディングガイドライン
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の営業チームまでお問い合わせください。
Was this page helpful?