Agent Assist menyediakan residensi data untuk menyimpan data dalam penyimpanan secara fisik dalam region atau lokasi geografis tertentu. Saat Anda menentukan region, data dalam penyimpanan tidak akan disimpan di luar region tersebut. Harganya 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 akan 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 | South Carolina | us-east1 |
|
| Amerika | Oregon | us-west1 |
|
| Amerika | Montréal | northamerica-northeast1 |
|
| Amerika | Multi-region Amerika Serikat | us * |
us (multi-region) * |
| Eropa | Belgia | europe-west1 |
eu (multi-region) |
| Eropa | London | europe-west2 |
|
| Eropa | Frankfurt | europe-west3 |
|
| Asia Pasifik | Singapura | asia-southeast1 |
|
| 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 (lebih disukai) 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 bergantung pada endpoint region tunggal AS yang ada. |
| ¶ | Panggilan ke region global mungkin memiliki latensi yang lebih tinggi saat dipanggil dari luar Amerika Serikat. Pilih region yang lebih spesifik yang lebih dekat dengan layanan dan pengguna Anda, jika memungkinkan. |
Fitur yang tersedia untuk penayangan regional
| ID region | Peringkasan dengan bagian kustom v3.1/3.0 | Peringkasan dengan bagian kustom v2.1 | Peringkasan dengan bagian kustom v2.0/1.0 | Analisis Sentimen | (Proaktif) Bantuan Pengetahuan Generatif |
|---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | |
europe-west1 |
✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | |
europe-west3 |
✓ | ✓ | ✓ | ✓ | |
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
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 pesan dan percakapan.
- Peserta konversi.
- Saran yang ditampilkan oleh Asisten Agen.
- Masukan.
Batasan
Batasan berikut berlaku:
- Konsol Agent Assist belum 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 ditemukan di banyak dokumen referensi REST, hanya mendukung region
globaluntuk panggilan API.Transkripsi CCAI saat ini 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 Generative Knowledge Assist (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 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 lingkungan GOOGLE_APPLICATION_CREDENTIALS untuk memberikan kredensial ke library klien Anda. Lihat petunjuk penyiapan Dialogflow untuk mengetahui informasi selengkapnya tentang menetapkan variabel ini.
Jika Anda perlu memberikan kredensial manual dalam kode, satu langkah tambahan
diperlukan sebelum Anda dapat memanggil endpoint yang diregionalisasi. 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.