Managed Agents API di Agent Platform memungkinkan Anda membangun agen otonom terkelola dengan satu panggilan API. Didukung oleh harness Antigravity, setiap agen berjalan dengan lingkungan sandbox tempat agen tersebut melakukan penalaran, perencanaan, menggunakan keterampilan agen, mengeksekusi kode, menelusuri web, serta membaca dan menulis file.
Arsitektur sistem
Managed Agents API di Agent Platform memanfaatkan dua antarmuka utama:
| API | Deskripsi |
|---|---|
| Agents API | Bidang kontrol untuk mengelola agen. Gunakan alat ini untuk membuat agen dari konfigurasi dan mengonfigurasi lingkungan eksekusinya, termasuk memasang sumber data eksternal dan menentukan daftar yang diizinkan jaringan. Sistem menerapkan konfigurasi ini ke lingkungan eksekusi sandbox agen. Menghubungkan sumber data dan alat eksternal memerlukan autentikasi, dengan batasan yang dijelaskan dalam Keamanan dan praktik terbaik. |
| Interactions API | Ini adalah bidang data, yang berfungsi sebagai antarmuka utama untuk berkomunikasi dan berinteraksi dengan agen yang di-deploy saat runtime. Alat ini terhubung ke agen yang dibuat menggunakan agents API. |
Untuk meningkatkan keamanan, setiap agen beroperasi dengan lingkungan sandbox yang terisolasi. Saat Anda menyesuaikan lingkungan dengan sumber eksternal, seperti Cloud Storage, sistem akan memuat file ini langsung ke sistem file container sesuai permintaan, dan agen dapat menulis hasilnya kembali ke Cloud Storage. Untuk mengetahui informasi selengkapnya, lihat Managed Agents API di referensi lingkungan sandbox Agent Platform.
Keamanan dan praktik terbaik
Secara default, setiap agen melakukan tindakan di lingkungan sandbox tanpa akses ke sistem, jaringan, atau kredensial eksternal. Agen hanya dapat berinteraksi dengan file, paket, dan data di dalam sandbox-nya sendiri.
Artinya, secara default, agen tidak dapat melakukan panggilan jaringan, mengakses database, atau menjangkau infrastruktur produksi Anda.
Konektivitas apa pun di luar sandbox harus dikonfigurasi secara eksplisit oleh Anda, developer. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi akses jaringan.
Akses jaringan
Hanya aktifkan ini jika kasus penggunaan Anda memerlukannya, dan batasi akses sesempit mungkin.
Saat Anda mengaktifkan akses jaringan untuk lingkungan, agen dapat menjangkau API eksternal, meng-clone repositori publik, dan mendownload paket. Sebelum mengaktifkan akses jaringan, pertimbangkan hal berikut:
- Hindari mengekspos endpoint sensitif. Jangan arahkan agen ke layanan internal, panel admin, atau database kecuali Anda telah meninjau risikonya dan siap memantau aktivitas agen.
- Tinjau tindakan agen. Saat akses jaringan diaktifkan, pantau interaksi agen—terutama selama pengembangan awal—untuk memverifikasi bahwa agen hanya mengakses resource yang Anda inginkan.
Praktik terbaik kredensial
Jika alur kerja Anda mengharuskan agen melakukan autentikasi dengan layanan eksternal, seperti server MCP, Anda bertanggung jawab untuk menyediakan dan menentukan cakupan kredensial tersebut. Ikuti panduan berikut untuk mengurangi risiko:
- Gunakan kredensial dengan hak istimewa terendah. Buat akun layanan atau kunci API hanya dengan izin yang diperlukan agen Anda. Hindari meneruskan kredensial dengan akses administratif atau akses luas.
- Pilih token berumur pendek. Jika memungkinkan, gunakan kredensial atau token berbatas waktu yang akan habis masa berlakunya, bukan kunci API yang berumur panjang.
- Jangan pernah meneruskan kredensial yang tidak ingin Anda gunakan oleh agen. Agen dapat menggunakan kredensial apa pun yang dapat diaksesnya untuk menyelesaikan tugas yang Anda berikan. Hanya berikan kredensial yang cakupan akses penuhnya ingin Anda berikan.
- Rotasi kredensial secara rutin. Perlakukan kredensial yang dibagikan kepada agen dengan cara yang sama seperti Anda memperlakukan kredensial terprogram—rotasi kredensial tersebut sesuai jadwal rutin.
Menghubungkan alat dan API eksternal
Agents API mendukung koneksi alat dan API eksternal (seperti server MCP) untuk memperluas kemampuan agen. Saat melakukannya:
- Evaluasi sumber alat dengan cermat. Hanya hubungkan alat dari sumber yang Anda percayai. Alat yang berbahaya atau ditulis dengan buruk dapat mengekspos data atau melakukan tindakan yang tidak diinginkan.
- Membatasi izin alat. Konfigurasikan alat dengan izin minimum yang diperlukan untuk kasus penggunaan Anda. Jika alat mendukung mode hanya baca, gunakan mode tersebut, kecuali jika akses tulis diperlukan.
- Lakukan pengujian secara terpisah terlebih dahulu. Sebelum menghubungkan alat ke sumber data produksi, uji alat tersebut dengan data sampel atau sintetis untuk memverifikasi bahwa agen menggunakannya seperti yang diharapkan.
Pengawasan manusia
Agen dapat menalar, merencanakan, dan mengeksekusi alur kerja multilangkah dengan tingkat otonomi yang tinggi. Meskipun kemampuan ini sangat bermanfaat, Anda juga harus menerapkan pengawasan yang tepat, terutama untuk tugas yang mengubah data atau berinteraksi dengan sistem eksternal.
Selalu verifikasi output penting—seperti kode yang dihasilkan, transformasi data, atau perubahan konfigurasi—sebelum men-deploy-nya.
Dukungan dan masukan
Kirim email ke grup diskusi publik di
managed-agents-in-agent-platform@google.com untuk mendapatkan dukungan dan memberikan masukan tentang
Managed Agents API di Agent Platform.
Langkah berikutnya
Membuat dan mengelola agen
Pelajari cara membuat, memperbarui, mencantumkan, mendapatkan, dan menghapus agen menggunakan REST API.
Managed Agents API di lingkungan sandbox Agent Platform
Pelajari container sandbox yang terisolasi, izin, dan paket/alat yang telah diinstal sebelumnya.
Mengevaluasi agen
Pelajari cara mengevaluasi agen yang dibuat dengan Managed Agents API menggunakan Layanan Evaluasi AI Generatif.