Agent Assist memberikan residensi data untuk menjaga data dalam penyimpanan Anda yang secara fisik berada di dalam region atau lokasi geografis tertentu. Saat 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.
- Kualitas latensi jaringan Anda mungkin akan meningkat jika penyimpanan data berada di region yang sama dengan pelanggan. Misalnya, jika pelanggan Belgia menggunakan
europe-west1, mereka dapat mengharapkan latensi yang lebih baik.
Wilayah yang tersedia
| Pengelompokan negara | Lokasi geografis | ID wilayah | 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 (global serving, 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'. Akibatnya, 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 AS. Sebaiknya gunakan region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna Anda, jika memungkinkan. |
Fitur yang tersedia untuk layanan regional
| ID wilayah | Ringkasan dengan bagian kustom v6.0/5.0/4.0 | Evaluasi otomatis ringkasan | Analisis sentimen (v3) | Knowledge Assist 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 akan 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 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 Knowledge Assist Generatif (Proaktif): multi-region
global,us, daneu.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:
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 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 regional. 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.