このガイドでは、エージェントの作成、環境のセットアップ、セッションの開始、エージェントの応答のストリーミングについて順を追って説明します。
| 概念 | 説明 |
|---|---|
| エージェント | モデル、システムプロンプト、ツール、MCPサーバー、およびスキル |
| 環境 | セッションが実行される場所の設定:Anthropicが管理するクラウドサンドボックス、または独自のインフラストラクチャ上のセルフホスト型サンドボックス |
| セッション | 環境内で実行中のエージェントインスタンスで、特定のタスクを実行し出力を生成するもの |
| イベント | アプリケーションとエージェントの間で交換されるメッセージ(ユーザーターン、ツール結果、ステータス更新) |
brew install anthropics/tap/antインストールを確認します。
ant --versionpip install anthropicAPIキーを環境変数として設定します。
export ANTHROPIC_API_KEY="your-api-key-here"エージェントを作成する
モデル、システムプロンプト、利用可能なツールを定義するエージェントを作成します。
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イベントを発行します。これらの各クイックスタートは、Claude Managed Agentsを人気のあるチャットフレームワークと組み合わせて、完全で実行可能なアプリケーションを作成します。いずれの場合も、フレームワークがチャット画面をレンダリングし、マネージドセッションがサーバーサイドでエージェントループを実行します。セッションはトランスクリプトを保持し、サンドボックスでツールを実行し、フロントエンドがレンダリングするイベントをストリーミングします。
VercelのChat SDKで構築されたブラウザチャット内のリサーチアナリストです。各会話は1つの永続的なセッションで、ライブフィードがツール呼び出しを表示しながら返信をストリーミングします。Chat SDKアダプターを入れ替えることで、同じハンドラーをSlack、Teams、Discord、WhatsAppに移行できます。
assistant-uiプリミティブから構築されたチャット内のスプレッドシートアナリストです。セッションがスレッドリストとなり、1つのリデューサーがセッションイベントログをメッセージとツールカードに変換し、各bashコマンドは実行前にインラインの許可/拒否ゲートをレンダリングします。
CopilotKitチャット内のパーソナルファイナンスアシスタントです。Claude Managed Agents用のAG-UIアダプターが各チャットスレッドをマネージドセッションにマッピングし、返信をトークンごとにストリーミングします。カスタムツールは会話内にインタラクティブなチャートをインラインでレンダリングします。
再利用可能でバージョン管理されたエージェント設定を作成します
ネットワークとサンドボックスの設定をカスタマイズします
エージェント用の特定のツールを有効にします
イベントを処理し、実行中にエージェントを誘導します
定期的なcronスケジュールでエージェントを実行します
ドキュメントコーパスを一度ナレッジウィキに抽出し、その後はわずかなコストで繰り返しの質問に回答します
Was this page helpful?