このガイドでは、エージェントの作成、環境のセットアップ、セッションの開始、エージェントの応答のストリーミングについて順を追って説明します。
| 概念 | 説明 |
|---|---|
| エージェント | モデル、システムプロンプト、ツール、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 --transform id --raw-output < coding-assistant.agent.yaml)
echo "Agent ID: $AGENT_ID"name: Coding Assistant
model:
id: claude-opus-5
system: You are a helpful coding assistant. Write clean, well-documented code.
tools:
- type: agent_toolset_20260401agent_toolset_20260401ツールタイプは、事前構築されたエージェントツールの完全なセット(bash、ファイル操作、Web検索など)を有効にします。完全なリストとツールごとの設定オプションについては、ツールを参照してください。
返されたagent.idを保存してください。作成するすべてのセッションで参照します。
環境を作成する
環境は、エージェントが実行されるサンドボックスを定義します。
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml)
echo "Environment ID: $ENVIRONMENT_ID"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は次の処理を行います。
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スケジュールでエージェントを実行する
ドキュメントコーパスを一度ナレッジWikiに抽出し、その後は大幅に低いコストで繰り返しの質問に回答する
Was this page helpful?