Setelan lokasi dan regionalisasi

Saat membuat agen, Anda harus menentukan region sebagai lokasi agen. Permintaan yang dikirim ke agen Anda ditangani oleh layanan Google di region ini dan Dialogflow CX menyimpan data dalam penyimpanan secara fisik di dalam region atau lokasi geografis. Untuk mendapatkan performa terbaik, Anda harus memilih region yang dekat dengan layanan dan pengguna akhir Anda.

Setelah agen dibuat, lokasinya tidak dapat diubah. Untuk mengubah lokasi agen, Anda harus mengekspor dan memulihkan ke agen baru dengan lokasi yang berbeda.

Setiap lokasi memiliki setelan terkait yang berlaku di seluruh project Anda. Pada umumnya, Anda tidak perlu mengedit setelan lokasi ini, dan setelan default akan berfungsi dengan baik. Jika sistem Anda memerlukan kunci enkripsi yang dikelola pelanggan (sering kali diperlukan oleh entitas pemerintah atau industri yang diatur), baca selengkapnya tentang setelan lokasi.

Batasan

Batasan berikut berlaku:

• Dukungan wilayah untuk berbagai integrasi telepon dapat bervariasi. Periksa dokumentasi untuk setiap integrasi.

• Dukungan entity sistem berbeda untuk setiap bahasa. Lihat batasan entity sistem untuk mengetahui detailnya.

• APIs Explorer, yang ada di banyak dokumen referensi REST, hanya mendukung region global untuk panggilan API.

Wilayah yang tersedia

Penting: Komitmen "Lokasi Data AI/ML" (Residensi Data untuk Pemrosesan ML) hanya didukung di lokasi dalam AS dan Uni Eropa. Pemrosesan ML untuk model generatif dapat terjadi di lokasi mana pun dalam multi-region saat permintaan dibuat ke API regional yang disertakan dalam multi-region. Untuk mengetahui detail selengkapnya, lihat dokumentasi Vertex AI.

Dialogflow CX mendukung region berikut untuk lokasi agen. Agen penyimpanan data juga didukung di region yang tercantum dalam tabel berikut, tetapi ID wilayah yang digunakan oleh penyimpanan data sedikit berbeda dari region agen (seperti yang tercantum). Semua region dengan nilai yang dimasukkan dalam kolom ID region penyimpanan data didukung oleh agen penyimpanan data di Vertex AI Agents.

Pengelompokan negara	Lokasi geografis	ID wilayah agen	ID region penyimpanan data
Amerika	Iowa	us-central1	us (multi-region)
Amerika	Montréal	northamerica-northeast1	global (multiregion)
Amerika	Carolina Selatan	us-east1	us (multi-region)
Amerika	Oregon	us-west1	us (multiregion)
Amerika	Multi-region Amerika Serikat	us *	us (multiregion)
Eropa	Belgia	europe-west1	eu (multi-region)
Eropa	London	europe-west2	eu (multiregion)
Eropa	Frankfurt	europe-west3	eu (multiregion)
Eropa	Belanda	europe-west4	eu (multi-region)
Eropa	Zurich	europe-west6	eu (multi-region)
Asia Pasifik	Sydney	australia-southeast1	global (multi-region)
Asia Pasifik	Tokyo	asia-northeast1	global (multi-region)
Asia Pasifik	Mumbai	asia-south1	global (multi-region)
Asia Pasifik	Singapura	asia-southeast1	global (multi-region)
Asia Pasifik	Jakarta	asia-southeast2	global (multi-region)
Global	Multi-region global (penayangan global, data saat tidak digunakan di Amerika Serikat)	global (pilihan) atau tanpa wilayah (default) ¶	global (multi-region) ¶

