Dialogflow menyediakan residensi data untuk menjaga data dalam penyimpanan Anda yang secara fisik berada di dalam region atau lokasi geografis. Saat region ditentukan, data dalam penyimpanan Anda tidak akan direplikasi di luar region tersebut. Harga sama untuk semua region.
Region digunakan karena alasan berikut:
- Sistem Anda mungkin memiliki persyaratan peraturan atau kebijakan yang mengatur tempat data Anda harus berada.
- Latensi jaringan Anda dapat ditingkatkan jika data berada di region yang sama dengan pelanggan Anda.
Misalnya, jika pelanggan Inggris menggunakan
europe-west2, mereka dapat mengharapkan latensi yang lebih baik.
Data dalam penyimpanan
Semua data pengguna developer dan pengguna akhir Dialogflow disertakan dalam data dalam penyimpanan. Contoh:
- Semua resource agen yang ditetapkan dengan konsol atau API (intent, entity, dll.)
- Semua setelan agen yang ditetapkan dengan konsol atau API
- Histori kueri
- Hasil validasi
- Tugas pembuatan model
- Tugas pelatihan
- Tugas operasi yang berjalan lama
Region yang tersedia
Dialogflow menyediakan region berikut:
| Pengelompokan negara | Lokasi geografis | ID wilayah |
|---|---|---|
| Eropa | Belgia | europe-west1 |
| Eropa | London | europe-west2 |
| Asia Pasifik | Sydney | australia-southeast1 |
| Asia Pasifik | Tokyo | asia-northeast1 |
| Global | Layanan Dialogflow bersifat global, data dalam penyimpanan berada di AS | global (pilihan) atau tanpa region (default) * |
| Simbol | Deskripsi |
|---|---|
| * | Panggilan ke region global mungkin memiliki latensi yang lebih tinggi jika dipanggil dari luar AS. Sebaiknya gunakan region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna akhir Anda, jika memungkinkan. |
Memilih region dengan konsol
Area kiri atas konsol Dialogflow ES
memiliki menu drop-down untuk pemilihan region.
Setiap agen memiliki region yang tidak dapat diubah dan ditentukan saat pembuatan.
Saat memilih region dari konsol, Anda hanya dapat mencantumkan atau membuat agen untuk region yang dipilih.
Region default-nya adalah global.
Memilih region dengan API
Jika agen Anda dibuat di region non-default, Anda harus menentukan region tersebut saat memanggil API untuk permintaan waktu desain atau runtime.
Untuk memberikan region, Anda harus menyediakan parameter location ke permintaan API.
Untuk panggilan REST, lakukan kedua hal berikut:
- Berikan parameter jalur URL
location. Untuk regionglobal, gunakanglobal. - Untuk region
global, gunakandialogflow.googleapis.comuntuk nama host. Untuk semua region lainnya, gunakan[REGION_ID]-dialogflow.googleapis.comuntuk nama host.
Contoh:
https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents/https://asia-northeast1-dialogflow.googleapis.com/v2/projects/PROJECT/locations/asia-northeast1/agents/
Untuk library klien, lihat dokumentasi library klien. Anda perlu melakukan hal berikut:
Tetapkan endpoint layanan Dialogflow ke salah satu hal berikut:
dialogflow.googleapis.com:443 REGION_ID-dialogflow.googleapis.com:443
Tetapkan nama sesi ke:
projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID
Cloud Logging
Lihat panduan Cloud Logging untuk mengontrol region tempat log disimpan.
Batasan
Jika region non-default dipilih di Konsol Dialogflow, fitur berikut tidak akan tersedia:
APIs Explorer,
yang dapat ditemukan di banyak
dokumen referensi REST,
hanya mendukung region global untuk panggilan API.