Regionalisierung und Datenstandort

Agent Assist bietet einen Datenstandort, um Ihre inaktiven Daten physisch in einer bestimmten geografischen Region oder an einem bestimmten geografischen 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-west1 verwenden, können sie eine niedrigere Latenz erwarten.

Verfügbare Regionen

Ländergruppierung Geografischer Ort Regions-ID Datenspeicher-Regions-ID
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 global (mehrere Regionen)
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
Europa Eemshaven europe-west4 eu (mehrere Regionen)
Europa Zürich europe-west6 eu (mehrere Regionen)
Asiatisch-pazifischer Raum Singapur asia-southeast1
Asiatisch-pazifischer Raum Jakarta asia-southeast2 global (mehrere Regionen)
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 wird die Verwendung der generativen KI-Funktionen von Agent Assist in der multiregionalen Region „us“ auf den entsprechenden vorhandenen Endpunkten für einzelne Regionen in den USA basieren.
Anrufe in die Region global können von außerhalb der USA eine höhere Latenz haben. Bevorzugen Sie eine spezifischere Region, die näher an Ihren Diensten und Nutzern liegt.

Verfügbare Funktionen für die regionale Auslieferung

Regions-ID Zusammenfassung mit benutzerdefinierten Abschnitten – Version 4.0 Automatische Bewertung der Zusammenfassung (Vorabversion) Sentimentanalyse (Proaktive) generative Wissensunterstützung Eigene Assist-Funktion erstellen (Vorabversion) KI-Coach
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 ✓ ✓ ✓ ✓ ✓ ✓

Inaktive Daten

Alle Daten von Agent Assist-Entwicklern und ‑Endnutzern sind Teil der inaktiven Daten. Beispiel:

Beschränkungen

Es gelten folgende Einschränkungen:

  • Die Agent Assist-Konsole unterstützt keine Regionalisierung. Sie können die Regionalisierung nur durch direkten API-Aufruf implementieren.
  • Modelltraining unterstützt keine Regionalisierung. Ihre Daten werden während dieses Vorgangs möglicherweise außerhalb der Region weitergeleitet.

  • Der API-Explorer, der in vielen REST-Referenzdokumenten zu finden ist, unterstützt nur die Region global für API-Aufrufe.

  • CCAI Transcription unterstützt nur multiregionale Daten in Verwendung und inaktive Daten (wenn die Funktion „Speech Adaptation“ nicht verwendet wird) in der EU, den USA und Nordamerika (Kanada).

  • Für Datenspeicher, die von der Funktion „Proaktive generative Wissensunterstützung“ verwendet werden, werden nur die folgenden Regionen unterstützt: global, us-Multiregion und eu-Multiregion.

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 location an.

  • Verwenden Sie für die Region global den Hostnamen dialogflow.googleapis.com. Verwenden Sie für alle anderen Regionen [region-id]-dialogflow.googleapis.com als Hostnamen.

Beispiel:

  • dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id

  • us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id

So verwenden Sie Clientbibliotheken:

  • Legen Sie den Dienstendpunkt auf REGION_ID-dialogflow.googleapis.com fest.

  • Legen Sie den Ressourcennamen mit dem richtigen Standort 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 bereitzustellen. 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 regionalen Endpunkt aufrufen können. Legen Sie den Bereich beim Generieren der Anmeldedaten für die Authentifizierung auf https://www.googleapis.com/auth/cloud-platform fest. Das folgende Beispiel zeigt, wie Sie dies in Java beim Erstellen eines GoogleCredentials-Objekts erreichen:

    GoogleCredentials.fromStream(new FileInputStream("credential_file"))
      .createScoped("https://www.googleapis.com/auth/cloud-platform")

Cloud Logging

Informationen zum Steuern der Region, in der Ihre Logs gespeichert werden, finden Sie in der Cloud Logging-Dokumentation.