Agent Assist menyediakan residensi data untuk menjaga data dalam penyimpanan Anda secara fisik berada 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 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 Belgia menggunakan
europe-west1, mereka dapat mengharapkan latensi yang lebih baik.
Wilayah yang tersedia
| Pengelompokan negara | Lokasi geografis | ID region | ID wilayah 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 saat tidak digunakan di Amerika Serikat) | global (pilihan) atau tanpa wilayah (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 single region AS yang ada. |
| ¶ | Panggilan ke wilayah global mungkin memiliki latensi yang lebih tinggi saat dipanggil dari luar Amerika Serikat. Pilih region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna Anda, jika memungkinkan. |
Fitur yang tersedia untuk penayangan regional
| ID region | Agen Pendamping | Ringkasan dengan bagian kustom v6.0/5.0/4.0 | Evaluasi otomatis ringkasan | Analisis sentimen (v3) | (Proaktif) Generative Knowledge Assist | Membuat 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 tersimpan. 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 akan dirutekan ke luar region selama proses ini.
API Explorer, yang ada di banyak dokumen referensi REST, hanya mendukung panggilan API untuk region
global.Transkripsi CCAI hanya mendukung data aktif dan data dalam penyimpanan multi-region (jika tidak menggunakan fitur Speech Adaptation) 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.Grounding with Google Search (GWGS) tidak mendukung residensi data (DRZ). Jika diaktifkan, kontrol ini tidak berlaku untuk permintaan penelusuran. Untuk mengetahui informasi selengkapnya, lihat Kontrol keamanan Platform Agen Gemini Enterprise.
Menentukan region menggunakan API
Untuk menggunakan regionalisasi, Anda harus menentukan region 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.