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 を通じて結果をストリーミングで返します。イベント履歴はサーバー側に永続化され、全体を取得できます。

  5. 誘導または中断する

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

Claude Managed Agents を使用すべき場面

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

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

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

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

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

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

ベータアクセス

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

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

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

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

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

Was this page helpful?