Perbedaan dari layanan yang di-hosting
Lihat fitur mana yang hanya dimiliki Claude Managed Agents yang di-host sendiri, fitur layanan yang di-hosting mana yang tidak dimilikinya, mana yang berperilaku berbeda, dan mana yang memerlukan pengaturan server terlebih dahulu.
Server Claude Managed Agents yang di-host sendiri memiliki API yang sama dengan layanan Managed Agents yang di-hosting oleh Anthropic, kecuali perbedaan di halaman ini. Tabel-tabel berikut menyebutkan apa yang perlu dilakukan untuk masing-masing. Periksa tabel-tabel tersebut sebelum Anda memindahkan aplikasi ke server Anda. Tidak ada yang disalin dari layanan yang di-hosting, termasuk riwayat sesi. Buat kembali agen, skill, kredensial vault, dan memory store Anda di server Anda.
Fitur yang hanya dimiliki server Anda
| Fitur | Fungsinya | Cara menyiapkannya |
|---|---|---|
| Pilihan penyedia inferensi | Server dapat mengirim panggilan model ke penyedia cloud atau gateway model Anda sendiri sebagai pengganti Claude API. | Penyedia inferensi |
| Single sign-on | Orang memanggil server dengan token dari penyedia identitas OpenID Connect Anda. Server memberikan peran kepada setiap pemanggil berdasarkan grup dalam token. Kunci API server tetap berfungsi. | Single sign-on |
| Pengelola rahasia Anda sendiri | Server dapat menyimpan secret dari setiap kredensial vault baru di secret manager Anda sebagai pengganti database-nya sendiri. | Pengelola rahasia |
| Identitas agen | Server dapat menandatangani token berumur pendek dan mengirimkannya bersama panggilan agen ke server MCP. Server MCP atau gateway memeriksa token tersebut terhadap kunci publik yang Anda publikasikan. | Identitas agen |
Fitur yang tidak tersedia
| Fitur | Apa yang terjadi | Apa yang dilakukan sebagai gantinya |
|---|---|---|
| Environment cloud | Hanya environment self_hosted yang ada. Permintaan untuk environment cloud mengembalikan error 400. | Deploy worker yang di-host sendiri untuk setiap environment. |
| Bagian lain dari Claude API, seperti Messages API dan Models API | Server tidak melayaninya. Panggilan SDK ke /v1/messages dan /v1/models mengembalikan error 404. | Kirim permintaan tersebut ke Claude API atau ke penyedia Anda, dari klien yang tidak diarahkan ke server Anda. |
| Resource sesi File dan Files API | Server menolak resource file, dan /v1/files tidak ada. Resource memory_store berfungsi. | Letakkan file di direktori kerja worker. Lihat Memindahkan data masuk dan keluar dari sesi. Untuk menunjukkan gambar atau PDF kepada model, kirimkan sebagai base64 dalam sebuah pesan. |
Kredensial vault mcp_oauth | Server menolaknya saat Anda membuatnya, karena server tidak memiliki alur OAuth untuk memperbarui token. | Simpan token sebagai kredensial static_bearer. Perbarui kredensial dengan token baru sebelum token lama kedaluwarsa. |
Skill bawaan docx, pdf, pptx, dan xlsx | Server menolak agen yang mendeklarasikannya. Hanya skill yang Anda unggah yang ada. | Unduh sumbernya dari repositori skill dan unggah sebagai skill kustom. |
| Deployment terjadwal dan dreams | Server tidak memiliki rute untuk keduanya. | Mulai sesi dari penjadwal Anda sendiri, seperti cron job. Dreams tidak memiliki pengganti. |
| Webhook | Server tidak mengirim webhook, sehingga worker yang dimulai oleh webhook tidak pernah dimulai. | Ikuti sesi melalui aliran event-nya, atau tampilkan daftar event-nya. Biarkan worker Anda tetap berjalan agar dapat melakukan polling. |
Fitur yang berperilaku berbeda
| Fitur | Apa yang berbeda | Apa yang dilakukan |
|---|---|---|
| Claude Console | Claude Console di platform.claude.com tidak menampilkan apa yang ada di server Anda. | Gunakan konsol di server Anda. |
| Panggilan alat | Giliran model dalam sesi tetap berjalan meskipun tidak ada worker yang melakukan polling pada environment-nya. Panggilan alat pertama kemudian menunggu, tanpa error, hingga sebuah worker menjalankannya. | Jika sesi berhenti pada panggilan alat, periksa apakah ada worker yang melakukan polling pada environment-nya. |
| Memory store | API-nya lengkap. Worker, bukan server, yang menyalin setiap store yang terlampir ke dalam sandbox dan menulis kembali perubahannya. Lihat Memory store di sandbox self-hosted. | Jalankan worker Anda pada versi terbaru ant, dengan direktori /mnt/memory yang dapat ditulis. |
| Unggahan skill kustom | Server tidak mengekstrak arsip zip. Unggahan arsip zip mengembalikan error 400 yang menyatakan SKILL.md not found in uploaded files. | ant apply dan helper files_from_dir dari Python SDK berfungsi apa adanya. Dengan cara lain, unggah file-file skill sebagai bagian terpisah, dan awali nama file setiap bagian dengan folder skill, seperti pada my-skill/SKILL.md. |
| Orkestrasi multiagen | Agen hanya dapat mendelegasikan ke subagen yang Anda cantumkan. Alur kerja dinamis, advisor, dan subagen yang didefinisikan sendiri oleh agen tidak tersedia. Server menerima blok multiagent hanya jika type bernilai coordinator. Contoh-contoh di Orkestrasi multiagen mengatur type ke multiagent_20261001, yang mengembalikan error 400. Blok yang memiliki pengaturan advisor juga mengembalikan error 400. | Atur multiagent ke {"type": "coordinator", "agents": [...]}. Cantumkan 1 hingga 20 agen di agents. Setiap entri menggunakan salah satu bentuk agen yang telah ditentukan. |
| Resource sesi repositori GitHub | Server menolak resource github_repository sampai Anda mencantumkan host Git-nya dalam pengaturan server. Server tidak menemukan skill di direktori .claude/skills milik repositori, jadi lampirkan skill ke agen. | Lihat Repositori Git memerlukan entri allowlist. |
| Server MCP | Server hanya terhubung ke host MCP yang Anda cantumkan dalam pengaturannya. | Lihat Server MCP memerlukan entri allowlist. |
| Alat web | Alat web_search dan web_fetch nonaktif sampai Anda mengaktifkannya dalam pengaturan server. | Lihat Alat web memerlukan pengaturan server. |
Kredensial vault environment_variable | Server menolaknya sampai Anda mengaktifkan egress gateway, sebuah proxy di antara sandbox Anda dan internet. | Lihat Kredensial variabel environment. Tanpa gateway, berikan sandbox Anda kredensial CLI dan API yang dibutuhkannya melalui tooling Anda sendiri. |
| Hasil alat kustom | Server mengirimkan seluruh teks hasil alat kustom kepada model. Jika hasil terlalu besar untuk “context window” (jendela konteks) model, server tetap menjawab dengan 200, lalu sesi berakhir dengan session.error. | Persingkat hasil yang panjang di klien Anda sebelum mengirimkannya. |
| Hasil alat MCP | Server memotong hasil yang lebih besar dari pengaturan mcp.max_result_bytes miliknya, yang secara default adalah 100 KiB. Server memberi tahu model bahwa hasil tersebut dipotong, dan sisanya hilang. Layanan yang di-hosting juga memotong hasil yang panjang, tetapi dapat menyimpan hasil lengkap ke file untuk sesi di sandbox cloud. | Untuk mengubah batasnya, atur mcp.max_result_bytes di file pengaturan. |
| Gambar dan dokumen yang dikirim melalui URL | Server menerima blok image atau document dengan sumber url, tetapi model tidak pernah melihatnya, dan tidak ada error. Hal yang sama terjadi pada blok image dengan sumber file. | Kirim data sebagai base64, atau sebagai text untuk dokumen. |
Status sesi rescheduling | Server mencoba ulang panggilan model yang gagal karena alasan sementara dan melaporkan setiap percobaan di aliran event, seperti yang dilakukan layanan yang di-hosting. Status sesi tetap running di antara percobaan, sehingga filter statuses[]=rescheduling tidak cocok dengan sesi mana pun. | Baca percobaan ulang dari aliran event. |
| Metadata sesi, dengan gateway model | Jika pengaturan inference.credentials.assertion.forward_metadata server mencantumkan kunci metadata sesi, pembaruan yang menambah, menghapus, atau mengubah salah satunya mengembalikan error 400. | Atur kunci-kunci tersebut saat Anda membuat sesi. Untuk pengaturannya, lihat Token gateway berumur pendek. |
Fitur yang memerlukan pengaturan server
Masing-masing fitur ini nonaktif, atau menolak setiap host, sampai Anda mengubah file pengaturan server.
Server MCP memerlukan entri allowlist
Server hanya terhubung ke server MCP yang host-nya Anda cantumkan di bawah mcp.allowed_hostnames dalam file pengaturan-nya:
mcp:
allowed_hostnames:
- mcp.example.comHost dicocokkan secara persis, tanpa wildcard dan tanpa subdomain, dan daftarnya kosong secara default. Sampai host server MCP ada dalam daftar, server Anda menolak menyimpan agen yang menyebutkannya.
Server MCP di dalam jaringan privat Anda tidak memerlukan tunnel MCP. Masukkan URL-nya ke dalam definisi agen, seperti yang dijelaskan di Konektor MCP, dan tambahkan host-nya ke allowlist. Dua aturan berlaku untuk URL tersebut:
- URL harus menggunakan
https, kecuali server MCP berada di alamat loopback. - Jika host-nya adalah nama yang hanya ter-resolve ke alamat privat atau yang dicadangkan, server Anda menolak untuk terhubung secara default. Pilih perbaikan yang sesuai dengan kasus Anda:
| Kasus Anda | Perbaikan |
|---|---|
Alamatnya berada di 10.0.0.0/8, 172.16.0.0/12, atau 192.168.0.0/16, dan Anda mengendalikan catatan DNS nama tersebut | Pertahankan nama tersebut, dan cantumkan juga nama itu di bawah mcp.private_hostnames dalam file pengaturan. |
| Kasus lainnya | Gunakan alamat IP sebagai ganti nama, di URL dan di allowlist. Sertifikat server MCP harus mencantumkan alamat tersebut. |
Repositori Git memerlukan entri allowlist
Di layanan yang di-hosting, sesi yang menggunakan sandbox yang di-host sendiri tidak dapat memiliki resource github_repository. Di server Anda, sesi dapat memilikinya. Server menolak resource ini sampai Anda mencantumkan host Git-nya dalam file pengaturan-nya. Agen hanya dapat melakukan push ke branch yang Anda cantumkan:
git:
allowed_hostnames:
- github.com
allowed_push_refs:
- refs/heads/agent/Perhatikan poin-poin berikut:
- URL: Host tidak harus
github.com, tetapi URL harus menggunakan HTTPS. - Token: Token yang dikirim klien Anda tidak pernah mencapai sandbox, karena lalu lintas Git melewati server Anda, yang menambahkan token tersebut.
- Branch: Agen tidak diberi tahu daftar branch, jadi sebutkan sebuah branch dalam prompt Anda.
- Force push: Server tidak menolak force push, sehingga agen dapat menimpa branch mana pun yang Anda cantumkan. Untuk menolak force push, lindungi branch tersebut di host Git Anda.
Mengakses GitHub menunjukkan permintaannya dan cara merotasi token. Jika clone gagal, sesi menerima event session.error yang menyebutkan penyebabnya. Untuk memeriksa push, cari branch tersebut di host Git Anda. Log server menyatakan ok bahkan untuk push yang ditolak oleh host Anda.
Alat web memerlukan pengaturan server
Alat web_search dan web_fetch nonaktif secara default. Untuk mengaktifkannya, tambahkan ini ke file pengaturan server:
web_tools:
enabled: trueDengan pengaturan ini saja, daftar domain dan batas konten milik masing-masing agen yang berlaku, seperti pada layanan yang di-hosting.
Untuk membatasi alat tersebut bagi setiap agen, atur web_tools.allowed_domains, web_tools.blocked_domains, atau web_tools.max_content_tokens. Masing-masing pengaturan ini juga mengaktifkan alat tersebut. Server menolak menyimpan agen yang meminta lebih dari yang diizinkan pengaturan ini. Misalnya, server menolak agen yang mengizinkan domain di luar web_tools.allowed_domains, atau yang mengatur batas konten yang lebih besar. Jika agen seperti itu sudah ada, agen tersebut tidak dapat memulai sesi hingga Anda memperbaruinya.
Selama alat tersebut nonaktif, apa yang terjadi pada agen bergantung pada entri web_search dan web_fetch dalam toolset-nya:
| Toolset memiliki | Apa yang terjadi |
|---|---|
| Tidak ada entri untuk kedua alat tersebut | Agen berjalan tanpa alat tersebut, dan tidak ada error yang memberitahukannya. |
Entri yang hanya menonaktifkan alatnya, seperti {"name": "web_fetch", "enabled": false} | Sama. |
| Entri yang membiarkan alatnya aktif, atau yang mengatur daftar domain, batas konten, atau lokasinya | Server menolak menyimpan agen, atau memulai sesi untuknya. |
Alat web mana yang tersedia juga bergantung pada penyedia inferensi Anda.
Perbedaan yang bergantung pada penyedia inferensi Anda
Beberapa fitur hanya berfungsi pada nilai tertentu dari pengaturan inference.provider server. Tabel menunjukkan apa yang terjadi pada nilai lainnya. Beberapa kasus ini tidak mengembalikan error.
Baris web_search dan web_fetch berlaku setelah Anda mengaktifkan alat web. Sampai saat itu, kedua alat tersebut tidak berfungsi pada penyedia mana pun.
| Fitur | Berfungsi saat inference.provider adalah | Pada nilai lainnya | Apa yang dilakukan |
|---|---|---|---|
Alat web_search | anthropic, vertex, foundry | Server tidak pernah menawarkan alat tersebut kepada model. Agen tetap dapat disimpan dan dijalankan, dan tetap mencantumkan alat tersebut, tetapi model tidak dapat memanggilnya. | Berikan agen alat kustom atau server MCP yang melakukan pencarian. |
Alat web_fetch | anthropic, foundry | Sama seperti untuk web_search. | Berikan agen alat kustom atau server MCP yang mengambil halaman. |
inference_geo | anthropic | Server menolak menyimpan agen yang mengaturnya. | Hapus inference_geo dari agen. |
Mode cepat (speed: "fast") | Bergantung pada penyedia dan pada model agen | Agen yang mengaturnya harus lolos dua pemeriksaan. Saat Anda menyimpan agen: Katalog model server harus mencantumkan model agen sebagai model yang menerima mode cepat. Jika tidak, server menolak menyimpan agen tersebut. Pada setiap giliran: Jika penyedia tidak melayani mode cepat untuk model atau deployment tersebut, giliran berakhir dengan error. | Hapus speed dari agen. Lihat Model yang menerima mode cepat. |
Di bawah anthropic, server meminta fallback sisi server dari Claude API secara default. Ketika pengklasifikasi keamanan menolak sebuah permintaan, model Claude lain, yang mungkin kurang mampu, kemudian dapat menjawabnya. Anthropic memilih modelnya, dan tidak ada event yang melaporkan perubahan tersebut, tetapi pembacaan sesi menunjukkan ID model tersebut. Untuk menonaktifkan fallback, atur inference.model_fallback: false. Di bawah penyedia lainnya, permintaan seperti itu mengakhiri giliran dengan penolakan.
Dokumentasi penyedia Anda menyebutkan model dan region mana yang mendukung setiap fitur. Alat kustom, alat MCP, dan alat yang dijalankan oleh worker Anda sama di semua penyedia.
Model yang menerima mode cepat
Secara default, katalog model server mencantumkan empat model sebagai model yang menerima mode cepat: Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, dan Claude Opus 4.6. Pada Claude Opus 4.6, Claude API menerima permintaan tersebut tetapi menjalankannya pada kecepatan standar. Nilai inference.provider berikut merupakan pengecualian:
foundry: Katalog hanya mencantumkan Claude Opus 5.5.gatewaydenganformat: vertex-raw-predict: Katalog tidak mencantumkan model apa pun.vertex: Katalog tidak mencantumkan model apa pun, dan tidak ada pengaturan yang dapat mengubahnya.
Untuk mengubah apa yang dicantumkan katalog, lihat Entri model.
Jika Anda sudah menjalankan sandbox yang di-host sendiri
Perangkat lunak worker-nya sama, sehingga worker Anda dapat terhubung ke server Anda. Menjalankan worker Anda sendiri mencantumkan tiga nilai untuk proses yang melakukan polling, dan apa yang perlu diubah terlebih dahulu. Worker yang dimulai oleh webhook tidak berfungsi di sini.
Apakah halaman ini membantu?