Regionalisasi dan residensi data

Dialogflow menyediakan residensi data untuk menjaga data dalam penyimpanan Anda secara fisik berada di dalam region atau lokasi geografis. Jika 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 lokasi penyimpanan data Anda.
• Kualitas latensi jaringan Anda mungkin akan meningkat jika penyimpanan data berada di region yang sama dengan pelanggan. Misalnya, jika pelanggan di Inggris Raya menggunakan europe-west2, mereka dapat mengharapkan latensi yang lebih baik.

Catatan: Regionalisasi dan residensi data Dialogflow tidak berlaku untuk data aktif atau data dalam pengiriman.

Data dalam penyimpanan

Semua data pengguna developer dan pengguna akhir Dialogflow disertakan dalam data saat istirahat. 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 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	Penayangan Dialogflow bersifat global, data saat tidak digunakan berada di AS	global (lebih disukai) atau tidak ada wilayah (default) *

Simbol	Deskripsi
*	Panggilan ke region global mungkin memiliki latensi yang lebih tinggi saat dipanggil dari luar Amerika Serikat. Jika memungkinkan, pilih region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna akhir Anda.

Pilih region 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 wilayah dari konsol, Anda hanya dapat mencantumkan atau membuat agen untuk wilayah yang dipilih. Region default-nya adalah global.

Catatan: Anda dapat membuat satu agen per region untuk project Google Cloud.

Memilih wilayah 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 perlu 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
  

Perhatian: Seperti yang dijelaskan dalam dokumentasi penyiapan, Anda harus menggunakan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS untuk memberikan kredensial ke library klien. Namun, jika Anda perlu memberikan file kredensial secara manual dalam kode, Anda harus melakukan satu langkah tambahan saat memanggil endpoint yang dilokalkan. Tetapkan cakupan ke https://www.googleapis.com/auth/cloud-platform saat membuat kredensial autentikasi Anda. Misalnya, hal ini dilakukan di Java saat membuat objek GoogleCredentials:

GoogleCredentials.fromStream(new FileInputStream("credential_file"))
  .createScoped("https://www.googleapis.com/auth/cloud-platform")
  

Cloud Logging

Lihat Panduan Cloud Logging untuk mengontrol region tempat log disimpan.

Batasan

Jika region non-default dipilih di Konsol Dialogflow, fitur berikut tidak tersedia:

• Integrasi
• Knowledge Connectors
• Agen Siap Pakai
• Percakapan Ringan (Small Talk)
• Alat pelatihan

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