Claude Platform Docs
Managed AgentsLangkah pertama

Memulai dengan Claude Managed Agents

Buat agen otonom pertama Anda.

Panduan ini memandu Anda dalam membuat agen, menyiapkan lingkungan, memulai sesi, dan melakukan “streaming” (streaming) respons agen.

Claude Code

Biarkan Claude Code menyiapkan agen Anda untuk Anda

/claude-api managed-agents-onboard

Konsep inti

KonsepDeskripsi
AgenModel, prompt sistem, alat, server MCP, dan skill
LingkunganKonfigurasi untuk tempat sesi berjalan: sandbox cloud yang dikelola Anthropic, atau sandbox yang di-hosting sendiri di infrastruktur Anda sendiri
SesiInstans agen yang sedang berjalan di dalam sebuah environment, melakukan tugas tertentu dan menghasilkan output
EventPesan yang dipertukarkan antara aplikasi Anda dan agen (giliran pengguna, hasil alat, pembaruan status)

Sebelum Anda memulai

  1. Buat akun Claude Console

    Daftar untuk akun Claude Console, atau masuk ke akun yang sudah Anda miliki.

  2. Pilih cara autentikasi

    Masuk dengan CLI direkomendasikan untuk pengembangan lokal.

    CLIKunci API
  1. Instal CLI

    brew install anthropics/tap/ant
  2. Masuk

    ant auth login

    Setelah login selesai, SDK dan CLI akan mengambil kredensial Anda secara otomatis.

Instal SDK

pip install anthropic

Buat sesi pertama Anda

  1. Buat agen

    Buat agen yang menentukan model, “system prompt” (prompt sistem), dan alat yang tersedia.

    ant apply coding-assistant.md
    coding-assistant.md
    ---
    name: Coding Assistant
    model: claude-opus-5-5
    tools:
      - type: agent_toolset_20260401
        configs:
          - name: web_search
            enabled: false
          - name: web_fetch
            enabled: false
    ---
    
    You are a helpful coding assistant. Write clean, well-documented code.

    ant apply mencetak ID agen dan mencatatnya di claude-lock.json. Anda akan mereferensikannya di setiap sesi yang Anda buat.

    Tipe alat agent_toolset_20260401 mengaktifkan alat agen bawaan (bash, operasi file, pencarian web, dan lainnya). Contoh ini menonaktifkan pencarian web dan pengambilan web karena tugas dalam panduan ini, yaitu menulis skrip Python singkat, tidak menggunakan web. Berikan agen hanya alat yang dibutuhkannya. Lihat Alat untuk daftar lengkap dan opsi konfigurasi per alat.

  2. Buat lingkungan

    Lingkungan menentukan sandbox tempat agen Anda berjalan. Lingkungan ini menggunakan jaringan limited dengan manajer paket diizinkan, sehingga kode yang berjalan di sandbox dapat menjangkau registri paket dan host kode publik. Dengan jaringan limited, daftar allowed_hosts juga berlaku untuk pencarian web dan pengambilan web, meskipun keduanya berjalan di luar sandbox. Tanpa host yang tercantum, seperti di lingkungan ini, keduanya tidak mengembalikan halaman atau hasil pencarian. Jika agen Anda sendiri menggunakan alat-alat ini, tambahkan host yang dibutuhkannya ke daftar tersebut.

    ant apply environment.yaml
    environment.yaml
    # yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
    name: quickstart-env
    config:
      type: cloud
      networking:
        type: limited
        allow_package_managers: true

    ant apply juga mencatat ID lingkungan di claude-lock.json. Untuk membuat agen dan lingkungan dengan satu perintah, berikan kedua file: ant apply coding-assistant.md environment.yaml.

  3. Mulai sesi

    Buat sesi yang mereferensikan 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}")
  4. Kirim pesan dan lakukan streaming respons

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

    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:
                        if block.type == "text":
                            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 mirip dengan 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:

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

Bangun aplikasi lengkap

Masing-masing quickstart ini memadukan Claude Managed Agents dengan framework chat populer untuk membuat aplikasi lengkap yang dapat dijalankan. Di masing-masing, 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.

Seorang 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 panggilan alat. Mengganti adaptor Chat SDK akan memindahkan handler yang sama ke Slack, Teams, Discord, atau WhatsApp.

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

Asisten keuangan pribadi dalam chat CopilotKit. Adaptor 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

Buat konfigurasi agen yang dapat digunakan kembali dan berversi

Sesuaikan pengaturan jaringan dan sandbox

Aktifkan alat tertentu untuk agen Anda

Tangani event dan arahkan agen saat berjalan

Jalankan agen Anda pada jadwal cron berulang

Saring korpus dokumen sekali menjadi wiki pengetahuan, lalu jawab pertanyaan berulang darinya dengan sebagian kecil biaya

Apakah halaman ini membantu?