Mengonfigurasi setelan alat developer AI

Gunakan halaman setelan alat developer AI di Gemini Enterprise untuk mengonfigurasi alat developer, menerapkan kontrol keamanan dan kepatuhan, mengaktifkan atau menonaktifkan fitur Google Antigravity, dan mengelola ketersediaan model untuk organisasi Anda.

Sebelum memulai

Pastikan Anda memiliki:

  • Akun Penagihan Cloud dengan invoice: Untuk menggunakan alat developer AI, project Anda harus mengaktifkan Penagihan Cloud. Alat developer AI hanya tersedia untuk akun dengan invoice. Untuk mengetahui informasi selengkapnya, lihat Jenis akun Penagihan Cloud.

  • Edisi yang didukung: Untuk mengakses alat developer AI, pengguna harus memiliki langganan ke edisi Gemini Enterprise Standard, Plus, Standard Emerging Market, atau Bayar sesuai penggunaan.

  • Wilayah yang didukung: Untuk mengetahui informasi selengkapnya tentang ketersediaan regional dan batasan fitur, lihat Residensi data untuk Gemini Enterprise Edisi Standard dan Plus serta Gemini Notebook.

  • Peran yang diperlukan: Anda harus memiliki peran Admin Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) untuk mengonfigurasi setelan alat developer AI.

  • API yang Diperlukan: Project Anda harus mengaktifkan API berikut:

    • Discovery Engine API (discoveryengine.googleapis.com): Menyediakan layanan platform inti, kontrol keamanan dan kepatuhan, serta pengelolaan setelan untuk Gemini Enterprise.

    • Business AI Code API (businessaicode.googleapis.com): Menyediakan pembuatan kode yang didukung AI untuk Antigravity di Gemini Enterprise. Anda harus mengaktifkan API ini di project Anda agar akun utama yang diberi otorisasi dapat menjangkau layanan dari project Anda.

    Saat Anda mengaktifkan tombol Alat developer AI di konsol Google Cloud , sistem akan memeriksa konfigurasi project Anda dan otomatis mengaktifkan API yang diperlukan ini jika Anda belum mengaktifkannya.

Mengaktifkan alat developer AI

Ketersediaan alat developer AI bergantung pada jenis langganan Gemini Enterprise Anda:

  • Langganan Standard, Plus, atau Bayar sesuai penggunaan baru: Alat developer AI diaktifkan secara default di lokasi tempat Anda membeli langganan jika didukung untuk lokasi atau wilayah tersebut.

  • Langganan yang ada: Administrator harus mengaktifkan alat developer AI secara manual di konsol Google Cloud untuk setiap lokasi guna mengaktifkan alat bagi pengguna berlisensi.

Untuk mengaktifkan alat developer AI secara manual untuk langganan Gemini Enterprise yang ada, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka Gemini Enterprise.

    Buka Gemini Enterprise

  2. Klik Settings, lalu pilih tab AI developer tools.

  3. Aktifkan tombol Alat developer AI.

  4. Konfigurasikan setelan di bagian Security, Compliance, Features, dan Model availability.

Mengonfigurasikan setelan keamanan

Sebagai administrator, Anda dapat mencegah eksposur data yang tidak sah di seluruh antarmuka developer. Gunakan setelan di bagian ini untuk membatasi akses ke sumber eksternal dan mengelola izin eksekusi otomatis. Misalnya, Anda dapat menerapkan kebijakan keamanan wajib untuk mencegah pengguna mengganti aturan keamanan, dan mewajibkan persetujuan sebelum agen AI menjalankan perintah terminal atau memilih link.

Mengelola kebijakan keamanan

Anda dapat mengonfigurasi kebijakan keamanan untuk mengontrol cara agen AI mengakses file lokal di luar folder kerjanya dan menjalankan perintah terminal di ruang kerja developer.

Setelan Deskripsi Status default
Di luar kebijakan akses file Tentukan tingkat izin agen untuk mengakses file di luar folder kerja yang ditetapkan. Tersedia opsi-opsi berikut:
  • Deny: Mencegah agen mengakses file di luar folder kerjanya.
  • Selalu tanya: Meminta izin pengguna sebelum agen mengakses file di luar folder kerjanya.
  • Allow: Mengizinkan agen mengakses file di luar folder kerjanya tanpa meminta konfirmasi.
 Tolak
