Mulai Cepat

BangunLangkah pertama

Mulai dengan Claude Managed Agents

Buat agen otonom pertama Anda.

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

Konsep inti

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
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)

Prasyarat

Akun Console Anthropic
Kunci API

Instal CLI

Periksa instalasi:

ant --version

Instal SDK

Tetapkan kunci API Anda sebagai variabel lingkungan:

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

Buat sesi pertama Anda

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.")
                break

Agen 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.

Yang terjadi

Saat Anda mengirim event pengguna, Claude Managed Agents:

Menyediakan kontainer: Konfigurasi lingkungan Anda menentukan cara pembuatannya.
Menjalankan loop agen: Claude memutuskan alat mana yang akan digunakan berdasarkan pesan Anda
Mengeksekusi alat: Penulisan file, perintah bash, dan panggilan alat lainnya berjalan di dalam kontainer
Melakukan streaming event: Anda menerima pembaruan real-time saat agen bekerja
Menjadi idle: Agen memancarkan event session.status_idle ketika tidak ada lagi yang perlu dilakukan

Langkah selanjutnya

Definisikan agen Anda

Buat konfigurasi agen yang dapat digunakan kembali dan berversi

Konfigurasi lingkungan

Sesuaikan pengaturan jaringan dan kontainer

Alat agen

Aktifkan alat tertentu untuk agen Anda

Event dan streaming

Tangani event dan arahkan agen di tengah eksekusi

Was this page helpful?

BangunLangkah pertama

Mulai dengan Claude Managed Agents

Buat agen otonom pertama Anda.

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

Konsep inti

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
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)

Prasyarat

Akun Console Anthropic
Kunci API

Instal CLI

Periksa instalasi:

ant --version

Instal SDK

Tetapkan kunci API Anda sebagai variabel lingkungan:

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

Buat sesi pertama Anda

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.")
                break

Agen 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.

Yang terjadi

Saat Anda mengirim event pengguna, Claude Managed Agents:

Menyediakan kontainer: Konfigurasi lingkungan Anda menentukan cara pembuatannya.
Menjalankan loop agen: Claude memutuskan alat mana yang akan digunakan berdasarkan pesan Anda
Mengeksekusi alat: Penulisan file, perintah bash, dan panggilan alat lainnya berjalan di dalam kontainer
Melakukan streaming event: Anda menerima pembaruan real-time saat agen bekerja
Menjadi idle: Agen memancarkan event session.status_idle ketika tidak ada lagi yang perlu dilakukan

Langkah selanjutnya

Definisikan agen Anda

Buat konfigurasi agen yang dapat digunakan kembali dan berversi

Konfigurasi lingkungan

Sesuaikan pengaturan jaringan dan kontainer

Alat agen

Aktifkan alat tertentu untuk agen Anda

Event dan streaming

Tangani event dan arahkan agen di tengah eksekusi

Was this page helpful?