Setelan lokasi dan regionalisasi

Saat membuat agen, Anda harus menentukan wilayah sebagai lokasi agen. Permintaan yang dikirim ke agen Anda ditangani oleh layanan Google di region ini dan Dialogflow akan 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 diperlukan oleh entitas pemerintah atau industri yang diatur), baca selengkapnya tentang setelan lokasi.

Batasan

Batasan berikut berlaku:

  • Dukungan region untuk integrasi telepon yang berbeda dapat bervariasi. Lihat dokumentasi untuk setiap integrasi.

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

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

Region yang tersedia

Dialogflow CX mendukung region berikut untuk lokasi agen. Agen penyimpanan data mendukung subset wilayah ini, dan ID wilayah yang digunakan oleh penyimpanan data sedikit berbeda dari wilayah agen. Semua region yang memiliki nilai untuk kolom ID region data store didukung oleh agen penyimpanan data di Vertex AI Conversation.

Pengelompokan negara Lokasi geografis ID wilayah agen ID wilayah penyimpanan data
Amerika Iowa us-central1 Multi-region us
Amerika Montréal northamerica-northeast1
Amerika South Carolina us-east1
Amerika Oregon us-west1
Eropa Belgia europe-west1 Multi-region eu
Eropa London europe-west2
Eropa Frankfurt europe-west3
Asia Pasifik Sydney australia-southeast1
Asia Pasifik Tokyo asia-northeast1
Asia Pasifik Mumbai asia-south1
Asia Pasifik Singapura asia-southeast1
Global Penayangan global, data dalam penyimpanan di AS global (lebih disukai), us (tidak digunakan lagi), atau tidak ada wilayah (default) global

Anda dapat membaca selengkapnya tentang region yang digunakan oleh Google Cloud di region Google Cloud serta geografis 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 digunakan bersama di seluruh project, dan setiap lokasi unik memiliki setelan lokasinya sendiri. Setelah setelan untuk lokasi tertentu dikonfigurasi untuk sebuah project, setelan untuk lokasi tersebut tidak dapat diubah. Jika perlu mengubah setelan ini, Anda harus membuat project baru.

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 akan digunakan untuk melindungi data. Setelan 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:

Menentukan wilayah 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.

  • Gunakan [region-id]-dialogflow.googleapis.com untuk nama host.

Contoh:

  • 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.

Logging cloud

Lihat Panduan Cloud logging untuk mengontrol region tempat log disimpan.