このガイドでは、エージェントの作成、環境のセットアップ、セッションの開始、エージェントの応答のストリーミングについて順を追って説明します。
インタラクティブなウォークスルーをご希望ですか? 最新バージョンのClaude Codeで/claude-api managed-agents-onboardを実行すると、ガイド付きセットアップとインタラクティブな質問応答が利用できます。
| 概念 | 説明 |
|---|---|
| エージェント | モデル、システムプロンプト、ツール、MCPサーバー、およびスキル |
| 環境 | セッションが実行される場所の設定:Anthropicが管理するクラウドサンドボックス、または独自のインフラストラクチャ上のセルフホスト型サンドボックス |
| セッション | 環境内で実行中のエージェントインスタンスで、特定のタスクを実行し出力を生成するもの |
| イベント | アプリケーションとエージェントの間で交換されるメッセージ(ユーザーターン、ツール結果、ステータス更新) |
brew install anthropics/tap/antインストールを確認します:
ant --versionpip install anthropicAPIキーを環境変数として設定します:
export ANTHROPIC_API_KEY="your-api-key-here"Managed Agents APIリクエストにはmanaged-agents-2026-04-01ベータヘッダーが必要です。ただし、メモリストアエンドポイントは例外で、代わりにagent-memory-2026-07-22を使用します。SDKは正しいベータヘッダーを自動的に設定します。ベータヘッダーを参照してください。
エージェントを作成する
モデル、システムプロンプト、利用可能なツールを定義するエージェントを作成します。
AGENT_ID=$(ant beta:agents create \
--name "Coding Assistant" \
--model '{id: claude-opus-5}' \
--system "You are a helpful coding assistant. Write clean, well-documented code." \
--tool '{type: agent_toolset_20260401}' \
--transform id --raw-output)
echo "Agent ID: $AGENT_ID"agent_toolset_20260401ツールタイプは、事前構築されたエージェントツールの完全なセット(bash、ファイル操作、ウェブ検索など)を有効にします。完全なリストとツールごとの設定オプションについては、ツールを参照してください。
返されたagent.idを保存してください。作成するすべてのセッションで参照します。
環境を作成する
環境は、エージェントが実行されるサンドボックスを定義します。
ENVIRONMENT_ID=$(ant beta:environments create \
--name "quickstart-env" \
--config '{type: cloud, networking: {type: unrestricted}}' \
--transform id --raw-output)
echo "Environment ID: $ENVIRONMENT_ID"返された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は次の処理を行います:
session.status_idleイベントを発行します。再利用可能でバージョン管理されたエージェント設定を作成する
ネットワークとサンドボックスの設定をカスタマイズする
エージェントに特定のツールを有効にする
イベントを処理し、実行中のエージェントを誘導する
定期的なcronスケジュールでエージェントを実行する
Was this page helpful?