Mode eksekusi otomatis terminal Aktifkan setelan ini agar agen dapat menjalankan perintah terminal secara otomatis untuk menyederhanakan alur kerja multilangkah. Tersedia opsi-opsi berikut:
  • Memerlukan peninjauan: Meminta persetujuan pengguna sebelum menjalankan perintah terminal apa pun.
  • Lanjutkan di sandbox: Otomatis menjalankan perintah di lingkungan yang aman dan terisolasi.
  • Always proceed: Otomatis menjalankan perintah di lingkungan saat ini tanpa meminta konfirmasi.
 Selalu lanjutkan
Mode sandbox Aktifkan setelan ini untuk membatasi alat agen ke sandbox lokal yang aman dan terisolasi. Nonaktif

Mengelola akses web eksternal

Jika kebijakan keamanan Anda mengharuskan kontrol akses agen ke situs eksternal untuk mencegah pemindahan data yang tidak sah, setelan ini memungkinkan Anda membatasi akses browser atau membatasinya ke daftar URL yang diizinkan.

Setelan Deskripsi Status default
Akses browser Aktifkan setelan ini untuk mengontrol akses web eksternal. Hal ini mencegah pemindahan data yang tidak sah dan menentukan batasan organisasi. Nonaktif
URL yang Diizinkan Tentukan daftar URL yang diizinkan yang dapat diakses agen di browser. Jika dikonfigurasi, sistem akan memblokir semua URL lainnya.

Setelan ini hanya berlaku untuk agen browser Antigravity. Anda dapat menjalankan agen browser di Antigravity dengan mengetik perintah /browser di kolom chat.

 Tidak ada. Secara default, tidak ada URL yang diblokir.
Mode eksekusi otomatis JavaScript browser Aktifkan setelan ini agar agen dapat menjalankan JavaScript untuk mendukung tugas coding dan pengujian lanjutan berbasis web. Tersedia opsi-opsi berikut:
  • Nonaktif: Mencegah agen menjalankan JavaScript.
  • Minta peninjauan: Meminta persetujuan pengguna sebelum agen menjalankan JavaScript.
  • Diizinkan: Mengizinkan agen menjalankan JavaScript secara otomatis.
 Nonaktif

Mengelola Model Context Protocol (MCP)

Anda dapat mengonfigurasi akses ke server Model Context Protocol (MCP), yang memungkinkan agen AI mengakses sumber data dan alat tambahan dengan aman.

Setelan Deskripsi Status default
Server MCP Aktifkan setelan ini untuk mengelola akses ke server Model Context Protocol (MCP) guna memperluas konteks data AI dengan aman.

MCP diperlukan untuk menggunakan IDE yang mendukung Agent Client Protocol (ACP), seperti Android Studio dan IDE JetBrains. Di lingkungan ini, kontrol administrator beroperasi berdasarkan upaya terbaik karena IDE dapat memasukkan alat MCP-nya sendiri yang tidak tunduk pada penegakan.

Nonaktif
Konfigurasi server yang diizinkan Setelan ini memungkinkan administrator menentukan konfigurasi server tertentu untuk akses server MCP. Administrator menentukan daftar yang diizinkan sebagai objek JSON dengan konfigurasi untuk server MCP lokal dan jarak jauh. UI menyediakan validasi real-time untuk kolom berikut:
  • Server MCP lokal (local_servers):
    • id (string): ID unik server MCP.
    • command (string, opsional): Perintah untuk menjalankan server MCP lokal. Jika ditentukan, setelan ini akan menggantikan konfigurasi lokal pengguna.
    • args (array string, opsional): Argumen yang diteruskan ke perintah. Jika ditentukan, setelan ini akan menggantikan konfigurasi lokal pengguna.
  • Server MCP jarak jauh (remote_servers):
    • id (string): ID unik server MCP.
    • url (string, opsional): URL endpoint server MCP jarak jauh. Diperlukan untuk server jarak jauh kustom dan opsional untuk server jarak jauh yang telah dikonfigurasi sebelumnya.

Contoh konfigurasi

