Regionalisierung und Datenstandort

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 Kundinnen und Kunden, kann das die Netzwerklatenz 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. Wenn möglich, sollten Sie eine spezifischere Region verwenden, 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 Bewertung der Zusammenfassung Sentimentanalyse (Version 3) (Proaktiver) Generative Knowledge Assist Eigene Unterstützung 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 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 aktive und im Ruhezustand befindliche Daten (wenn die Funktion zur Sprachanpassung nicht verwendet wird) in der EU, den USA und Nordamerika (Kanada).

  • Für Datenspeicher, die von der Funktion (Proactive) Generative Knowledge Assist verwendet werden, werden nur die folgenden Regionen unterstützt: global, us (mehrere Regionen) und eu (mehrere Regionen).

  • Die Fundierung mit der Google Suche (Grounding with Google Search, GWGS) unterstützt keinen Datenstandort. Wenn diese Option aktiviert ist, gilt diese Kontrolle nicht für Suchanfragen. Weitere Informationen finden Sie unter Sicherheitskontrollen für die Gemini Enterprise-Agentenplattform.

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

Wenn Sie Clientbibliotheken verwenden möchten, 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 Einrichtungsanleitung für Dialogflow.

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. Sie müssen den Bereich bei der Generierung der Anmeldedaten für die Authentifizierung auf https://www.googleapis.com/auth/cloud-platform festlegen. Im folgenden Beispiel wird gezeigt, 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.