Halaman ini mengumpulkan materi referensi untuk Claude Managed Agents. Untuk panduan berorientasi tugas, ikuti tautan di setiap bagian. Untuk operasi pada resource sesi, lihat Operasi sesi.
Semua permintaan Managed Agents API memerlukan beta header managed-agents-2026-04-01. SDK menetapkan beta header tersebut secara otomatis.
String tipe event yang dipersistensi mengikuti konvensi penamaan {domain}.{action}; delta event yang hanya muncul di stream (lihat tab Delta event) adalah pengecualian. Lihat Stream event sesi untuk mengirim, melakukan streaming, dan mencantumkan event.
| Tipe | Deskripsi |
|---|---|
user.message | Pesan pengguna dengan konten teks. |
user.interrupt | Menghentikan agen di tengah eksekusi. |
user.custom_tool_result | Respons terhadap panggilan alat kustom dari agen. |
user.tool_confirmation | Menyetujui atau menolak panggilan alat agen atau MCP ketika kebijakan izin memerlukan konfirmasi. |
user.define_outcome | Mendefinisikan outcome yang menjadi target kerja agen. |
user.tool_result | Hanya untuk sesi dengan environment self_hosted, integrasi Anda bertanggung jawab untuk menyediakan hasil agent_toolset. Helper SDK dan CLI melakukan ini secara otomatis. |
Berikut adalah flag CLI ant beta:worker untuk worker bawaan yang menjalankan environment self_hosted. Lihat Sandbox self-hosted untuk menyiapkan environment, menjalankan worker, dan opsi helper SDK.
| Flag | Deskripsi |
|---|---|
--environment-id | Environment yang akan di-poll untuk pekerjaan. Juga membaca dari ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Mengautentikasi worker dengan environment ini. Juga membaca dari ANTHROPIC_ENVIRONMENT_KEY. |
--workdir | Direktori tempat skill diunduh dan alat membaca serta menulis file. Default-nya adalah . (direktori saat ini); direktori kerja default sistem adalah /workspace. |
--on-work | Skrip yang dipanggil untuk setiap item pekerjaan yang diklaim alih-alih menjalankan alat secara in-process. Menerima detail sesi sebagai variabel environment. |
--unrestricted-paths | Mengizinkan panggilan alat untuk mengakses path di luar --workdir. |
--max-idle | Berapa lama menunggu setelah sesi menjadi idle dengan stop reason end_turn sebelum dimatikan. Default-nya adalah 60s. |
--log-format | Format output log. Gunakan json untuk ingesti log terstruktur. Default-nya adalah text. |
Claude Managed Agents terhubung ke server MCP remote yang mengekspos endpoint HTTP, atau ke server MCP privat melalui MCP tunnel. Server harus mendukung transport HTTP streamable dari protokol MCP. Lihat Konektor MCP untuk mendeklarasikan server pada agen.
Untuk informasi lebih lanjut tentang MCP dan membangun server MCP, lihat dokumentasi MCP.
Endpoint Managed Agents dibatasi lajunya per organisasi:
| Operasi | Batas |
|---|---|
| Endpoint pembuatan (seperti agen, sesi, dan environment) | 300 permintaan per menit |
| Endpoint pembacaan (seperti retrieve, list, dan stream) | 1.200 permintaan per menit |
Batas pengeluaran dan batas laju tingkat penggunaan di tingkat organisasi juga berlaku.
Untuk mitra yang mengintegrasikan Claude Managed Agents, penggunaan branding Claude bersifat opsional. Saat mereferensikan Claude dalam produk Anda:
Diizinkan:
Tidak diizinkan:
Produk Anda harus mempertahankan branding-nya sendiri dan tidak tampak seperti Claude Code, Claude Cowork, atau produk Anthropic lainnya. Untuk pertanyaan tentang kepatuhan branding, hubungi tim penjualan Anthropic.
Was this page helpful?