Agent Assist menyediakan residensi data untuk menjaga data dalam penyimpanan secara fisik dalam region atau lokasi geografis tertentu. Saat Anda menentukan region, data dalam penyimpanan Anda tidak akan disimpan di luar region tersebut. Harga sama untuk semua wilayah.
Menentukan region sangat membantu dalam kasus penggunaan berikut:
- Sistem Anda memiliki persyaratan peraturan atau kebijakan yang mengatur lokasi penyimpanan data Anda.
- Latensi jaringan Anda mungkin ditingkatkan jika data berada di region yang sama dengan pelanggan Anda. Misalnya, jika pelanggan di Belgia menggunakan
europe-west1, mereka dapat mengharapkan latensi yang lebih baik.
Wilayah yang tersedia
| Pengelompokan negara | Lokasi geografis | ID region | ID region penyimpanan data |
|---|---|---|---|
| Amerika | Iowa | us-central1 |
us (multi-region) |
| Amerika | Carolina Selatan | us-east1 |
|
| Amerika | Oregon | us-west1 |
|
| Amerika | Montreal | northamerica-northeast1 |
global (multi-region) |
| Amerika | Multi-region Amerika Serikat | us * |
us (multi-region) * |
| Eropa | Belgia | europe-west1 |
eu (multi-region) |
| Eropa | London | europe-west2 |
|
| Eropa | Frankfurt | europe-west3 |
|
| Eropa | Eemshaven | europe-west4 |
eu (multi-region) |
| Eropa | Zurich | europe-west6 |
eu (multi-region) |
| Asia Pasifik | Singapura | asia-southeast1 |
|
| Asia Pasifik | Jakarta | asia-southeast2 |
global (multi-region) |
| Asia Pasifik | Tokyo | asia-northeast1 |
|
| Asia Pasifik | Mumbai | asia-south1 |
|
| Asia Pasifik | Sydney | australia-southeast1 |
|
| Global | Multi-region global (penayangan global, data dalam penyimpanan di Amerika Serikat) | global (pilihan) atau tidak ada region (default) ¶ |
global (multi-region) ¶ |
| Simbol | Deskripsi |
|---|---|
| * | Vertex AI tidak mendukung lokasi multi-region 'us'. Akibatnya, penggunaan fitur AI Generatif Agent Assist di multi-region 'us' akan mengandalkan endpoint single region AS yang ada. |
| ¶ | Panggilan ke wilayah global mungkin memiliki latensi yang lebih tinggi saat dipanggil dari luar Amerika Serikat. Sebaiknya pilih region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna Anda, jika memungkinkan. |
Fitur yang tersedia untuk penayangan regional
| ID region | Perangkuman dengan bagian kustom v4.0 | Perangkuman dengan bagian kustom v3.1/3.0 | Evaluasi otomatis ringkasan (Pratinjau) | Analisis sentimen | (Proaktif) Bantuan Pengetahuan Generatif | Membuat bantuan Anda sendiri (Pratinjau) |
|---|---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
us |
✓ | ✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | ||
europe-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | ||
europe-west3 |
✓ | ✓ | ✓ | ✓ | ||
europe-west4 |
✓ | ✓ | ✓ | |||
europe-west6 |
✓ | ✓ | ✓ | |||
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | ||
asia-southeast2 |
✓ | ✓ | ✓ | |||
asia-northeast1 |
✓ | ✓ | ✓ | ✓ | ||
asia-south1 |
✓ | ✓ | ✓ | ✓ | ||
australia-southeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
global |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Data dalam penyimpanan
Semua data pengguna developer dan pengguna akhir Agent Assist disertakan dalam data saat istirahat. Contoh:
- Pusat informasi dan dokumen pengetahuan.
- Profil percakapan.
- Histori percakapan dan pesan.
- Peserta konversi.
- Saran yang ditampilkan oleh Agent Assist.
- Feedbacks.
Batasan
Batasan berikut berlaku:
- Konsol Agent Assist tidak mendukung regionalisasi. Anda hanya dapat menerapkan regionalisasi dengan memanggil API secara langsung.
- Pelatihan model tidak mendukung regionalisasi. Data Anda mungkin dirutekan ke luar wilayah selama proses ini.
API Explorer, yang ada di banyak dokumen referensi REST, hanya mendukung region
globaluntuk panggilan API.Transkripsi CCAI hanya mendukung data yang digunakan dan data dalam penyimpanan multi-region (jika tidak menggunakan fitur Adaptasi Ucapan) di Uni Eropa, Amerika Serikat, Amerika Utara (Kanada).
Hanya region berikut yang didukung untuk penyimpanan data, yang digunakan oleh fitur Bantuan Pengetahuan Generatif (Proaktif):
global, multi-regionus, dan multi-regioneu.
Menentukan region menggunakan API
Untuk menggunakan regionalisasi, Anda harus menentukan wilayah untuk setiap permintaan API.
Kolom wajib diisi:
Berikan ID wilayah untuk parameter jalur URL
location.Untuk region
global, gunakandialogflow.googleapis.comuntuk nama host. Untuk semua region lainnya, gunakan[region-id]-dialogflow.googleapis.comuntuk nama host.
Contoh:
dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_idus-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id
Untuk menggunakan library klien, langkah-langkah berikut diperlukan:
- Tetapkan endpoint layanan ke:
REGION_ID-dialogflow.googleapis.com. Tetapkan nama resource dengan lokasi yang benar, misalnya:
projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id
Kredensial
Sebaiknya gunakan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS untuk memberikan kredensial ke library klien Anda. Lihat petunjuk penyiapan Dialogflow untuk mengetahui informasi selengkapnya tentang cara menyetel variabel ini.
Jika Anda perlu memberikan kredensial manual dalam kode, satu langkah tambahan diperlukan sebelum Anda dapat memanggil endpoint yang dilokalkan. Anda harus menyetel
cakupan ke https://www.googleapis.com/auth/cloud-platform saat Anda membuat
kredensial autentikasi. Contoh berikut menunjukkan cara melakukannya di Java saat membuat objek GoogleCredentials:
GoogleCredentials.fromStream(new FileInputStream("credential_file"))
.createScoped("https://www.googleapis.com/auth/cloud-platform")
Cloud Logging
Lihat dokumentasi Cloud Logging untuk mengontrol region tempat log Anda disimpan.