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.

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

Instal CLI

brew install anthropics/tap/ant

Periksa instalasi:

ant --version

Instal SDK

pip install anthropic

Atur kunci API Anda sebagai variabel lingkungan:

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

Buat sesi pertama Anda

Buat agen
Buat agen yang mendefinisikan model, prompt sistem, dan alat yang tersedia.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml) echo "Agent ID: $AGENT_ID"
coding-assistant.agent.yaml
name: Coding Assistant model: id: claude-opus-5 system: You are a helpful coding assistant. Write clean, well-documented code. tools: - 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.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml) echo "Environment ID: $ENVIRONMENT_ID"
quickstart.environment.yaml
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, menjalankannya 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.
Menjalankan alat: Penulisan file, perintah bash, dan pemanggilan alat lainnya berjalan 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.

Bangun aplikasi lengkap

Setiap quickstart ini memasangkan Claude Managed Agents dengan framework chat populer untuk membuat aplikasi lengkap yang dapat dijalankan. Di masing-masing contoh, framework merender antarmuka chat sementara sesi terkelola menjalankan loop agen di sisi server: sesi menyimpan transkrip, menjalankan alat di sandbox, dan melakukan streaming event yang dirender oleh front end.

Chat SDK

Analis riset dalam chat browser yang dibangun dengan Chat SDK dari Vercel. Setiap percakapan adalah satu sesi persisten yang melakukan streaming balasannya sementara feed langsung menampilkan pemanggilan alat. Mengganti adapter Chat SDK memindahkan handler yang sama ke Slack, Teams, Discord, atau WhatsApp.

assistant-ui

Analis spreadsheet dalam chat yang dibangun dari primitif assistant-ui. Sesi adalah daftar thread, satu reducer mengubah log event sesi menjadi pesan dan kartu alat, dan setiap perintah bash merender gerbang Allow/Deny inline sebelum dijalankan.

CopilotKit (AG-UI)

Asisten keuangan pribadi dalam chat CopilotKit. Adapter AG-UI untuk Claude Managed Agents memetakan setiap thread chat ke sesi terkelola dan melakukan streaming balasan token demi token, dan alat kustom merender grafik interaktif secara inline dalam percakapan.

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

Quickstart wiki pengetahuan

Saring korpus dokumen sekali menjadi wiki pengetahuan, lalu jawab pertanyaan berulang darinya dengan biaya yang jauh lebih rendah

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

Buat agen
Buat agen yang mendefinisikan model, prompt sistem, dan alat yang tersedia.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml) echo "Agent ID: $AGENT_ID"
coding-assistant.agent.yaml
name: Coding Assistant model: id: claude-opus-5 system: You are a helpful coding assistant. Write clean, well-documented code. tools: - 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.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml) echo "Environment ID: $ENVIRONMENT_ID"
quickstart.environment.yaml
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, menjalankannya 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.

Menjalankan alat: Penulisan file, perintah bash, dan pemanggilan alat lainnya berjalan 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.

Bangun aplikasi lengkap

Chat SDK

assistant-ui

CopilotKit (AG-UI)

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

Quickstart wiki pengetahuan

Saring korpus dokumen sekali menjadi wiki pengetahuan, lalu jawab pertanyaan berulang darinya dengan biaya yang jauh lebih rendah

Was this page helpful?

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Bangun aplikasi lengkap

Langkah selanjutnya

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Bangun aplikasi lengkap

Langkah selanjutnya

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Bangun aplikasi lengkap

Langkah selanjutnya

Konsep inti

Prasyarat

Instal CLI

Instal SDK

Buat sesi pertama Anda

Apa yang terjadi

Bangun aplikasi lengkap

Langkah selanjutnya