Anthropic Claude Managed Agents 公测上线：5 分钟跑通全托管 AI 代理

Pada 8 April 2026, Anthropic secara resmi membuka Public Beta untuk Claude Managed Agents di Platform Claude. Kerangka kerja agen terkelola (Managed Agent Harness) yang serba baru ini membungkus "siklus agen + eksekusi alat + kontainer sandbox + persistensi status" ke dalam satu set REST API. Pengembang tidak perlu lagi membangun sendiri loop agen, lapisan pemanggilan alat, atau runtime. Cukup dengan memanggil tiga endpoint: /v1/agents, /v1/environments, dan /v1/sessions, Anda dapat membiarkan Claude menyelesaikan tugas berdurasi panjang sebagai agen otonom di dalam sandbox yang aman.

Peluncuran beta ini juga menyertakan header permintaan managed-agents-2026-04-01 Beta, set alat agent_toolset_20260401 yang baru, serta protokol aliran peristiwa berbasis Server-Sent Events. Artikel ini menggabungkan dokumentasi resmi dan Release Notes terbaru untuk menguraikan konsep inti, cara akses API, model peristiwa, dan aturan penagihan Claude Managed Agents. Kami juga menyertakan kode Python/curl yang dapat langsung digunakan untuk membantu Anda menjalankan sesi Managed Agent yang nyata dalam waktu kurang dari 5 menit.

Apa itu Claude Managed Agents: Posisi Inti Agen Terkelola

Sebelum memahami Managed Agents, kita perlu memperjelas hubungannya dengan Messages API tradisional. Anthropic kini menawarkan dua jalur pengembangan: Messages API bertanggung jawab untuk pemanggilan model secara langsung, cocok untuk skenario yang memerlukan kendali penuh atas loop agen; sedangkan Managed Agents menyediakan lingkungan eksekusi agen yang telah dibangun sebelumnya dan dapat dikonfigurasi, cocok untuk beban kerja yang berdurasi panjang, asinkron, dan memerlukan isolasi sandbox.

Perbedaan Posisi dengan Messages API

🎯 Saran Pemilihan: Jika Anda sedang membangun tugas latar belakang yang memerlukan "AI untuk menulis kode secara otonom, menjalankan skrip, menelusuri web, lalu merangkum hasilnya", Managed Agents akan jauh lebih praktis daripada menggabungkan Messages API + sandbox buatan sendiri secara manual. Disarankan untuk melakukan pengujian perbandingan antara keduanya di platform APIYI (apiyi.com) untuk menentukan dengan cepat bentuk mana yang lebih cocok untuk bisnis Anda.

Empat Konsep Inti

Claude Managed Agents dibangun di sekitar empat konsep dasar:

• Agent (Agen): Definisi statis dari model, petunjuk sistem, alat, MCP Server, dan Keterampilan. Setelah dibuat, dapat digunakan kembali oleh banyak sesi dan mendukung pembuatan versi.
• Environment (Lingkungan): Templat kontainer cloud yang menjelaskan paket yang telah diinstal sebelumnya, kebijakan akses jaringan, dan file yang dipasang (mount).
• Session (Sesi): Instans eksekusi spesifik dari Agent + Environment yang bertanggung jawab untuk menjalankan tugas sekali pakai atau tugas berdurasi panjang.
• Events (Peristiwa): Pesan yang dipertukarkan antara Sesi dan klien, termasuk pesan pengguna, pemanggilan alat, hasil alat, perubahan status, dll.

Bedah Kemampuan Utama Managed Agents: Sandbox, Toolset, dan SSE Stream

Setelah memahami empat konsep dasarnya, mari kita lihat kemampuan praktis yang ditawarkan dalam versi Beta ini.

Sandbox Keamanan dan Konfigurasi Kontainer

Setiap sesi berjalan di dalam kontainer cloud yang terisolasi dengan karakteristik berikut:

• Runtime Pra-instal: Lingkungan bahasa pemrograman populer seperti Python, Node.js, dan Go siap digunakan.
• Kebijakan Jaringan: Mendukung mode unrestricted (tanpa batasan) dan mode jaringan terbatas yang lebih ketat, guna mencegah sandbox disalahgunakan untuk eksfiltrasi data.
• Sistem File: File di dalam kontainer akan tetap ada selama masa pakai sesi, sehingga Agent bisa melakukan baca-tulis lintas putaran interaksi.
• Sumber Daya yang Dapat Dipasang: Anda dapat memasang file data atau skrip di dalam Environment terlebih dahulu.

