Managed AgentsLangkah pertama

Ikhtisar Claude Managed Agents

Copy page



Harness agen siap pakai dan dapat dikonfigurasi yang berjalan di infrastruktur terkelola. Paling cocok untuk tugas yang berjalan lama dan pekerjaan asinkron.

Anthropic menawarkan dua cara untuk membangun dengan Claude, masing-masing cocok untuk kasus penggunaan yang berbeda:

Claude Managed Agents menyediakan harness dan infrastruktur untuk menjalankan Claude sebagai agen otonom. Alih-alih membangun agent loop, eksekusi alat, dan runtime Anda sendiri, Anda mendapatkan lingkungan yang sepenuhnya terkelola tempat Claude dapat membaca file, menjalankan perintah, menjelajahi web, dan menjalankan kode dengan aman. Harness ini mendukung "prompt caching" (caching prompt) bawaan, compaction (pemadatan), dan optimasi performa lainnya untuk output agen yang berkualitas tinggi dan efisien. Untuk membangun agent loop Anda sendiri dengan akses model langsung, lihat Menggunakan Messages API.

Konsep inti

Claude Managed Agents dibangun di atas empat konsep:

Cara kerjanya

1. 1

   Buat agen

   Tentukan model, prompt sistem, alat, server MCP, dan skill. Buat agen sekali dan rujuk berdasarkan ID di berbagai sesi.

2. 2

   Buat environment

   Konfigurasikan tempat agen berjalan: sandbox cloud, atau sandbox self-hosted di infrastruktur Anda sendiri.

3. 3

   Mulai sesi

   Luncurkan sesi yang merujuk pada konfigurasi agen dan environment Anda.

4. 4

   Kirim event dan stream respons

   Kirim pesan pengguna sebagai event. Claude secara otonom menjalankan alat dan melakukan streaming hasilnya kembali melalui "server-sent events" (event yang dikirim server), atau SSE. Riwayat event disimpan di sisi server dan dapat diambil secara lengkap.

5. 5

   Arahkan atau interupsi

   Kirim event pengguna tambahan untuk memandu agen di tengah eksekusi, atau interupsi agen untuk mengubah arah.

Kapan menggunakan Claude Managed Agents

Claude Managed Agents paling cocok untuk beban kerja yang membutuhkan:

• Eksekusi yang berjalan lama: Tugas yang berjalan selama beberapa menit atau jam dengan banyak pemanggilan alat
• Infrastruktur cloud: Sandbox aman dengan paket yang sudah terinstal dan akses jaringan
• Eksekusi self-hosted: Sandbox di infrastruktur yang Anda kendalikan untuk kebutuhan kepatuhan atau residensi data
• Infrastruktur minimal: Tidak perlu membangun agent loop, sandbox, atau lapisan eksekusi alat Anda sendiri
• Sesi stateful: Filesystem dan riwayat percakapan yang persisten di berbagai interaksi
• Eksekusi terjadwal: Menjalankan agen secara berulang dengan jadwal cron melalui deployment terjadwal

Alat yang didukung

Claude Managed Agents memberi Claude akses ke serangkaian alat bawaan:

• Bash: Menjalankan perintah shell di sandbox
• Operasi file: Membaca, menulis, mengedit, glob, dan grep file di sandbox
• Pencarian dan pengambilan web: Mencari di web dan mengambil konten dari URL, secara opsional dibatasi pada allowlist atau blocklist domain
• Server MCP: Terhubung ke penyedia alat eksternal

Lihat Alat untuk daftar lengkap dan opsi konfigurasi.

Akses beta

Untuk memulai, Anda memerlukan:

1. Sebuah kunci API Claude
2. Header beta managed-agents-2026-04-01 pada semua permintaan
3. Akses ke Claude Managed Agents (diaktifkan secara default untuk semua akun API)

Dalam beta ini, MCP tunnels dan dreaming berada dalam pratinjau riset yang lebih terbatas. Minta akses untuk mengaktifkannya.

Claude Managed Agents dirancang bersifat stateful: sesi berjalan lama, dapat dilanjutkan dengan mulus setelah jeda, dan menyimpan riwayat percakapan, status sandbox, serta output di sisi server. Karena itu, Managed Agents saat ini tidak memenuhi syarat untuk Zero Data Retention atau cakupan HIPAA Business Associate Agreement (BAA). Anda tetap memegang kendali atas data ini: Anda dapat menghapus sesi, dan secara terpisah menghapus file apa pun yang Anda unggah, kapan saja melalui API. Untuk kelayakan di seluruh fitur, lihat API dan retensi data.

Lihat Batas laju dan Pedoman branding di referensi.