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 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 berbagai integrasi telepon mungkin bervariasi. Periksa dokumentasi untuk setiap integrasi.

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

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

Wilayah yang tersedia

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 wilayah penyimpanan data didukung oleh agen penyimpanan data di Vertex AI Agents.

Pengelompokan negara Lokasi geografis ID wilayah agen ID wilayah 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-at-rest di Amerika Serikat) global (pilihan) atau tanpa region (default) ¶ global (multi-region) ¶

Anda dapat membaca lebih lanjut 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 untuk 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. Default-nya 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 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. Untuk multi-region us, Anda juga dapat menggunakan endpoint multi-regional AS.

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.

Menggunakan endpoint multi-regional AS

Jika agen Anda berada di multi-region us, Anda dapat mengirim permintaan API ke endpoint multi-regional AS, dialogflow.us.rep.googleapis.com. Endpoint multi-region menghentikan TLS dan memproses permintaan Anda dalam multi-region, sehingga data permintaan Anda tetap berada di AS saat dalam pengiriman. Menggunakan endpoint ini tidak akan mengubah tempat data agen Anda disimpan. Untuk informasi selengkapnya, lihat Ringkasan endpoint API regional dan multi-regional di panduan keamanan Google Cloud .

Untuk menggunakan endpoint multi-regional AS, buat perubahan berikut pada setiap permintaan:

  1. Gunakan dialogflow.us.rep.googleapis.com untuk nama host.

  2. Tetapkan parameter jalur URL location ke us.

Contoh:

  • dialogflow.us.rep.googleapis.com/v3/projects/{PROJECT_ID}/locations/us/agents/{AGENT_ID}

Gunakan endpoint multi-regional AS hanya untuk resource di lokasi us. Untuk resource di lokasi lain, termasuk us-central1, us-east1, dan us-west1, gunakan nama host untuk lokasi tersebut.

Untuk menggunakan endpoint multi-regional AS dengan library klien, tetapkan opsi endpoint API klien ke dialogflow.us.rep.googleapis.com. Misalnya, di Python, teruskan client_options={"api_endpoint": "dialogflow.us.rep.googleapis.com"} saat Anda membuat klien. Jika Anda menggunakan Terraform, tetapkan kolom dialogflow_cx_custom_endpoint penyedia Google ke https://dialogflow.us.rep.googleapis.com/v3/. Setelan tersebut mengirimkan semua permintaan Dialogflow CX penyedia ke endpoint multiregional AS, jadi gunakan hanya untuk resource di lokasi us.

Untuk mengetahui daftar endpoint layanan regional dan multi-region, lihat Endpoint layanan regional dan multi-region dalam panduan Virtual Private Cloud.

Cloud Logging

Lihat Panduan Cloud Logging untuk mengontrol region tempat log disimpan.