Toolset Bawaan agent_toolset_20260401

Versi akses publik menyediakan pengidentifikasi toolset terpadu agent_toolset_20260401 yang memungkinkan Anda mengaktifkan semua alat bawaan sekaligus:

🎯 Tips Pengembang: agent_toolset_20260401 adalah "sakelar kombinasi" untuk memudahkan validasi prototipe dengan cepat. Di lingkungan produksi, disarankan untuk mengaktifkan subset sesuai kebutuhan dengan prinsip hak akses minimal. Jika ingin membandingkan biaya token untuk subset alat yang berbeda di APIYI apiyi.com, Anda bisa langsung mengganti base_url dan menggunakan kembali potongan kode yang sama.

Model Kejadian Streaming Server-Sent Events

Berbeda dengan API Pesan tradisional yang bersifat "satu permintaan → satu respons", Managed Agents menggunakan model berbasis kejadian + dorongan SSE. Berikut adalah jenis kejadian utamanya:

Memulai Cepat Claude Managed Agents: Alur Akses API Lengkap

Berikut adalah demonstrasi sesi Managed Agent lengkap dengan kode sesingkat mungkin. Langkah utamanya meliputi: Membuat Agent → Membuat Environment → Membuat Session → Mengirim pesan dan berlangganan SSE stream.

Prasyarat

1. Kunci API Claude (atau kunci yang kompatibel dari APIYI apiyi.com).
2. Setiap permintaan harus membawa header anthropic-beta: managed-agents-2026-04-01; SDK resmi akan melampirkannya secara otomatis, sementara curl manual harus dideklarasikan secara eksplisit.
3. Tingkatkan SDK Python ke versi terbaru: pip install -U anthropic.

Contoh Python Minimalis

from anthropic import Anthropic

client = Anthropic(
    # Gunakan APIYI untuk menggunakan kode yang sudah ada tanpa mengubah cara penggunaan SDK
    base_url="https://api.apiyi.com",
    api_key="YOUR_API_KEY",
)

# 1. Membuat Agent
agent = client.beta.agents.create(
    name="Coding Assistant",
    model="claude-sonnet-4-6",
    system="You are a helpful coding assistant.",
    tools=[{"type": "agent_toolset_20260401"}],
)

# 2. Membuat Environment (jaringan tanpa batasan)
env = client.beta.environments.create(
    name="quickstart-env",
    config={"type": "cloud", "networking": {"type": "unrestricted"}},
)

# 3. Membuat Session
session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=env.id,
    title="Quickstart session",
)

# 4. Buka SSE stream dan kirim pesan pengguna
with client.beta.sessions.events.stream(session.id) as stream:
    client.beta.sessions.events.send(
        session.id,
        events=[{
            "type": "user.message",
            "content": [{
                "type": "text",
                "text": "Generate the first 20 Fibonacci numbers to fibonacci.txt",
            }],
        }],
    )
    for event in stream:
        if event.type == "agent.message":
            for block in event.content:
                print(block.text, end="")
        elif event.type == "agent.tool_use":
            print(f"\n[Using tool: {event.name}]")
        elif event.type == "session.status_idle":
            print("\n\nAgent finished.")
            break

# Membuat Agent dengan header Beta
curl -sS https://api.apiyi.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "Coding Assistant",
    "model": "claude-sonnet-4-6",
    "system": "You are a helpful coding assistant.",
    "tools": [{"type": "agent_toolset_20260401"}]
  }'

# Struktur permintaan untuk membuat Environment dan Session serupa, lihat dokumentasi quickstart resmi
# Untuk berlangganan SSE stream gunakan:
# curl -N -H "Accept: text/event-stream" \
#   https://api.apiyi.com/v1/sessions/$SESSION_ID/stream

🎯 Saran Penggunaan Kembali Kode: base_url di atas mengarah ke APIYI apiyi.com, yang memungkinkan Anda mengakses antarmuka beta Managed Agents dengan latensi rendah dari Tiongkok daratan. Semua parameter, header Beta, dan jenis kejadian SDK resmi sepenuhnya kompatibel, tanpa perlu enkapsulasi ulang.

Diagram Alur Lima Langkah

[Client] ──1. create agent──────────▶ [API]
[Client] ──2. create environment────▶ [API]
[Client] ──3. create session────────▶ [API]
[Client] ──4. open SSE stream───────▶ [API]
[Client] ──5. send user.message─────▶ [API]
         ◀─ agent.message / tool_use / tool_result / status_idle ──

