Claude Platform Docs
Managed Agentsはじめに

Claude Managed Agents の概要

マネージドインフラストラクチャ上で動作する、事前構築済みで設定可能なエージェントハーネスです。長時間実行されるタスクや非同期の作業に最適です。

Anthropicは、Claudeを使って構築するための2つの方法を提供しており、それぞれ異なるユースケースに適しています。

Messages APIClaude Managed Agents
概要モデルへの直接的なプロンプトアクセスマネージドインフラストラクチャ上で動作する、事前構築済みで設定可能なエージェントハーネス
最適な用途カスタムエージェントループときめ細かな制御長時間実行されるタスクと非同期作業

Claude Managed Agents は、Claude を自律型エージェントとして実行するためのハーネスとインフラストラクチャを提供します。独自のエージェントループ、ツール実行、ランタイムを構築する代わりに、Claude がファイルの読み取り、コマンドの実行、ウェブの閲覧、コードの安全な実行を行える完全マネージドな環境を利用できます。このハーネスは、組み込みの「prompt caching」(プロンプトキャッシング)、コンパクション、その他のパフォーマンス最適化をサポートしており、高品質で効率的なエージェント出力を実現します。代わりにモデルへ直接アクセスして独自のエージェントループを構築する場合は、Messages API の使用を参照してください。

最初のエージェントセッションを作成する

セッションを作成して最初のイベントを送信する

イベントタイプ、レート制限、CLI フラグ、その他の参照表

コアコンセプト

Claude Managed Agents は4つのコンセプトを中心に構築されています。

概念説明
Agent(エージェント)モデル、システムプロンプト、ツール、MCPサーバー、およびスキル
Environment(環境)セッションが実行される場所の設定:Anthropicが管理するクラウドサンドボックス、または独自のインフラストラクチャ上のセルフホスト型サンドボックス
Session(セッション)環境内で実行中のエージェントインスタンス。特定のタスクを実行し、出力を生成します
Events(イベント)アプリケーションとエージェントの間でやり取りされるメッセージ(ユーザーターン、ツール結果、ステータス更新)

仕組み

  1. エージェントを作成する

    モデル、システムプロンプト、ツール、MCP サーバー、スキルを定義します。エージェントを一度作成すれば、セッションをまたいで ID で参照できます。

  2. 環境を作成する

    エージェントの実行場所を設定します。クラウドサンドボックス、または独自のインフラストラクチャ上のセルフホスト型サンドボックスを選択できます。

  3. セッションを開始する

    エージェントと環境の設定を参照するセッションを起動します。

  4. イベントを送信してレスポンスをストリーミングする

    ユーザーメッセージをイベントとして送信します。Claude は自律的にツールを実行し、「server-sent events」(サーバー送信イベント)、すなわち SSE を通じて結果をストリーミングで返します。Managed Agents サービスがイベント履歴を保持しており、その全体を取得できます。

  5. 誘導または中断する

    エージェントの実行中に追加のユーザーイベントを送信して誘導したり、中断して方向を変えたりできます。

Claude Managed Agents を使用すべき場面

Claude Managed Agents は、次のような要件を持つワークロードに最適です。

  • 長時間実行: 複数のツール呼び出しを伴い、数分から数時間にわたって実行されるタスク
  • クラウドインフラストラクチャ: パッケージが事前インストールされ、ネットワークアクセスを備えた安全なサンドボックス
  • セルフホスト型実行: コンプライアンスやデータレジデンシー要件のために、自身が管理するインフラストラクチャ上で動作するサンドボックス
  • セルフホスト型サービス: セルフホスト型 Claude Managed Agents により、Managed Agents サービス全体を独自のインフラストラクチャ上で実行
  • 最小限のインフラストラクチャ: 独自のエージェントループ、サンドボックス、ツール実行レイヤーを構築する必要がない
  • ステートフルなセッション: 複数のインタラクションにわたって永続化されるファイルシステムと会話履歴
  • スケジュール実行: スケジュールされたデプロイメントによる cron スケジュールでの定期的なエージェント実行

サポートされているツール

Claude Managed Agents は、Claude に一連の組み込みツールへのアクセスを提供します。

  • Bash: サンドボックス内でシェルコマンドを実行する
  • ファイル操作: サンドボックス内のファイルの読み取り、書き込み、編集、glob、grep を行う
  • ウェブ検索とフェッチ: ウェブを検索し、URL からコンテンツを取得する。オプションでドメインの許可リストまたはブロックリストに制限可能
  • MCP サーバー: 外部のツールプロバイダーに接続する

完全なリストと設定オプションについては、ツールを参照してください。

ベータアクセス

開始するには、以下が必要です。

  1. Claude Consoleから取得したClaude APIキー。
  2. すべてのリクエストに managed-agents-2026-04-01 ベータヘッダー。
  3. Claude Managed Agents へのアクセス(すべての API アカウントでデフォルトで有効)。

ベータ版の中でも、MCP トンネルとドリーミングは、より限定的なリサーチプレビューの段階にあります。これらを有効にするには、リサーチプレビューへのアクセスをリクエストしてください。

Claude Managed Agents は設計上ステートフルです。セッションは長時間実行され、一時停止後もスムーズに再開でき、会話履歴、サンドボックスの状態、出力をサーバー側に保存します。このため、Managed Agents は現在、ゼロデータ保持および HIPAA 事業提携者契約(BAA)の対象外です。ゼロデータ保持の例外はセルフホスト型 Claude Managed Agents で、データの保持期間で説明されているとおり、この場合はこれらのデータをお客様自身が保存します。このデータの管理権限はお客様が保持します。API を通じていつでもセッションを削除でき、またアップロードしたファイルを個別に削除することもできます。すべての機能における適格性については、API とデータ保持を参照してください。

リファレンスのレート制限およびブランディングガイドラインを参照してください。

利用可能状況

Managed Agents
Managed Agentsの利用要件は、サポートされているすべてのプラットフォームで同じです。
ステータス
ベータ
ベータヘッダー
が必要
モデル
  • すべてのモデル

データの取り扱い

データの取り扱いの概要

対象エンドポイント

  • /v1/agents
  • /v1/sessions
  • /v1/environments
ゼロデータ保持対象外

セルフホスト型Managed Agentsを除き、ZDRの適格対象ではありません。セッションはステートフルなリソースであり、トランスクリプトは削除するまで保持されます。 詳細はこちら

HIPAA対象外

HIPAAの適格対象ではありません。すべてのManaged Agentsのサブ機能に適用されます。

このページは役に立ちましたか?