Managed Agentsはじめに

Claude Managed Agentsを始める

最初の自律エージェントを作成します。

このガイドでは、エージェントの作成、環境のセットアップ、セッションの開始、エージェントの応答のストリーミングについて順を追って説明します。

インタラクティブなウォークスルーをご希望ですか？ 最新バージョンのClaude Codeで /claude-api managed-agents-onboard を実行すると、ガイド付きセットアップとインタラクティブな質問応答が利用できます。

主要な概念

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

前提条件

AnthropicのConsoleアカウント
APIキー

CLIのインストール

インストールを確認します。

ant --version

SDKのインストール

APIキーを環境変数として設定します。

export ANTHROPIC_API_KEY="your-api-key-here"

最初のセッションを作成する

すべてのManaged Agents APIリクエストには、managed-agents-2026-04-01ベータヘッダーが必要です。SDKはベータヘッダーを自動的に設定します。

エージェントを作成する
モデル、システムプロンプト、利用可能なツールを定義するエージェントを作成します。
ant beta:agents create \ --name "Coding Assistant" \ --model '{id: claude-opus-4-8}' \ --system "You are a helpful coding assistant. Write clean, well-documented code." \ --tool '{type: agent_toolset_20260401}'
agent_toolset_20260401 ツールタイプは、事前構築されたエージェントツールの完全なセット（bash、ファイル操作、ウェブ検索など）を有効にします。完全なリストとツールごとの設定オプションについては、ツールを参照してください。
返された agent.id を保存してください。作成するすべてのセッションでこれを参照します。
環境を作成する
環境は、エージェントが実行されるサンドボックスを定義します。
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
返された environment.id を保存してください。作成するすべてのセッションでこれを参照します。
クラウドサンドボックスの代わりに独自のインフラストラクチャでサンドボックスを実行するには、セルフホスト型サンドボックスを参照してください。

セッションを開始する

エージェントと環境を参照するセッションを作成します。

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    title="Quickstart session",
)

print(f"Session ID: {session.id}")

メッセージを送信して応答をストリーミングする

ストリームを開き、ユーザーイベントを送信し、到着したイベントを処理します。

with client.beta.sessions.events.stream(session.id) as stream:
    # ストリームが開いた後にユーザーメッセージを送信
    client.beta.sessions.events.send(
        session.id,
        events=[
            {
                "type": "user.message",
                "content": [
                    {
                        "type": "text",
                        "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
                    },
                ],
            },
        ],
    )

    # ストリーミングイベントを処理
    for event in stream:
        match event.type:
            case "agent.message":
                for block in event.content:
                    print(block.text, end="")
            case "agent.tool_use":
                print(f"\n[Using tool: {event.name}]")
            case "session.status_idle":
                print("\n\nAgent finished.")
                break

エージェントはPythonスクリプトを作成し、サンドボックス内で実行し、出力ファイルが作成されたことを確認します。出力は次のようになります。

I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
[Using tool: write]
[Using tool: bash]
The script ran successfully. Let me verify the output file.
[Using tool: bash]
fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).

Agent finished.

何が起きているのか

ユーザーイベントを送信すると、Claude Managed Agentsは次の処理を行います。

サンドボックスをプロビジョニングする： 環境設定によって構築方法が決まります。
エージェントループを実行する： Claudeはメッセージに基づいて使用するツールを決定します。
ツールを実行する： ファイル書き込み、bashコマンド、その他のツール呼び出しがサンドボックス内で実行されます。
イベントをストリーミングする： エージェントの動作中にリアルタイムの更新を受け取ります。
アイドル状態になる： エージェントは、これ以上実行することがなくなると session.status_idle イベントを発行します。

次のステップ

エージェントを定義する

再利用可能でバージョン管理されたエージェント設定を作成する

環境を設定する

ネットワークとサンドボックスの設定をカスタマイズする

エージェントツール

エージェントに特定のツールを有効にする

セッションイベントストリーム

イベントを処理し、実行中にエージェントを誘導する

スケジュールされたデプロイメント

定期的なcronスケジュールでエージェントを実行する

Was this page helpful?

主要な概念

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

最初のセッションを作成する

すべてのManaged Agents APIリクエストには、managed-agents-2026-04-01ベータヘッダーが必要です。SDKはベータヘッダーを自動的に設定します。

エージェントを作成する
モデル、システムプロンプト、利用可能なツールを定義するエージェントを作成します。
ant beta:agents create \ --name "Coding Assistant" \ --model '{id: claude-opus-4-8}' \ --system "You are a helpful coding assistant. Write clean, well-documented code." \ --tool '{type: agent_toolset_20260401}'
agent_toolset_20260401 ツールタイプは、事前構築されたエージェントツールの完全なセット（bash、ファイル操作、ウェブ検索など）を有効にします。完全なリストとツールごとの設定オプションについては、ツールを参照してください。
返された agent.id を保存してください。作成するすべてのセッションでこれを参照します。
環境を作成する
環境は、エージェントが実行されるサンドボックスを定義します。
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
返された environment.id を保存してください。作成するすべてのセッションでこれを参照します。
クラウドサンドボックスの代わりに独自のインフラストラクチャでサンドボックスを実行するには、セルフホスト型サンドボックスを参照してください。

セッションを開始する

エージェントと環境を参照するセッションを作成します。

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    title="Quickstart session",
)

print(f"Session ID: {session.id}")

メッセージを送信して応答をストリーミングする

ストリームを開き、ユーザーイベントを送信し、到着したイベントを処理します。

with client.beta.sessions.events.stream(session.id) as stream:
    # ストリームが開いた後にユーザーメッセージを送信
    client.beta.sessions.events.send(
        session.id,
        events=[
            {
                "type": "user.message",
                "content": [
                    {
                        "type": "text",
                        "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
                    },
                ],
            },
        ],
    )

    # ストリーミングイベントを処理
    for event in stream:
        match event.type:
            case "agent.message":
                for block in event.content:
                    print(block.text, end="")
            case "agent.tool_use":
                print(f"\n[Using tool: {event.name}]")
            case "session.status_idle":
                print("\n\nAgent finished.")
                break

エージェントはPythonスクリプトを作成し、サンドボックス内で実行し、出力ファイルが作成されたことを確認します。出力は次のようになります。

I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
[Using tool: write]
[Using tool: bash]
The script ran successfully. Let me verify the output file.
[Using tool: bash]
fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).

Agent finished.

何が起きているのか

ユーザーイベントを送信すると、Claude Managed Agentsは次の処理を行います。

サンドボックスをプロビジョニングする： 環境設定によって構築方法が決まります。

エージェントループを実行する： Claudeはメッセージに基づいて使用するツールを決定します。

ツールを実行する： ファイル書き込み、bashコマンド、その他のツール呼び出しがサンドボックス内で実行されます。

イベントをストリーミングする： エージェントの動作中にリアルタイムの更新を受け取ります。

アイドル状態になる： エージェントは、これ以上実行することがなくなると session.status_idle イベントを発行します。

主要な概念

前提条件

CLIのインストール

SDKのインストール

最初のセッションを作成する

何が起きているのか

次のステップ

主要な概念

前提条件

CLIのインストール

SDKのインストール

最初のセッションを作成する

何が起きているのか

次のステップ

主要な概念

前提条件

CLIのインストール

SDKのインストール

最初のセッションを作成する

何が起きているのか

次のステップ

主要な概念

前提条件

CLIのインストール

SDKのインストール

最初のセッションを作成する

何が起きているのか

次のステップ