Managed AgentsLangkah pertama

Memulai dengan Claude Managed Agents

Buat agen otonom pertama Anda.

Panduan ini memandu Anda dalam membuat agen, menyiapkan environment, memulai sesi, dan melakukan streaming respons agen.

Lebih suka panduan interaktif? Jalankan /claude-api managed-agents-onboard di versi terbaru Claude Code untuk penyiapan terpandu dan tanya jawab interaktif.

Konsep inti

Konsep	Deskripsi
Agent	Model, prompt sistem, alat, server MCP, dan skill
Environment	Konfigurasi untuk tempat sesi dijalankan: sandbox cloud yang dikelola Anthropic, atau sandbox yang di-host sendiri pada infrastruktur Anda
Session	Instance agent yang sedang berjalan dalam sebuah environment, menjalankan tugas tertentu dan menghasilkan output
Events	Pesan yang dipertukarkan antara aplikasi Anda dan agent (giliran pengguna, hasil alat, pembaruan status)

Prasyarat

Akun Console Anthropic
Kunci API

Instal CLI

Periksa instalasi:

ant --version

Instal SDK

Atur kunci API Anda sebagai variabel lingkungan:

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

Buat sesi pertama Anda

Semua permintaan Managed Agents API memerlukan beta header managed-agents-2026-04-01. SDK menetapkan beta header tersebut secara otomatis.

Buat agen
Buat agen yang mendefinisikan model, prompt sistem, dan alat yang tersedia.
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}'
Tipe alat agent_toolset_20260401 mengaktifkan set 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 mereferensikannya di setiap sesi yang Anda buat.
Buat environment
Environment mendefinisikan sandbox tempat agen Anda berjalan.
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
Simpan environment.id yang dikembalikan. Anda akan mereferensikannya di setiap sesi yang Anda buat.
Untuk menjalankan sandbox di infrastruktur Anda sendiri alih-alih sandbox cloud, lihat Sandbox yang di-host sendiri.

Mulai sesi

Buat sesi yang mereferensikan agen dan environment 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 lakukan streaming respons

Buka stream, kirim event pengguna, lalu proses event saat diterima:

with client.beta.sessions.events.stream(session.id) as stream:
    # Kirim pesan pengguna setelah stream terbuka
    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",
                    },
                ],
            },
        ],
    )

    # Proses event streaming
    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

Agen menulis skrip Python, mengeksekusinya di sandbox, 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.

Apa yang terjadi

Saat Anda mengirim event pengguna, Claude Managed Agents:

Menyediakan sandbox: Konfigurasi environment Anda menentukan bagaimana sandbox dibangun.
Menjalankan loop agen: Claude menentukan alat mana yang akan digunakan berdasarkan pesan Anda.
Mengeksekusi alat: Penulisan file, perintah bash, dan pemanggilan alat lainnya dijalankan di dalam sandbox.
Melakukan streaming event: Anda menerima pembaruan real-time saat agen bekerja.
Menjadi idle: Agen mengeluarkan event session.status_idle ketika tidak ada lagi yang perlu dilakukan.

Langkah selanjutnya

Definisikan agen Anda

Buat konfigurasi agen yang dapat digunakan kembali dan memiliki versi

Konfigurasi environment

Sesuaikan pengaturan jaringan dan sandbox

Alat agen

Aktifkan alat tertentu untuk agen Anda

Stream event sesi

Tangani event dan arahkan agen di tengah eksekusi

Deployment terjadwal

Jalankan agen Anda pada jadwal cron berulang

Was this page helpful?

Konsep inti

Konsep	Deskripsi
Agent	Model, prompt sistem, alat, server MCP, dan skill
Environment	Konfigurasi untuk tempat sesi dijalankan: sandbox cloud yang dikelola Anthropic, atau sandbox yang di-host sendiri pada infrastruktur Anda
Session	Instance agent yang sedang berjalan dalam sebuah environment, menjalankan tugas tertentu dan menghasilkan output
Events	Pesan yang dipertukarkan antara aplikasi Anda dan agent (giliran pengguna, hasil alat, pembaruan status)

Buat sesi pertama Anda

Semua permintaan Managed Agents API memerlukan beta header managed-agents-2026-04-01. SDK menetapkan beta header tersebut secara otomatis.

Buat agen
Buat agen yang mendefinisikan model, prompt sistem, dan alat yang tersedia.
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}'
Tipe alat agent_toolset_20260401 mengaktifkan set 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 mereferensikannya di setiap sesi yang Anda buat.
Buat environment
Environment mendefinisikan sandbox tempat agen Anda berjalan.
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
Simpan environment.id yang dikembalikan. Anda akan mereferensikannya di setiap sesi yang Anda buat.
Untuk menjalankan sandbox di infrastruktur Anda sendiri alih-alih sandbox cloud, lihat Sandbox yang di-host sendiri.

Mulai sesi

Buat sesi yang mereferensikan agen dan environment 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 lakukan streaming respons

Buka stream, kirim event pengguna, lalu proses event saat diterima:

with client.beta.sessions.events.stream(session.id) as stream:
    # Kirim pesan pengguna setelah stream terbuka
    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",
                    },
                ],
            },
        ],
    )

    # Proses event streaming
    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

Agen menulis skrip Python, mengeksekusinya di sandbox, 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.

Apa yang terjadi

Saat Anda mengirim event pengguna, Claude Managed Agents:

Menyediakan sandbox: Konfigurasi environment Anda menentukan bagaimana sandbox dibangun.

Menjalankan loop agen: Claude menentukan alat mana yang akan digunakan berdasarkan pesan Anda.

Mengeksekusi alat: Penulisan file, perintah bash, dan pemanggilan alat lainnya dijalankan di dalam sandbox.

Melakukan streaming event: Anda menerima pembaruan real-time saat agen bekerja.

Menjadi idle: Agen mengeluarkan event session.status_idle ketika tidak ada lagi yang perlu dilakukan.

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Langkah selanjutnya

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Langkah selanjutnya

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Langkah selanjutnya

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Langkah selanjutnya