Agent Assist menyediakan residen data untuk menyimpan data dalam penyimpanan Anda secara fisik di 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 region.
Menentukan region sangat membantu dalam kasus penggunaan berikut:
- Sistem Anda memiliki persyaratan peraturan atau kebijakan yang mengatur tempat data Anda harus berada.
- Latensi jaringan Anda mungkin meningkat jika data berada di region yang sama dengan pelanggan Anda. Misalnya, jika pelanggan 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 (layanan global, data dalam penyimpanan di Amerika Serikat) | global (pilihan) atau tanpa region (default) ¶ |
global (multi-region) ¶ |
| Simbol | Deskripsi |
|---|---|
| * | Vertex AI tidak mendukung lokasi multi-region 'us'. Oleh karena itu, penggunaan fitur AI Generatif Agent Assist di multi-region 'us' akan mengandalkan endpoint region tunggal AS yang ada. |
| ¶ | Panggilan ke region global mungkin memiliki latensi yang lebih tinggi jika dipanggil dari luar Amerika Serikat. Sebaiknya gunakan region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna Anda, jika memungkinkan. |
Fitur yang tersedia untuk layanan regional
| ID region | Ringkasan dengan bagian kustom v5.0/4.0 | Evaluasi otomatis ringkasan (Pratinjau) | Analisis sentimen (v3) | Bantuan Pengetahuan Generatif (Proaktif) | Buat bantuan Anda sendiri (Pratinjau) | Pelatih AI |
|---|---|---|---|---|---|---|
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 dalam penyimpanan. 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 region selama proses ini.
API Explorer, yang dapat ditemukan di banyak dokumen referensi REST, hanya mendukung region
globaluntuk panggilan API.Transkripsi CCAI hanya mendukung data multi-region yang digunakan dan data dalam penyimpanan (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): multi-region
global,us, daneu.
Menentukan region menggunakan API
Untuk menggunakan regionalisasi, Anda harus menentukan region untuk setiap permintaan API.
Kolom yang wajib diisi:
Berikan ID region 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 GOOGLE_APPLICATION_CREDENTIALS lingkungan untuk memberikan kredensial ke library klien Anda. Lihat petunjuk penyiapan Dialogflow untuk mengetahui informasi selengkapnya tentang cara menetapkan variabel ini.
Jika Anda perlu memberikan kredensial manual dalam kode, satu langkah tambahan diperlukan sebelum Anda dapat memanggil endpoint yang diregionalkan. Anda harus menetapkan cakupan ke https://www.googleapis.com/auth/cloud-platform saat 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.