Inti dari seluruh proses ini adalah: Kejadian didahulukan, penerimaan streaming. Saran resmi adalah membuka SSE stream terlebih dahulu sebelum mengirim peristiwa pengguna, agar Anda tidak melewatkan status perantara apa pun.

Aturan Kunci Claude Managed Agents: Limit Rate, Penagihan, dan Kepatuhan Merek

Versi beta publik telah menetapkan parameter produksi yang jelas. Berikut adalah tiga aturan yang paling diperhatikan oleh pengembang.

Aturan Limit Rate (Pembatasan Laju)

Limit rate dihitung per Organisasi, dan ini terpisah dari Tier di bawah akun:

Selain itu, kuota konsumsi tingkat organisasi dan batas laju Tier tetap berlaku. Tugas agen batch dengan konkurensi tinggi memerlukan perencanaan pembatasan laju sebelumnya, atau dapat didistribusikan ke kumpulan sumber daya multi-akun melalui APIYI apiyi.com.

Model Penagihan

Penagihan Managed Agents terdiri dari dua bagian:

1. Biaya runtime Sesi: $0,08 / jam sesi.
2. Biaya Token Model: Dihitung berdasarkan harga satuan standar model Claude yang dipilih (seperti Sonnet 4.6 / Opus 4.6).

Tidak ada biaya langganan tambahan dan tidak ada biaya infrastruktur tetap. Ini berarti Sesi yang tidak aktif tetapi belum ditutup akan tetap dikenakan biaya per jam, pastikan untuk memanggil antarmuka penutupan (close) setelah tugas selesai.

Poin Kepatuhan Merek

Anthropic memiliki batasan ketat bagi mitra dalam menggunakan merek Claude:

• ✅ Diizinkan: Claude Agent, Claude (dalam konteks menu), {YourAgentName} Powered by Claude.
• ❌ Dilarang: Nama seperti Claude Code, Claude Code Agent, Claude Cowork, dll; dilarang meniru seni ASCII atau elemen visual Claude Code.

🎯 Saran Kepatuhan: Untuk produk agen terkelola yang diserahkan ke perusahaan, disarankan untuk menjaga posisi merek Anda sendiri, dan hanya mencantumkan "Powered by Claude" dalam penjelasan teknis sebagai bentuk apresiasi. Jika memerlukan otorisasi merek resmi atau UI berbasis template, Anda bisa mendapatkan panduan koneksi saluran kerja sama melalui APIYI apiyi.com.

Skenario Aplikasi Khas Claude Managed Agents: Bisnis Mana yang Paling Layak Dimigrasi

Meskipun versi beta publik masih memiliki beberapa fitur (outcomes, multiagent, memory) yang berada dalam tahap Research Preview, namun untuk empat skenario berikut ini sudah bisa langsung diimplementasikan.

Empat Beban Kerja yang Layak Dimigrasi Segera

Skenario yang Belum Disarankan

• Percakapan real-time dengan latensi sangat rendah: Overhead aktivasi Sesi dan SSE kurang ramah untuk UI yang membutuhkan waktu respons milidetik.
• Penyebaran lokal dengan kepatuhan ketat: Managed Agents adalah layanan cloud, tidak mendukung on-premise.
• Proyek riset yang memerlukan kustomisasi total pada loop agen: Masih disarankan untuk menggunakan Messages API guna membangun loop sendiri.

🎯 Saran Jalur Migrasi: Coba terapkan bisnis agen "Messages API + penjadwalan alat mandiri" Anda yang sudah ada ke dalam Managed Agents sebagai implementasi perbandingan. Jalankan kedua versi dengan petunjuk yang sama, lalu bandingkan biaya token dan tingkat penyelesaian. Melalui APIYI apiyi.com, Anda dapat menggunakan kunci yang sama untuk mengakses kedua antarmuka secara bersamaan, sehingga menghindari keharusan mengganti kunci API saat melakukan evaluasi paralel.

FAQ: Menghindari Masalah Saat Memulai Managed Agents

Q1: Apakah managed-agents-2026-04-01 perlu dilampirkan secara manual?

