Saat membuat agen, Anda harus menentukan region sebagai lokasi agen. Permintaan yang dikirim ke agen Anda ditangani oleh layanan Google di region ini dan Agen Percakapan (Dialogflow CX) menyimpan data dalam penyimpanan secara fisik 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 diwajibkan oleh entitas pemerintah atau industri yang diatur), baca selengkapnya tentang setelan lokasi.
Batasan
Batasan berikut berlaku:
Dukungan wilayah untuk integrasi telepon yang berbeda dapat bervariasi. Periksa dokumentasi untuk setiap integrasi.
Dukungan entitas sistem berbeda untuk setiap bahasa. Lihat batasan entity sistem untuk mengetahui detailnya.
API Explorer, yang ditemukan di banyak dokumen referensi REST, hanya mendukung region
globaluntuk panggilan API.
Wilayah yang tersedia
Agen Percakapan (Dialogflow CX) mendukung wilayah berikut untuk lokasi agen. Agen penyimpanan data juga didukung di region yang tercantum dalam tabel berikut, tetapi ID region yang digunakan oleh penyimpanan data sedikit berbeda dari region agen (seperti yang tercantum). Semua region dengan nilai yang dimasukkan di kolom Data store region ID didukung oleh agen penyimpanan data di Vertex AI Conversation.
| Pengelompokan negara | Lokasi geografis | ID wilayah agen | ID region penyimpanan data |
|---|---|---|---|
| Amerika | Iowa | us-central1 |
us (multi-region) |
| Amerika | Montréal | northamerica-northeast1 |
global (multi-region) |
| Amerika | Carolina Selatan | us-east1 |
us (multi-region) |
| Amerika | Oregon | us-west1 |
us (multi-region) |
| Amerika | Multi-region Amerika Serikat | us * |
us (multi-region) |
| Eropa | Belgia | europe-west1 |
eu (multi-region) |
| Eropa | London | europe-west2 |
eu (multi-region) |
| Eropa | Frankfurt | europe-west3 |
eu (multi-region) |
| 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 dalam penyimpanan di Amerika Serikat) | global (lebih disukai) atau tanpa region (default) ¶ |
global (multi-region) ¶ |
| Simbol | Deskripsi |
|---|---|
| * | Vertex AI tidak mendukung lokasi multi-region 'us'. Akibatnya, penggunaan fitur AI Generatif Agen Percakapan (Dialogflow CX) di multi-region 'us' akan bergantung pada endpoint region tunggal Amerika Serikat yang ada. |
| ¶ | Panggilan ke region global mungkin memiliki latensi yang lebih tinggi saat dipanggil dari luar Amerika Serikat. Pilih region yang lebih spesifik yang lebih dekat dengan layanan dan pengguna akhir Anda, jika memungkinkan. |
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 diwajibkan 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 project, resource dialogflow.googleapis.com/LocationSettings yang tidak dapat diubah akan dibuat, dan setelan tersebut tidak dapat diubah untuk lokasi tersebut. Jika perlu mengubah setelan ini atau
menghapus resource, Anda harus membuat project baru.
Jika perlu mengizinkan developer organisasi mengonfigurasi agen hanya di lokasi tertentu, Anda dapat menyiapkan kebijakan organisasi yang menyertakan batasan lokasi resource.
Jika Anda membuat agen tanpa mengedit setelan lokasi, setelan default akan dikonfigurasi untuk lokasi tersebut, dan 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 Location saat membuat agen.
Menentukan wilayah dengan API
Anda harus menentukan wilayah untuk semua permintaan API.
Untuk panggilan REST, Anda harus melakukan kedua hal berikut:
Berikan ID region untuk parameter jalur URL
location.Untuk region
global, gunakandialogflow.googleapis.comuntuk nama host. Untuk semua region lainnya, gunakan[region-id]-dialogflow.googleapis.comuntuk 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.
Cloud Logging
Lihat Panduan Cloud Logging untuk mengontrol region tempat log disimpan.