Ringkasan Agen

Agen terkelola di Gemini API memberi Anda platform agen yang dapat dikonfigurasi. Satu panggilan API menyediakan sandbox Linux tempat agen menganalisis, mengeksekusi kode, mengelola file, dan menjelajahi web secara mandiri.

Agen terkelola yang tersedia

  • Agen antigravitasi: Agen serbaguna yang dikelola dan didukung oleh Gemini 3.5 Flash. Menjalankan kode, mengelola file, dan menelusuri web di dalam sandbox Linux yang aman dan dihosting oleh Google. Anda dapat memperluasnya dengan petunjuk, keterampilan, dan data Anda sendiri untuk membangun agen kustom.
  • Deep Research: Agen riset mandiri yang merencanakan, menjalankan, dan menyintesis tugas riset multi-langkah untuk kasus penggunaan seperti analisis pasar, uji tuntas, dan tinjauan literatur.

Keamanan dan praktik terbaik

Setiap agen berjalan di lingkungan sandbox yang diisolasi di tingkat OS. Sandbox memiliki akses jaringan keluar yang tidak dibatasi secara default. Anda dapat membatasi atau menonaktifkan akses jaringan menggunakan daftar yang diizinkan.

Akses jaringan

Secara default, lingkungan memiliki akses jaringan keluar yang tidak dibatasi. Gunakan daftar yang diizinkan network untuk membatasi traffic keluar ke domain tertentu atau pola wildcard. Untuk mengetahui detail konfigurasi, lihat Daftar yang Diizinkan Jaringan (AI Studio) atau Aturan jaringan (API).

Alat dan API eksternal

Anda dapat menghubungkan alat dan API eksternal untuk memperluas agen. Hanya gunakan alat dari sumber tepercaya dan cakupan izin ke minimum yang diperlukan. Kredensial dapat disuntikkan secara aman melalui transformasi header proxy keluar dan tidak pernah diekspos di dalam sandbox. Agen dapat menggunakan kredensial apa pun yang dapat diaksesnya, jadi hanya berikan kredensial yang cakupan penuhnya bersedia Anda berikan.

  • Gunakan akun layanan atau kunci API dengan hak istimewa terendah.
  • Lebih memilih token jangka pendek daripada kunci jangka panjang.
  • Hanya berikan kredensial yang cakupan penuhnya bersedia Anda berikan.
  • Merotasi kredensial sesuai jadwal rutin.

Untuk mengetahui detail tentang cara mengonfigurasi transformasi header, lihat Kredensial.

Pengawasan manusia

Selalu verifikasi output (kode yang dihasilkan, transformasi data, perubahan konfigurasi) sebelum men-deploy-nya, terutama untuk tugas yang mengubah data atau berinteraksi dengan sistem eksternal.

Harga

Agen terkelola menggunakan model bayar sesuai penggunaan berdasarkan token model Gemini dan penggunaan alat. Satu interaksi dapat memicu beberapa loop penalaran, biasanya menggunakan 100 ribu hingga 3 juta token. Komputasi lingkungan tidak ditagih selama pratinjau. Lihat perkiraan biaya untuk perincian per tugas.

Batas

Batas Deskripsi
Masa Aktif Lingkungan Lingkungan akan dihapus secara permanen setelah 7 hari tidak aktif.
Penonaktifan VM VM dimatikan setelah tidak ada aktivitas selama beberapa saat untuk menghemat resource. Permintaan berikutnya akan memulihkan status (dengan cold start).
Software yang Sudah Diinstal Sebelumnya Lingkungan berbasis Ubuntu dengan Python 3.12 dan Node.js 22. Untuk mengetahui informasi selengkapnya tentang image dasar lingkungan, lihat Software yang telah diinstal sebelumnya.
Agen maksimum Anda dapat memiliki hingga 1.000 agen terkelola.

Framework agen

Anda juga dapat membuat agen dengan Gemini menggunakan framework dan SDK berikut:

  • LangChain / LangGraph: Bangun alur aplikasi yang kompleks dan memiliki status, serta sistem multi-agen menggunakan struktur grafik.
  • LlamaIndex: Hubungkan agen Gemini ke data pribadi Anda untuk alur kerja yang ditingkatkan RAG.
  • CrewAI: Mengatur agen AI otonom yang kolaboratif dan memainkan peran.
  • Vercel AI SDK: Buat antarmuka pengguna dan agen yang didukung AI di JavaScript/TypeScript.
  • Google ADK: Framework open source untuk membangun dan mengatur agen AI yang dapat beroperasi.
  • Antigravity SDK: Bangun agen AI otonom menggunakan alat, loop agen, dan pengelolaan konteks yang sama dengan yang mendukung Google Antigravity, yang dapat diprogram di Python.