Saat menggunakan SDK resmi (Python / TypeScript / Go / Java / C# / Ruby / PHP), Anda tidak perlu melampirkannya secara manual karena SDK akan menyuntikkannya secara otomatis di jalur Beta. Hanya jika Anda menggunakan curl asli atau klien HTTP buatan sendiri, Anda perlu menambahkan anthropic-beta: managed-agents-2026-04-01 secara eksplisit. Kami menyarankan untuk tetap menggunakan jalur standar saat melakukan pemanggilan melalui layanan proksi API APIYI (apiyi.com) untuk kompatibilitas terbaik.

Q2: Apakah sesi akan hilang jika aliran SSE terputus?

Tidak. Riwayat kejadian Sesi disimpan secara persisten di sisi server. Setelah terputus dan terhubung kembali ke endpoint /v1/sessions/{id}/stream, Anda dapat terus menerima kejadian berikutnya, dan API akan mengirimkan data susulan dari buffer titik henti. Hal ini sangat berbeda dengan Messages API yang memiliki mekanisme "satu permintaan untuk satu respons".

Q3: Bagaimana cara menghentikan Agent yang sedang berjalan?

Managed Agents mendukung mid-execution steering: cukup kirim pesan user.message lain ke endpoint /events di sesi yang sama untuk menghentikan siklus pemanggilan alat saat ini dan mengubah arahnya. Anda juga dapat menggunakan endpoint interupsi khusus untuk mengakhiri sesi secara paksa.

Q4: Dalam kondisi apa biaya Sesi akan muncul?

Selama Sesi berada dalam status "bisa dijalankan", Anda akan dikenakan biaya $0,08/jam, meskipun Agent berada dalam status status_idle. Kami menyarankan untuk menutup Sesi secara eksplisit setelah tugas selesai guna menghindari biaya saat idle. Anda dapat menggunakan panel rincian tagihan di APIYI (apiyi.com) untuk mendeteksi sesi yang menganggur dengan cepat.

Q5: Model Claude apa saja yang didukung oleh Managed Agents?

Saat ini, versi beta publik mendukung tiga model utama: Claude Sonnet 4.6, Claude Opus 4.6, dan Claude Haiku 4.5. Jendela konteks yang panjang (1M token) tersedia secara default pada Opus 4.6 dan Sonnet 4.6 tanpa memerlukan header Beta tambahan.

Q6: Bisakah saya memindahkan Agent Skills / MCP Server yang sudah ada?

Bisa. Anda dapat mendeklarasikan daftar MCP Server dan referensi Skills langsung dalam definisi Agent. Managed Agents menggunakan kembali protokol Agent Skills Beta yang dirilis pada Oktober 2025, sehingga paket skill yang sudah ada dapat diintegrasikan tanpa perlu modifikasi.

Kesimpulan: Pergeseran Paradigma Pengembangan yang Dibawa Managed Agents

Peluncuran publik Claude Managed Agents menandai langkah resmi Anthropic dalam memasukkan "infrastruktur Agent" ke dalam lini produk resmi mereka. Bagi pengembang, nilai dari pembaruan ini bukan sekadar fitur tunggal, melainkan penghapusan lima hambatan utama dalam membangun sistem Agent secara mandiri: implementasi loop, eksekusi alat, isolasi sandbox, persistensi status, dan protokol aliran kejadian. Cukup tambahkan header permintaan Beta managed-agents-2026-04-01 dan panggil tiga endpoint, Anda dapat mengubah Claude menjadi "agen eksekutif otonom" yang sesungguhnya.

Dengan dukungan model Claude Sonnet 4.6 / Opus 4.6 terbaru, jendela konteks 1M token, Agent Skills, dan cache otomatis, Managed Agents memungkinkan bisnis agen latar belakang yang membutuhkan waktu lama, bersifat asinkron, dan menggunakan banyak alat untuk pertama kalinya memiliki jalur penerapan kelas perusahaan yang dapat direplikasi. Selanjutnya, kami sarankan untuk melakukan uji coba pada skenario risiko rendah (seperti laporan otomatis atau scaffold kode) sebelum memigrasikan bisnis utama.

🎯 Saran Tindakan: Bagi tim yang bersiap untuk bermigrasi, kami sarankan untuk mengarahkan base_url ke APIYI (apiyi.com). Hal ini memungkinkan penggunaan kembali kode SDK resmi, mendapatkan kecepatan akses domestik yang stabil, serta mendukung evaluasi paralel antara Messages API dan Managed Agents, sehingga memberikan data yang cukup untuk pengambilan keputusan.

— Tim APIYI (Tim Teknis APIYI apiyi.com)