Regionalisasi dan residensi data

Dialogflow menyediakan residensi data untuk menyimpan data dalam penyimpanan secara fisik dalam region atau lokasi geografis. Jika region ditentukan, data dalam penyimpanan Anda tidak akan direplikasi di luar region tersebut. Harganya 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 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 yang ditetapkan dengan konsol atau API
  • Histori kueri
  • Hasil validasi
  • Tugas pembuatan model
  • Tugas pelatihan
  • Tugas operasi yang berjalan lama

Wilayah yang tersedia

Dialogflow menyediakan wilayah 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 Penayangan Dialogflow bersifat global, data dalam penyimpanan berada di AS global (lebih disukai) atau tidak ada region (default) *

Memilih wilayah dengan konsol

Area kiri atas konsol Dialogflow ES memiliki drop-down untuk pemilihan wilayah. Setiap agen memiliki region yang tidak dapat diubah yang ditentukan saat pembuatan. Saat memilih region dari konsol, Anda hanya dapat mencantumkan atau membuat agen untuk region yang dipilih. Region default adalah global.

Memilih wilayah dengan API

Jika agen dibuat di region non-default, Anda harus menentukan region tersebut saat memanggil API untuk permintaan waktu desain atau runtime.

Untuk memberikan region, Anda harus memberikan parameter location ke permintaan API. Untuk panggilan REST, lakukan kedua hal berikut:

  • Berikan parameter jalur URL location. Untuk region global, gunakan global.
  • Untuk region global, gunakan dialogflow.googleapis.com untuk nama host. Untuk semua region lainnya, gunakan [REGION_ID]-dialogflow.googleapis.com untuk 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 opsi 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 wilayah non-default dipilih di Konsol Dialogflow, fitur berikut tidak akan tersedia:

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