Panduan ini memandu Anda membuat agen, menyiapkan lingkungan, memulai sesi, dan melakukan streaming respons agen.
| Concept | Description |
|---|---|
| Agent | The model, system prompt, tools, MCP servers, and skills |
| Environment | Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure |
| Session | A running agent instance within an environment, performing a specific task and generating outputs |
| Events | Messages exchanged between your application and the agent (user turns, tool results, status updates) |
Periksa instalasi:
ant --versionTetapkan kunci API Anda sebagai variabel lingkungan:
export ANTHROPIC_API_KEY="your-api-key-here"Semua permintaan API Managed Agents memerlukan header beta managed-agents-2026-04-01. SDK menetapkan header beta secara otomatis.
Buat agen
Buat agen yang mendefinisikan model, system prompt, dan alat yang tersedia.
ant beta:agents create \
--name "Coding Assistant" \
--model '{id: claude-opus-4-7}' \
--system "You are a helpful coding assistant. Write clean, well-documented code." \
--tool '{type: agent_toolset_20260401}'Tipe alat agent_toolset_20260401 mengaktifkan kumpulan lengkap alat agen bawaan (bash, operasi file, pencarian web, dan lainnya). Lihat Alat untuk daftar lengkap dan opsi konfigurasi per alat.
Simpan agent.id yang dikembalikan. Anda akan merujuknya di setiap sesi yang Anda buat.
Buat lingkungan
Lingkungan mendefinisikan kontainer tempat agen Anda berjalan.
ant beta:environments create \
--name "quickstart-env" \
--config '{type: cloud, networking: {type: unrestricted}}'Simpan environment.id yang dikembalikan. Anda akan merujuknya di setiap sesi yang Anda buat.
Mulai sesi
Buat sesi yang merujuk agen dan lingkungan Anda.
session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
title="Quickstart session",
)
print(f"Session ID: {session.id}")Kirim pesan dan streaming respons
Buka stream, kirim event pengguna, lalu proses event saat tiba:
with client.beta.sessions.events.stream(session.id) as stream:
# Send the user message after the stream opens
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",
},
],
},
],
)
# Process streaming events
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.")
breakAgen akan menulis skrip Python, mengeksekusinya di dalam kontainer, dan memverifikasi bahwa file output telah dibuat. Output Anda akan terlihat seperti ini:
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.Saat Anda mengirim event pengguna, Claude Managed Agents:
session.status_idle ketika tidak ada lagi yang perlu dilakukanBuat konfigurasi agen yang dapat digunakan kembali dan berversi
Sesuaikan pengaturan jaringan dan kontainer
Aktifkan alat tertentu untuk agen Anda
Tangani event dan arahkan agen di tengah eksekusi
Was this page helpful?