{
  "mcpServers": {
    "local_servers": [
      {
        "id": "gopls-mcp-server",
        "command": "go",
        "args": [
          "run",
          "golang.org/x/tools/gopls@latest",
          "mcp"
        ]
      }
    ],
    "remote_servers": [
      {
        "id": "bigquery"
      },
      {
        "id": "custom-remote-server",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  }
}
Tidak dikonfigurasi

Mengonfigurasi setelan kepatuhan

Jika organisasi Anda beroperasi di industri yang diatur atau memiliki kebijakan internal tertentu, Anda mungkin perlu menyimpan log audit interaksi AI untuk kepatuhan. Setelan di bagian ini memungkinkan Anda mengonfigurasi kebijakan logging dan retensi data untuk memenuhi persyaratan hukum dan peraturan.

Setelan Deskripsi Status default
Logging perintah dan respons Aktifkan setelan ini untuk mencatat interaksi antara developer dan AI guna menghitung metrik penggunaan dan mempertahankan jejak audit untuk peninjauan keamanan. Sistem menyimpan log dengan aman dalam project organisasi Anda, dan Google tidak pernah mengakses log untuk pelatihan model atau peninjauan manual. Nonaktif
Logging metadata Aktifkan setelan ini untuk mencatat metadata produk guna membantu Anda melacak penggunaan dan analisis di seluruh organisasi, termasuk konsumsi token model pihak ketiga. Sistem menyimpan log dengan aman dalam project organisasi Anda, dan Google tidak pernah mengakses log untuk pelatihan model atau peninjauan manual. Nonaktif

Mengonfigurasi setelan fitur

Beberapa fitur Antigravity menawarkan kemampuan multi-agen tingkat lanjut untuk membantu developer menangani tugas-tugas kompleks. Karena fitur ini dapat meningkatkan penggunaan dan biaya token, gunakan setelan di bagian ini untuk mengontrol akses bagi pengguna di organisasi Anda. Untuk mengakses fitur yang diaktifkan, pengguna harus menggunakan aplikasi Antigravity versi 2.18.0 atau yang lebih baru, atau Antigravity CLI versi 1.2.10 atau yang lebih baru.

Untuk mengaktifkan atau menonaktifkan fitur, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka Gemini Enterprise.

    Gemini Enterprise

  2. Klik Settings, lalu pilih tab AI developer tools.

  3. Di bagian Features, klik Edit.

  4. Untuk setiap fitur, aktifkan atau nonaktifkan tombol.

    Setelan Deskripsi Status default
    /boost perintah Aktifkan setelan ini agar pengguna dapat menjalankan hierarki multi-agen bertingkat untuk menyelesaikan tantangan algoritma yang kompleks dan tugas proses debug yang mendalam. Untuk mengetahui informasi selengkapnya, lihat Meningkatkan penalaran mendalam. Aktif
    /teamwork-preview perintah Aktifkan setelan ini agar pengguna dapat men-deploy framework terkoordinasi dari subagen otonom untuk menjalankan project berskala besar dan jangka panjang (Pratinjau). Untuk mengetahui informasi selengkapnya, lihat Tim agen Teamwork. Aktif

  5. Klik Simpan.

Mengonfigurasi ketersediaan model

Gunakan setelan di bagian ini untuk mengizinkan model AI tertentu dan mengelola tingkat akses. Hal ini memastikan developer hanya menggunakan model AI yang mematuhi kebijakan keamanan dan penggunaan organisasi Anda. Misalnya, Anda dapat memberi developer akses ke model pratinjau untuk eksperimen, atau membatasi alat agar hanya menggunakan model yang diizinkan.

Pertimbangan utama sebelum mengonfigurasi model

Sebelum Anda mengonfigurasi model, pertimbangkan hal berikut:

  • Penyelarasan kebijakan: Mengaktifkan model di Gemini Enterprise tidak akan menggantikan kebijakan organisasi Gemini Enterprise Agent Platform. Untuk mencegah kegagalan permintaan bayar sesuai penggunaan yang melebihi kuota standar, pastikan model yang diizinkan cocok di kedua platform.

  • Residensi data: Model pratinjau dan model Gemini 3 Pro Image hanya tersedia di region global. Oleh karena itu, model ini tidak mendukung komitmen pemrosesan regional residensi data (DRZ) atau machine learning (ML) di multi-region AS atau Uni Eropa.

  • Inferensi model dan penanganan data pihak ketiga: Model pihak ketiga hanya tersedia setelah administrator mengaktifkannya dan menyetujui persyaratan penyedia. Saat developer memilih model pihak ketiga yang diaktifkan, Gemini Enterprise akan mengirimkan perintah dan konteks kode yang diperlukan untuk permintaan tersebut ke model, dengan pemrosesan dan perlindungan yang sama seperti model Gemini. Perintah dan respons tidak digunakan untuk melatih model. Inferensi model pihak ketiga tersedia di lokasi global, us, dan eu. Wilayah dalam negara tidak didukung. Untuk melihat daftar negara dan wilayah yang dapat mengakses model, lihat Negara dan wilayah yang didukung Anthropic. Untuk mengetahui informasi selengkapnya tentang residensi data, lihat Residensi data untuk Gemini Enterprise Standard dan Edisi Plus serta Gemini Notebook.

  • Pengungkapan eksekusi dan penagihan hybrid: Model Gemini menggunakan kredit kursi edisi gabungan organisasi Anda, sedangkan model pihak ketiga yang diaktifkan administrator ditagih sebagai penggunaan bayar sesuai penggunaan di akun Penagihan Cloud Anda. Saat developer memilih model pihak ketiga yang diaktifkan (seperti Anthropic Claude Opus 5.5 atau Anthropic Claude Sonnet 5.5) untuk tugas penalaran, perencanaan, orkestrasi alat, dan pembuatan kode utama, Antigravity terus menggunakan model Gemini ringan di latar belakang untuk koordinasi sisi klien—seperti pengelolaan konteks dan ringkasan—serta Gemini 3 Pro Image untuk pembuatan gambar. Penggunaan model ini dapat dikenai biaya. Untuk mengetahui informasi selengkapnya, lihat Kuota dan kelebihan penggunaan serta Melacak penggunaan token model pihak ketiga.

Mengonfigurasi model yang diizinkan

Anda dapat mengonfigurasi model yang diizinkan untuk mengontrol model AI mana yang tersedia untuk alat developer AI Anda.

Setelan Model yang diizinkan Antigravity beroperasi sebagai daftar yang diizinkan:

  • Pilihan default (kosong): Jika kolom kosong, semua model Gemini yang didukung akan diizinkan. Model Googleyang baru dirilis akan otomatis tersedia bagi pengguna berlisensi.
  • Daftar model kustom: Jika Anda memilih satu atau beberapa model tertentu, hanya model yang dipilih yang diizinkan. Model yang tidak dipilih dan model yang baru dirilis tidak tersedia untuk developer hingga administrator memilihnya secara manual.

Untuk mengonfigurasi model yang diizinkan:

  1. Di konsol Google Cloud , buka Gemini Enterprise.

    Buka Gemini Enterprise

  2. Klik Settings, lalu pilih tab AI developer tools.

  3. Di bagian Ketersediaan model, klik Edit.

  4. Di kolom Antigravity authorized models, pilih model yang ingin Anda izinkan. Untuk mengizinkan semua model yang didukung, biarkan kolom tetap kosong.

  5. Klik Simpan.

Setelan Deskripsi Status default
Model resmi Antigravity Tentukan model AI yang diizinkan untuk digunakan oleh alat Antigravity dalam project. Kosongkan kolom ini untuk mengizinkan semua model Gemini yang didukung. Jika Anda menentukan daftar model kustom, setelan ini akan bertindak sebagai daftar yang diizinkan, dan model yang baru dirilis atau tidak dipilih harus ditambahkan secara manual agar tersedia. Selain model Gemini yang dibuat oleh Google, administrator dapat memilih untuk mengaktifkan model pihak ketiga, termasuk Anthropic Claude Opus 5.5 dan Anthropic Claude Sonnet 5.5. Untuk mengetahui informasi tentang kemampuan, batasan, dan evaluasi keamanan setiap model, lihat kartu model untuk Anthropic Claude Opus 5.5 dan Anthropic Claude Sonnet 5.5. Kosong (semua model Gemini diizinkan). Model pihak ketiga dinonaktifkan secara default dan memerlukan izin administrator.

Model yang didukung

Alat developer AI (aplikasi Antigravity, Antigravity CLI, dan Antigravity untuk IDE) mendukung model Gemini dan model partner berikut. Pengguna berlisensi adalah developer yang diberi lisensi slot Gemini Enterprise aktif (Standard, Plus, atau Bayar sesuai penggunaan). Untuk mengetahui informasi selengkapnya, lihat Mengelola lisensi.

Nama tampilan model Penyedia Ketersediaan di Gemini Enterprise
Gemini 4 Argon Google Diaktifkan secara default untuk pengguna berlisensi saat pemilihan model default aktif (daftar kosong). Jika daftar model kustom dikonfigurasi, model harus dipilih secara manual.
Gemini 3.8 Flash Google Diaktifkan secara default untuk pengguna berlisensi saat pemilihan model default aktif. Jika daftar model kustom dikonfigurasi, model harus dipilih secara manual.
Gemini 3.7 Flash Google Diaktifkan secara default untuk pengguna berlisensi saat pemilihan model default aktif. Jika daftar model kustom dikonfigurasi, model harus dipilih secara manual.
Gemini 3.6 Flash Google Diaktifkan secara default untuk pengguna berlisensi saat pemilihan model default aktif. Jika daftar model kustom dikonfigurasi, model harus dipilih secara manual.
Gemini 3.1 Pro (Pratinjau) Google Diaktifkan secara default untuk pengguna berlisensi saat pemilihan model default aktif. Jika daftar model kustom dikonfigurasi, model harus dipilih secara manual.
Anthropic Claude Opus 5.5 Anthropic Dinonaktifkan secara default. Memerlukan keikutsertaan administrator (lihat Mengaktifkan atau menonaktifkan model pihak ketiga).
Anthropic Claude Sonnet 5.5 Anthropic Dinonaktifkan secara default. Memerlukan keikutsertaan administrator (lihat Mengaktifkan atau menonaktifkan model pihak ketiga).

Untuk mengetahui informasi tentang kuota dan kredit edisi gabungan, lihat Kuota dan kelebihan penggunaan dan Mengonfigurasi kelebihan penggunaan. Untuk harga model pihak ketiga, lihat SKU Penagihan Cloud untuk Anthropic Claude Opus 5.5 dan Anthropic Claude Sonnet 5.5.

Thinking level untuk model pihak ketiga

Developer dapat menggunakan Anthropic Claude Opus 5.5 dan Anthropic Claude Sonnet 5.5 pada tingkat penalaran Low, Medium, High, atau Max. Setiap tingkat muncul sebagai entri terpisah di pemilih model, misalnya Anthropic Claude Opus 5.5 (High). Sedang adalah setelan default. Saat Anda mengaktifkan model pihak ketiga, semua tingkat penalarannya akan tersedia untuk developer. Anda tidak dapat membatasi setiap tingkat penalaran.

Mengaktifkan atau menonaktifkan model pihak ketiga

Model pihak ketiga ditagih sebagai penggunaan bayar sesuai penggunaan dan memerlukan kelebihan penggunaan. Sebelum mengaktifkan model pihak ketiga, aktifkan kelebihan penggunaan. Jika kelebihan penggunaan dinonaktifkan nanti, developer tidak dapat menggunakan model pihak ketiga hingga kelebihan penggunaan diaktifkan kembali. Untuk mengontrol biaya, Anda dapat menetapkan batas pembelanjaan bulanan untuk project Anda. Batas ini berlaku untuk semua model, termasuk model pihak ketiga.

Untuk mengaktifkan atau mengelola model pihak ketiga (seperti Anthropic Claude Opus 5.5 dan Anthropic Claude Sonnet 5.5) di konsol Google Cloud :

  1. Di konsol Google Cloud , buka Gemini Enterprise.

    Buka Gemini Enterprise

  2. Klik Settings, lalu pilih tab AI developer tools.

  3. Di setelan Model yang diizinkan Antigravity, aktifkan tombol untuk model pihak ketiga yang ingin Anda aktifkan.

  4. Dalam dialog Persyaratan Layanan tersemat yang muncul, tinjau dan setujui persyaratan pihak ketiga.

Jika Anda menonaktifkan model pihak ketiga, developer akan kehilangan akses ke model tersebut tidak lama setelahnya.

Jika penyedia model membatasi akses ke model pihak ketiga untuk organisasi Anda, developer tidak dapat menggunakan model tersebut. Untuk menyelesaikan masalah ini, hubungi Dukungan Google Cloud.

Untuk petunjuk developer tentang cara login ke Antigravity dan memilih model, lihat dokumentasi Antigravity Enterprise.

Pertimbangan keamanan untuk model pihak ketiga

Model AI, termasuk model pihak ketiga, dapat mengikuti petunjuk yang tersembunyi dalam konten yang diprosesnya, seperti file, halaman web, atau output alat. Hal ini disebut injeksi perintah. Antigravity memberikan perlindungan berikut saat developer menggunakan model pihak ketiga:

  • Keikutsertaan administrator: Model pihak ketiga dinonaktifkan secara default. Developer hanya dapat menggunakan model pihak ketiga setelah administrator mengaktifkannya.
  • Perlindungan keamanan penyedia: Model pihak ketiga menyertakan perlindungan keamanan bawaan penyedia. Untuk mengetahui informasi selengkapnya, lihat Keamanan Claude.
  • Kebijakan keamanan Anda: Setelan kebijakan keamanan dan akses web eksternal yang Anda konfigurasi berlaku untuk agen, terlepas dari model yang dipilih developer.

Praktik terbaik

  • Hanya aktifkan model pihak ketiga yang diperlukan developer Anda.
  • Tetapkan Terminal auto-execution mode ke Require review atau Proceed in sandbox, sehingga developer menyetujui perintah sebelum dijalankan.
  • Biarkan Outside of file access policy ditetapkan ke Deny.
  • Aktifkan Akses browser dan batasi agen ke daftar URL yang diizinkan.
  • Aktifkan Mode sandbox untuk project yang menggunakan kode, dependensi, atau konten web yang tidak tepercaya.
  • Dorong developer untuk meninjau perintah dan perubahan kode yang diusulkan agen sebelum menyetujuinya.
  • Tetapkan batas pembelanjaan bulanan untuk project Anda.

Memperbaiki agen layanan yang tidak ada

Alat developer AI menggunakan agen layanan terkelola Googledi project Anda untuk menangani permintaan seperti kelebihan penggunaan dan kontrol administrator. Agen layanan dibuat secara otomatis saat Anda mengaktifkan tombol alat developer AI atau membeli langganan Gemini Enterprise.

Jika agen layanan tidak ada dalam project Anda, permintaan dari alat developer AI akan gagal dengan error yang mirip dengan berikut ini:

Service agent SERVICE_AGENT_EMAIL not found.

Untuk memperbaiki error ini, buat ulang agen layanan menggunakan salah satu metode berikut.

Menggunakan konsol Google Cloud

  1. Di konsol Google Cloud , buka Gemini Enterprise.

    Buka Gemini Enterprise

  2. Klik Settings, lalu pilih tab AI developer tools.

  3. Nonaktifkan tombol Alat developer AI.

  4. Aktifkan kembali tombol Alat developer AI.

    Mengaktifkan tombol akan membuat agen layanan di project Anda. Menonaktifkan dan mengaktifkan kembali tombol tidak akan mereset setelan alat developer AI yang telah Anda konfigurasi.

Menggunakan gcloud CLI

  1. Buat agen layanan:

    gcloud beta services identity create \
    --service=businessaicode.googleapis.com \
    --project=PROJECT_ID

    Ganti PROJECT_ID dengan ID project Anda.

    Output perintah mencakup alamat email agen layanan.

  2. Berikan peran Business AI Code Service Agent (roles/businessaicode.serviceAgent) kepada agen layanan. Perintah gcloud beta services identity create tidak memberikan peran ini secara otomatis.

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:SERVICE_AGENT_EMAIL" \
    --role="roles/businessaicode.serviceAgent"

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda.
    • SERVICE_AGENT_EMAIL: alamat email agen layanan dari output langkah sebelumnya atau dari pesan error.

Untuk informasi selengkapnya, lihat gcloud beta services identity create.

Langkah berikutnya