Agent Assist bietet einen Datenstandort, um Ihre inaktiven Daten physisch in einer bestimmten geografischen Region oder an einem bestimmten Ort aufzubewahren. Wenn Sie eine Region angeben, werden Ihre inaktiven Daten nicht außerhalb dieser Region gespeichert. Die Preise sind für alle Regionen gleich.
Die Angabe einer Region ist in den folgenden Anwendungsfällen besonders hilfreich:
- Für Ihr System gelten regulatorische oder Richtlinienanforderungen, die den Standort Ihrer Daten bestimmen.
- Befinden sich die Daten in derselben Region wie Ihre Kunden, kann das die Netzwerklatenzen verbessern. Beispiel: Wenn Kunden in Belgien
europe-west1verwenden, können sie eine niedrigere Latenz erwarten.
Verfügbare Regionen
| Ländergruppierung | Geografischer Ort | Regions-ID | ID der Speicherortregion des Datenspeichers |
|---|---|---|---|
| Nord- und Südamerika | Iowa | us-central1 |
us (mehrere Regionen) |
| Nord- und Südamerika | South Carolina | us-east1 |
|
| Amerika | Oregon | us-west1 |
|
| Nord- und Südamerika | Montreal | northamerica-northeast1 |
|
| Nord- und Südamerika | USA (mehrere Regionen) | us * |
us (mehrere Regionen) * |
| Europa | Belgien | europe-west1 |
eu (mehrere Regionen) |
| Europa | London | europe-west2 |
|
| Europa | Frankfurt | europe-west3 |
|
| Asiatisch-pazifischer Raum | Singapur | asia-southeast1 |
|
| Asiatisch-pazifischer Raum | Tokio | asia-northeast1 |
|
| Asiatisch-pazifischer Raum | Mumbai | asia-south1 |
|
| Asiatisch-pazifischer Raum | Sydney | australia-southeast1 |
|
| Global | Globale Multiregion (globale Bereitstellung, ruhende Daten in den USA) | global (bevorzugt) oder keine Region (Standard) ¶ |
global (mehrere Regionen) ¶ |
| Symbole | Beschreibung |
|---|---|
| * | Vertex AI unterstützt den multiregionalen Standort „us“ nicht. Daher werden die generativen KI-Funktionen von Agent Assist im multiregionalen Standort „us“ auf die entsprechenden Endpunkte der einzelnen US-Regionen zurückgreifen. |
| ¶ | Aufrufe an die Region global können von außerhalb der USA eine höhere Latenz haben. Wählen Sie nach Möglichkeit eine spezifischere Region aus, die näher an Ihren Diensten und Nutzern liegt. |
Verfügbare Funktionen für die regionale Verfügbarkeit
| Regions-ID | Zusammenfassung mit benutzerdefinierten Abschnitten (Version 3.1/3.0) | Sentimentanalyse | (Proaktive) generative Wissensunterstützung |
|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ |
us-west1 |
✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ |
northamerica-northeast1 |
✓ | ✓ | ✓ |
europe-west1 |
✓ | ✓ | ✓ |
europe-west2 |
✓ | ✓ | ✓ |
europe-west3 |
✓ | ✓ | ✓ |
asia-southeast1 |
✓ | ✓ | ✓ |
asia-northeast1 |
✓ | ✓ | ✓ |
asia-south1 |
✓ | ✓ | ✓ |
australia-southeast1 |
✓ | ✓ | ✓ |
global |
✓ | ✓ | ✓ |
Inaktive Daten
Alle Daten von Agent Assist-Entwicklern und -Endnutzern sind Teil der inaktiven Daten. Beispiel:
- Wissensdatenbanken und Wissensdokumente
- Unterhaltungsprofile
- Unterhaltungs- und Nachrichtenverlauf
- Conversion-Teilnehmer
- Von Agent Assist zurückgegebene Vorschläge.
- Feedbacks
Beschränkungen
Es gelten folgende Einschränkungen:
- Die Agent Assist Console unterstützt die Regionalisierung noch nicht. Sie können die Regionalisierung nur durch direkten API-Aufruf implementieren.
- Die Modellierung unterstützt keine Regionalisierung. Ihre Daten werden dabei möglicherweise außerhalb der Region weitergeleitet.
Der API Explorer, der in vielen REST-Referenzdokumenten zu finden ist, unterstützt nur die Region
globalfür API-Aufrufe.Die CCAI-Transkription unterstützt derzeit nur in der EU, in den USA und in Nordamerika (Kanada) Multi-Region-Daten in Verwendung und ruhende Daten (wenn die Funktion „Sprachadaption“ nicht verwendet wird).
Für Datenspeicher, die von der Funktion „(Proaktive) generative Wissensunterstützung“ verwendet werden, werden nur die folgenden Regionen unterstützt:
global,us(multiregional) undeu(multiregional).
Region mit der API angeben
Wenn Sie die Regionalisierung verwenden möchten, müssen Sie für jede API-Anfrage eine Region angeben.
Pflichtfelder:
Geben Sie die Regions-ID für den URL-Pfadparameter
locationan.Verwenden Sie für die Region
globaldialogflow.googleapis.comals Hostnamen. Verwenden Sie für alle anderen Regionen[region-id]-dialogflow.googleapis.comals Hostnamen.
Beispiel:
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
Für die Verwendung von Clientbibliotheken sind die folgenden Schritte erforderlich:
- Legen Sie den Dienstendpunkt auf
REGION_ID-dialogflow.googleapis.comfest. Legen Sie den Ressourcennamen mit dem richtigen Speicherort fest, z. B.:
projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id
Anmeldedaten
Wir empfehlen, die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS zu verwenden, um Ihren Clientbibliotheken Anmeldedaten zur Verfügung zu stellen. Weitere Informationen zum Festlegen dieser Variablen finden Sie in der Dialogflow-Einrichtungsanleitung.
Wenn Sie stattdessen manuelle Anmeldedaten in Ihrem Code angeben müssen, ist ein zusätzlicher Schritt erforderlich, bevor Sie einen regionalisierten Endpunkt aufrufen können. Sie müssen den Bereich auf https://www.googleapis.com/auth/cloud-platform festlegen, wenn Sie Ihre Anmeldedaten für die Authentifizierung generieren. Das folgende Beispiel zeigt, wie dies in Java beim Erstellen eines GoogleCredentials-Objekts funktioniert:
GoogleCredentials.fromStream(new FileInputStream("credential_file"))
.createScoped("https://www.googleapis.com/auth/cloud-platform")
Cloud Logging
Informationen zum Steuern der Region, in der Logs gespeichert werden, finden Sie in der Cloud Logging-Dokumentation.