Simbol	Deskripsi
*	Untuk model Gemini 2.x, Vertex AI tidak mendukung lokasi multi-region us atau eu. Oleh karena itu, penggunaan fitur AI generatif Dialogflow CX di multi-region us atau eu bergantung pada endpoint satu region AS atau Uni Eropa yang sudah ada. Untuk model Gemini 3 dan yang lebih baru (seperti gemini-3.1-flash-lite), lokasi multi-region us dan eu didukung dan digunakan untuk wilayah AS dan Eropa. Untuk mengetahui informasi selengkapnya, lihat Kuota generatif.
¶	Panggilan ke region global mungkin memiliki latensi yang lebih tinggi saat dipanggil dari luar Amerika Serikat. Jika memungkinkan, pilih region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna akhir Anda.

Anda dapat membaca selengkapnya tentang region yang digunakan oleh Google Cloud di Region Google Cloud dan Geografi dan region Google Cloud.

Setelan lokasi

Jika sistem Anda memerlukan kunci enkripsi yang dikelola pelanggan (sering kali diperlukan oleh entitas pemerintah atau industri yang diatur), Anda dapat menggunakan setelan lokasi untuk mengonfigurasi fitur ini.

Setelan lokasi dibagikan di seluruh project, dan setiap lokasi unik memiliki setelan lokasinya sendiri.

Setelah setelan untuk lokasi tertentu dikonfigurasi untuk sebuah project, resource dialogflow.googleapis.com/LocationSettings yang tidak dapat diubah akan dibuat, dan setelan tidak dapat diubah untuk lokasi tersebut. Jika Anda perlu mengubah setelan ini atau menghapus resource, Anda harus membuat project baru.

Jika Anda perlu mengizinkan developer organisasi Anda mengonfigurasi agen hanya di lokasi tertentu, Anda dapat menyiapkan kebijakan organisasi yang mencakup batasan lokasi resource.

Jika Anda membuat agen tanpa mengedit setelan lokasi, setelan default akan dikonfigurasi untuk lokasi tersebut, dan setelan tersebut tidak dapat diubah untuk project. Selain itu, setelah agen dibuat, lokasinya tidak dapat diubah. Untuk mengubah lokasi agen, Anda harus mengekspor dan memulihkan ke agen baru dengan lokasi yang berbeda.

Setelan lokasi berikut tersedia:

• Enkripsi: Setelan ini mengontrol apakah kunci enkripsi yang dikelola Google atau yang dikelola pelanggan digunakan untuk melindungi data. Defaultnya adalah dikelola Google. Anda harus meminta akses (dengan menghubungi perwakilan Google) ke fitur kunci enkripsi yang dikelola pelanggan untuk mengubah setelan ini.

Anda dapat mengonfigurasi setelan lokasi dengan dua cara:

• Klik Setelan lokasi dari antarmuka pemilih agen.
• Klik tombol Edit di samping drop-down Lokasi saat membuat agen.

Catatan: Saat ini, Anda tidak dapat memperbarui setelan lokasi dengan API.

Menentukan region dengan API

Anda harus menentukan region untuk semua permintaan API.

Untuk panggilan REST, Anda harus melakukan kedua hal berikut:

• Berikan ID wilayah untuk parameter jalur URL location.

• Untuk region global, gunakan dialogflow.googleapis.com untuk nama host. Untuk semua region lainnya, gunakan [region-id]-dialogflow.googleapis.com untuk nama host.

Contoh:

• dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/global/agents/{AGENT_ID}

• us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}

Untuk library klien, lihat dokumentasi library klien untuk opsi konfigurasi region.

Anda dapat menemukan contohnya di panduan memulai API.

Perhatian: Seperti yang dijelaskan dalam dokumentasi penyiapan, Anda harus menggunakan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS untuk memberikan kredensial ke library klien. Namun, jika Anda perlu memberikan file kredensial secara manual dalam kode, Anda harus melakukan satu langkah tambahan saat memanggil endpoint yang dilokalkan. Tetapkan cakupan ke https://www.googleapis.com/auth/cloud-platform saat membuat kredensial autentikasi Anda. Misalnya, hal ini dilakukan di Java saat membuat objek GoogleCredentials:

GoogleCredentials.fromStream(new FileInputStream("credential_file"))
  .createScoped("https://www.googleapis.com/auth/cloud-platform")
  

Cloud Logging

Lihat Panduan Cloud Logging untuk mengontrol region tempat log disimpan.