Dialogflow menyediakan residensi data untuk menyimpan data dalam penyimpanan secara fisik dalam region atau lokasi geografis. Saat region ditentukan, data dalam penyimpanan Anda tidak direplikasi di luar region tersebut. Harga sama untuk semua wilayah.
Wilayah 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.
Misalnya, jika pelanggan di Inggris Raya 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 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 region |
---|---|---|
Eropa | Belgia | europe-west1 |
Eropa | London | europe-west2 |
Asia Pasifik | Sydney | australia-southeast1 |
Asia Pasifik | Tokyo | asia-northeast1 |
Global | Penyajian Dialogflow bersifat global, data dalam penyimpanan berada dalam AS | global (lebih disukai), us (tidak digunakan lagi), atau tidak ada region (default) |
Memilih region dengan konsol
Area kiri atas Dialogflow ES Console memiliki menu drop-down untuk pemilihan region.
Setiap agen memiliki region yang tidak dapat diubah dan akan ditentukan saat pembuatan.
Saat memilih wilayah dari konsol, Anda hanya dapat mencantumkan atau membuat agen untuk wilayah yang dipilih.
Region default-nya adalah us
.
Pilih region dengan API
Jika agen dibuat di region non-default, Anda harus menentukan region tersebut saat memanggil API untuk permintaan waktu desain atau runtime.
Untuk menyediakan region, Anda harus memberikan parameter location
ke permintaan API.
Untuk panggilan REST, lakukan kedua hal berikut:
- Berikan parameter jalur URL
location
. - Gunakan nama host spesifik per wilayah dari format
REGION_ID-dialogflow.googleapis.com
. Contoh:asia-northeast1-dialogflow.googleapis.com
. Jika wilayah yang ditentukan dalam nama host tidak cocok dengan wilayah yang ditentukan dalam jalur URL, permintaan akan ditolak.
Untuk library klien, lihat dokumentasi library klien. Anda perlu melakukan tindakan berikut:
Tetapkan endpoint layanan Dialogflow ke:
REGION_ID-dialogflow.googleapis.com:443
Tetapkan nama sesi ke:
projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID
Contoh:
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID Google Cloud Anda
- REGION_ID: ID wilayah, contoh:
europe-west2
- SESSION_ID: ID sesi
Metode HTTP dan URL:
POST https://REGION_ID-dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID:detectIntent
Meminta isi JSON:
{ "query_input": { "text": { "text": "I want a pony.", "language_code": "en-US" } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Java
Untuk mengautentikasi ke Dialogflow, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Dialogflow, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien lalu kunjungi Dokumentasi referensi Dialogflow untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien lalu kunjungi Dokumentasi referensi Dialogflow untuk PHP.
Ruby: Ikuti petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Dialogflow untuk Ruby.
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 ditemukan di banyak dokumen referensi REST, hanya mendukung region global
untuk panggilan API.