Referensi
Tipe event, flag CLI worker self-hosted, tipe server MCP yang didukung, batas laju, dan pedoman branding untuk Claude Managed Agents.
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.
Tipe event
String tipe event yang dipersistenkan mengikuti konvensi penamaan {domain}.{action}; event delta yang hanya tersedia di stream (lihat tab Event deltas) adalah pengecualiannya. Lihat Stream event sesi untuk mengirim, melakukan streaming, dan mendaftar event. Tipe event webhook didaftarkan secara terpisah di Berlangganan webhook, dan beberapa namanya berbeda dari nama di stream (misalnya, session.status_idled alih-alih session.status_idle).
| 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 outcome yang akan dikerjakan oleh 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. |
Worker self-hosted
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-poll untuk pekerjaan. Juga dibaca dari ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Mengautentikasi worker dengan environment ini. Juga dibaca dari ANTHROPIC_ENVIRONMENT_KEY. |
--workdir | Direktori tempat skill diunduh dan alat membaca serta menulis file. Default-nya . (direktori saat ini); direktori kerja default sistem adalah /workspace. |
--on-work | Skrip yang dipanggil untuk setiap item pekerjaan yang diklaim alih-alih menjalankan alat dalam proses. Menerima detail sesi sebagai variabel environment. |
--unrestricted-paths | Mengizinkan alat file untuk membaca dan menulis path di luar --workdir. Pemeriksaan workdir adalah pagar pengaman untuk alat file saja, bukan sandbox; pemeriksaan ini tidak membatasi bash. |
--max-idle | Berapa lama menunggu setelah sesi menjadi idle dengan stop reason end_turn sebelum dimatikan. Default-nya 60s. |
--log-format | Format output log. Gunakan json untuk ingesti log terstruktur. Default-nya text. |
Worker CLI tidak me-mount memory store: sesi yang melampirkannya tetap berjalan, tetapi agen tidak menemukan apa pun di mount_path store tersebut dan tidak ada perubahan yang disinkronkan kembali ke store. Untuk menggunakan memory store dalam sesi pada environment self-hosted, jalankan worker SDK sebagai gantinya; lihat Menggunakan memory store.
Tipe server MCP yang didukung
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 deprecated tetap berfungsi melalui fallback otomatis. Lihat Konektor MCP untuk mendeklarasikan server pada agen.
Untuk informasi lebih lanjut tentang MCP dan membangun server MCP, lihat dokumentasi MCP.
Batas laju
Endpoint Managed Agents dikenai "rate limit" (batas laju) 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.
Pedoman branding
Bagi mitra yang mengintegrasikan Claude Managed Agents, penggunaan branding Claude bersifat opsional. Saat mereferensikan Claude dalam produk Anda:
Diizinkan:
- "Claude Agent" (lebih disukai untuk menu dropdown)
- "Claude" (ketika berada dalam menu yang sudah berlabel "Agents")
- "{YourAgentName} Powered by Claude" (jika Anda sudah memiliki nama agen)
Tidak diizinkan:
- "Claude Code" atau "Claude Code Agent"
- "Claude Cowork" atau "Claude Cowork Agent"
- Seni ASCII bermerek Claude Code atau elemen visual yang meniru Claude Code
Produk Anda harus mempertahankan branding-nya sendiri dan tidak tampak sebagai Claude Code, Claude Cowork, atau produk Anthropic lainnya. Untuk pertanyaan tentang kepatuhan branding, hubungi tim penjualan Anthropic.
Was this page helpful?