Halaman ini mengumpulkan materi referensi untuk Claude Managed Agents. Untuk panduan yang berorientasi pada tugas, ikuti tautan di setiap bagian. Untuk operasi pada resource session, lihat Operasi session.
Permintaan Managed Agents API memerlukan header beta managed-agents-2026-04-01, kecuali endpoint memory store, yang menggunakan agent-memory-2026-07-22 sebagai gantinya. SDK mengatur header beta yang benar secara otomatis. Lihat Header beta.
String tipe event yang dipersistenkan mengikuti konvensi penamaan {domain}.{action}; event delta yang hanya ada di stream (lihat tab Event delta) adalah pengecualiannya. Lihat Stream event session untuk mengirim, melakukan streaming, dan menampilkan daftar event.
| Tipe | Deskripsi |
|---|---|
user.message | Pesan pengguna dengan konten teks, gambar, atau dokumen. |
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 sebuah outcome yang menjadi tujuan kerja agen. |
user.tool_result | Hanya untuk session 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 menggerakkan environment self_hosted. Lihat Sandbox self-hosted untuk menyiapkan environment, menjalankan worker, dan opsi helper SDK.
| Flag | Deskripsi |
|---|---|
--environment-id | Environment yang akan di-polling 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 session sebagai variabel lingkungan. |
--unrestricted-paths | Mengizinkan alat file untuk membaca dan menulis path di luar --workdir. Pemeriksaan workdir hanyalah pengaman untuk alat file, bukan sandbox; pemeriksaan ini tidak membatasi bash. |
--max-idle | Berapa lama menunggu setelah session 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 jarak jauh yang mengekspos endpoint HTTP, atau ke server MCP privat melalui tunnel MCP. Server harus mendukung transport streamable HTTP dari protokol MCP; server yang hanya mendukung transport SSE yang sudah usang tetap berfungsi melalui fallback otomatis. Lihat Konektor MCP untuk mendeklarasikan server pada sebuah agen.
Untuk informasi lebih lanjut tentang MCP dan membangun server MCP, lihat dokumentasi MCP.
Endpoint Managed Agents memiliki "rate limit" (batas laju) per organisasi:
| Operasi | Batas |
|---|---|
| Endpoint pembuatan (seperti agen, session, 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 merujuk 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?