セルフホスト型Claude Managed Agents
Claude Managed Agentsサービスとそのサンドボックスを独自のインフラストラクチャ上でホストします。各部分を誰がホストするか、このオプションを選択すべき場面、そしてどこから始めればよいかを説明します。
セルフホスト型Claude Managed Agentsは、独自のインフラストラクチャ上で実行するManaged Agentsです。このインフラストラクチャは、クラウドアカウントでも、オンプレミスのデータセンターでもかまいません。サービスとサンドボックスは、お客様がホストします。モデルは、Anthropicまたはお客様が選択したプロバイダーで実行されます。
Managed Agentsには、お客様がホストできる部分が2つあります。
- サンドボックス: コンテナ、VM、またはその他の分離されたワークスペースで、エージェントのツールがコマンドを実行し、ファイルを操作する場所です。セルフホスト型サンドボックスを参照してください。
- サービス: API、エージェントループ、そしてエージェント、セッション、セッション履歴のストレージです。
セルフホスト型サンドボックスでは、1つ目の部分がお客様側に移ります。セルフホスト型Managed Agentsはこれを拡張したもので、お客様がサービスもホストします。各オプションの名前は、お客様がホストするものを示しています。
| オプション | サンドボックス | サービス | モデル |
|---|---|---|---|
| クラウドサンドボックス(デフォルト) | Anthropic | Anthropic | Anthropic |
| セルフホスト型サンドボックス | お客様 | Anthropic | Anthropic |
| セルフホスト型Managed Agents | お客様 | お客様 | Anthropic、またはお客様が選択したプロバイダー |
これらのページでは、ホスト型サービスとはAnthropicが運用するサービスを指し、サーバーとは独自のデータベースを備え、お客様が運用するサービスを指します。どちらも同じAPIを備えているため、SDKとant CLIを使ってサーバーを呼び出すことができ、Managed Agentsのその他のドキュメントもそのまま適用されます。例外についてはホスト型サービスとの違いに記載されています。
Claude Managed Agentsは、Claudeを自律型エージェントとして実行します。エージェントを定義し、セッションを開始し、エージェントが作業している間にエージェントとイベントをやり取りします。コアコンセプトでは、エージェント、環境、セッション、イベントについて説明しています。先にホスト型サービスを使用する必要はありません。
セルフホスト型Managed Agentsを選択する場面
次のいずれかが必要な場合は、セルフホスト型Managed Agentsを選択してください。
- 独自のインフラストラクチャ上のストレージ: エージェント、セッション、セッション履歴を自社で保存する必要がある場合。
- 推論プロバイダーの選択: モデル呼び出しをAmazon Bedrock、Claude Models on Google Cloud (Google managed)、Microsoft Foundry、または独自のモデルゲートウェイに送る必要がある場合。推論プロバイダーを参照してください。
ツールを独自のインフラストラクチャ上で実行するだけでよい場合は、Anthropicがサービスを運用するセルフホスト型サンドボックスを使用してください。エージェント環境の選択を参照してください。
セルフホスト型Managed Agentsでは、サーバー、そのデータベース、サンドボックスをお客様が運用して保護し、各リリースはお客様自身でインストールします。一部の機能はホスト型サービスにしかないため、決定する前にホスト型サービスとの違いを確認してください。
どこで何が実行されるか
1つ以上のサーバー、そのデータベース、サンドボックスで1つのデプロイメントを構成します。
- サーバー(
cma-server): APIを提供し、エージェントループを実行し、エージェント、セッション、各セッションの履歴を保存します。エージェントがモデルを必要とするたびに推論プロバイダーを呼び出します。サーバーがエージェントのシェルツールやファイルツールを実行することはありません。 - データベース: PostgreSQL 16以降。データベースがない場合、サーバーはデータをメモリに保持し、再起動するとデータは消去されます。
- ワーカー: サーバーから作業を取得し、お客様のサンドボックスでエージェントのシェルツールとファイルツールを実行するプログラムです。ワーカーは
ant beta:workerコマンドまたはSDKワーカーです。 - お客様のアプリケーション: SDKまたは
antCLIを使ってサーバーにアクセスする、お客様独自のコードやスクリプトです。 - サーバー上のコンソール: サーバーのアドレスにあるWebページです。ユーザーはお客様のIDプロバイダーを通じてサインインし、エージェントを作成してセッションを実行します。サーバー上のコンソールを使用するを参照してください。
- 管理CLI(
cma-server-admin): 環境とその環境キーを作成します。Linux(x86-64およびArm)とApple silicon搭載のmacOSで動作します。
お客様のセキュリティ上の責任
セルフホスト型サンドボックスのセキュリティモデルはここに適用されますが、2つの違いがあります。そのページでAnthropicが担うとされている事項は、サーバーの保護、メモリストアのホスト、異常な使用の検出を含め、お客様の責任となります。また、そのページでは信頼境界ごとに個別のワークスペースと環境を用意することを提案しています。ここでは、マルチテナンシーで説明しているとおり、信頼レベルごとに個別のデプロイメントが必要です。
3つの認証情報
| 認証情報 | 保持する主体 | 認証する対象 |
|---|---|---|
| サーバーAPIキー | お客様のアプリケーション、ant CLI、管理CLI | サーバーへのリクエスト。このキーはセットアップ時に生成されます。ホスト型サービスにおけるClaude APIキーと同じ役割を果たします。 |
| 推論の認証情報 | サーバー | サーバーから推論プロバイダーへのモデル呼び出し。たとえば、Claude APIキー、クラウドプロバイダーの認証情報、またはモデルゲートウェイが受け付けるトークンを使用できます。アプリケーションやワーカーにこれは必要ありません。 |
| 環境キー | サーバーをポーリングするお客様のワーカー | 1つの環境の作業キューと、その環境のセッション。 |
ネットワークの外に出るもの
モデル呼び出しのたびに、サーバーはツールの入力とツールの結果を含むそれまでの会話を推論プロバイダーに送信します。デフォルトでは、これはClaude APIです。Claude APIへの呼び出しには、そのセッションのIDと、そのセッションのエージェントおよび環境のIDも含まれます。セルフホスト型Claude Managed Agentsにおけるデータとアクセスには、サーバーが行うすべての接続が記載されています。また、ログの送信先と、誰がサーバーにアクセスできるかについても説明しています。
どこから始めるか
ダウンロードへのアクセスをリクエストするには、Anthropicのアカウントチームにお問い合わせください。次にセルフホスト型Claude Managed Agentsを始めるに従って、サーバーを起動し、最初のセッションを実行します。
各リリースのアーカイブには、そのバージョンのオペレーターガイドoperator-guide.mdが含まれています。このファイルをClaudeに読ませると、Claudeがサーバーの設定や実行、サーバーに接続するコードの作成を支援できるようになります。
このページは役に立ちましたか?