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. Wenn beispielsweise Kunden in Belgien europe-west1 verwenden, können sie mit einer besseren Latenz rechnen.

Verfügbare Regionen

Ländergruppierung Geografischer Ort Regions-ID Datenspeicher-Regions-ID
Amerika Iowa us-central1 us (mehrere Regionen)
Amerika South Carolina us-east1
Amerika Oregon us-west1
Amerika Montreal northamerica-northeast1 global (mehrere Regionen)
Amerika 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 Global (mehrere Regionen) (globale Bereitstellung, inaktive 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 für die Verwendung der generativen KI-Funktionen von Agent Assist in der Multiregion „us“ die entsprechenden vorhandenen Endpunkte für einzelne Regionen in den USA verwendet.
Aufrufe an die Region global können von außerhalb der USA eine höhere Latenz haben. Bevorzugen Sie nach Möglichkeit eine spezifischere Region, die näher an Ihren Diensten und Nutzern liegt.

Verfügbare Funktionen für die regionale Bereitstellung

Regions-ID Zusammenfassung mit benutzerdefinierten Abschnitten, Version 6.0/5.0/4.0 Automatische Zusammenfassungsbewertung (Vorabversion) Sentimentanalyse (Version 3) (Proaktiver) generativer Wissensassistent Eigener Assistent (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 Console unterstützt keine Regionalisierung. Sie können die Regionalisierung nur implementieren, indem Sie die API direkt aufrufen.
  • Das Modelltraining unterstützt keine Regionalisierung. Ihre Daten werden bei diesem Vorgang möglicherweise außerhalb der Region weitergeleitet.

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

  • CCAI Transcription unterstützt nur multiregionale Daten in Verwendung und ruhende Daten (wenn die Funktion zur Sprachanpassung nicht verwendet wird) in der EU, den USA und Nordamerika (Kanada).

  • Für Datenspeicher, die von der Funktion (Proaktiver) generativer Wissensassistent verwendet werden, werden nur die folgenden Regionen unterstützt: global, us (mehrere Regionen) und eu (mehrere Regionen).

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 dialogflow.googleapis.com als Hostnamen. 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

Für die Verwendung von Clientbibliotheken sind die folgenden Schritte erforderlich:

  • 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 GOOGLE_APPLICATION_CREDENTIALS Umgebungsvariable zu verwenden, um Ihre Clientbibliotheken mit Anmeldedaten zu versorgen. 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 bei der Generierung der Anmeldedaten für die Authentifizierung auf https://www.googleapis.com/auth/cloud-platform festlegen. Das folgende Beispiel zeigt, wie Sie dies in Java beim Erstellen eines GoogleCredentials-Objekts tun:

    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.