Regionalisierung und Standorteinstellungen

Wenn Sie einen Agent erstellen, müssen Sie eine Region als Standort des Agents angeben. Anfragen, die an Ihren Agent gesendet werden, werden von Google-Diensten in dieser Region verarbeitet und Dialogflow CX speichert inaktive Daten physisch in der geografischen Region oder am entsprechenden Standort. Für eine optimale Leistung sollten Sie eine Region in der Nähe Ihrer Dienste und Endnutzer auswählen.

Nachdem ein Agent erstellt wurde, kann dessen Speicherort nicht mehr geändert werden. Wenn Sie den Standort eines Agents ändern möchten, müssen Sie einen neuen Agent mit einem anderen Standort erstellen und den Agent dorthin exportieren und wiederherstellen.

Jedem Standort sind Einstellungen zugeordnet, die für Ihr Projekt gelten. In den meisten Fällen müssen Sie diese Standorteinstellungen nicht bearbeiten und die Standardeinstellungen funktionieren gut. Wenn Ihr System kundenverwaltete Verschlüsselungsschlüssel benötigt und diese häufig von Behörden oder regulierten Branchen benötigt werden, finden Sie weitere Informationen zu Standorteinstellungen.

Beschränkungen

Es gelten folgende Einschränkungen:

• Die Regionsunterstützung für verschiedene Telefonieintegrationen kann variieren. Prüfen Sie die Dokumentation für jede Integration.

• Die Unterstützung der Systementität ist für jede Sprache unterschiedlich. Weitere Informationen finden Sie unter Einschränkungen der Systementität.

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

Verfügbare Regionen

Wichtig :Die Verpflichtung Standort der KI-/ML-Daten> (Data Residency for ML Processing) wird nur an Standorten in den USA und der EU unterstützt. Die Verarbeitung von maschinellem Lernen für generative Modelle kann an jedem Standort in den Multiregionen erfolgen, wenn Anfragen an regionale APIs gesendet werden, die in einer Multiregion enthalten sind. Weitere Informationen finden Sie in der Dokumentation zu Vertex AI.

Dialogflow CX unterstützt die folgenden Regionen für den Agent-Standort. Datenspeicher-Agents werden auch in den Regionen unterstützt, die in der folgenden Tabelle aufgeführt sind. Die von Datenspeichern verwendeten Regions-IDs unterscheiden sich jedoch geringfügig von den Agent-Regionen (wie aufgeführt). Alle Regionen mit einem Wert in der Spalte Data store region ID werden von Datenspeicher-Agents in Vertex AI Conversation unterstützt.

Ländergruppierung	Geografischer Ort	Agent-Regions-ID	Datenspeicher-Regions‑ID
Nord- und Südamerika	Iowa	us-central1	us (mehrere Regionen)
Nord- und Südamerika	Montreal	northamerica-northeast1	global (mehrere Regionen)
Nord- und Südamerika	South Carolina	us-east1	us (mehrere Regionen)
Nord- und Südamerika	Oregon	us-west1	us (mehrere Regionen)
Nord- und Südamerika	USA (mehrere Regionen)	us *	us (mehrere Regionen)
Europa	Belgien	europe-west1	eu (mehrere Regionen)
Europa	London	europe-west2	eu (mehrere Regionen)
Europa	Frankfurt	europe-west3	eu (mehrere Regionen)
Europa	Niederlande	europe-west4	eu (mehrere Regionen)
Europa	Zürich	europe-west6	eu (mehrere Regionen)
Asiatisch-pazifischer Raum	Sydney	australia-southeast1	global (mehrere Regionen)
Asiatisch-pazifischer Raum	Tokio	asia-northeast1	global (mehrere Regionen)
Asiatisch-pazifischer Raum	Mumbai	asia-south1	global (mehrere Regionen)
Asiatisch-pazifischer Raum	Singapur	asia-southeast1	global (mehrere Regionen)
Asiatisch-pazifischer Raum	Jakarta	asia-southeast2	global (mehrere Regionen)
Global	Global multiregional (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 bei der Verwendung der Funktionen für generative KI von Dialogflow CX in der multiregionalen Region „us“ auf die entsprechenden vorhandenen Endpunkte für einzelne Regionen in den USA zurückgegriffen.
¶	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 Endnutzern liegt.

Weitere Informationen zu den von Google Cloud verwendeten Regionen finden Sie unter Google Cloud-Regionen und Google Cloud-Geografie und -Regionen.

Standorteinstellungen

Wenn Ihr System kundenverwaltete Verschlüsselungsschlüssel benötigt (häufig von staatlichen Einrichtungen oder regulierten Branchen erforderlich), können Sie die Standorteinstellungen verwenden, um dieses Feature zu konfigurieren.

Standorteinstellungen werden im gesamten Projekt verwendet und jeder eindeutige Standort hat eigene Standorteinstellungen.

Wenn die Einstellungen für einen bestimmten Standort für ein Projekt konfiguriert sind, wird eine unveränderliche dialogflow.googleapis.com/LocationSettings-Ressource erstellt und die Einstellungen für diesen Standort können nicht mehr geändert werden. Wenn Sie diese Einstellungen ändern oder die Ressource löschen möchten, müssen Sie ein neues Projekt erstellen.

Wenn Sie den Entwicklern Ihrer Organisation erlauben möchten, Agents nur an bestimmten Standorten zu konfigurieren, können Sie eine Organisationsrichtlinie mit einer Einschränkung der Ressourcenstandorte einrichten.

Wenn Sie einen Agent erstellen, ohne die Standorteinstellungen zu bearbeiten, werden die Standardeinstellungen für diesen Standort konfiguriert und können für das Projekt nicht mehr geändert werden. Nachdem ein Agent erstellt wurde, kann sich dessen Standort nicht mehr ändern. Wenn Sie den Standort eines Agents ändern möchten, müssen Sie einen neuen Agent mit einem anderen Standort erstellen und den Agent dorthin exportieren und wiederherstellen.

Folgende Standorteinstellungen sind verfügbar:

• Verschlüsselung: Diese Einstellung steuert, ob von Google verwaltete oder kundenverwaltete Verschlüsselungsschlüssel zum Schutz von Daten verwendet werden. Die Standardeinstellung ist von Google verwaltet. Sie müssen den Zugriff auf das Feature für kundenverwaltete Verschlüsselungsschlüssel anfordern, indem Sie Ihren Google-Ansprechpartner kontaktieren.

Sie haben zwei Möglichkeiten, um Standorteinstellungen zu konfigurieren:

• KlickenStandorteinstellungen aus demAgent-Selector-Schnittstelle finden Sie weitere Informationen.
• Klicken Sie beim Erstellen eines Agents neben dem Drop-down-Menü Standort auf die Schaltfläche Bearbeiten.

Hinweis :Derzeit können Sie Standorteinstellungen nicht mit der API aktualisieren.

Region mit der API angeben

Sie müssen eine Region für alle API-Anfragen angeben.

Bei REST-Aufrufen müssen Sie beide Schritte ausführen:

• 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/projects/{PROJECT_ID}/locations/global/agents/{AGENT_ID}

• us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}

Informationen zu Regionskonfigurationen im Fall von Clientbibliotheken finden Sie in der Dokumentation zur Clientbibliothek.

Beispiele finden Sie in der API-Kurzanleitung.

Achtung: Wie in der Einrichtungsdokumentation beschrieben, sollten Sie die GOOGLE_APPLICATION_CREDENTIALS-Umgebung zur Bereitstellung von Anmeldedaten für Ihre Clientbibliotheken verwenden. Wenn Sie jedoch manuell eine Datei mit Anmeldedaten in Ihrem Code angeben müssen, ist beim Aufruf eines regionalen Endpunkts ein zusätzlicher Schritt erforderlich. Legen Sie den Bereich bei der Generierung der Anmeldedaten für die Authentifizierung auf https://www.googleapis.com/auth/cloud-platform fest. Dies wird beispielsweise in Java beim Erstellen eines GoogleCredentials-Objekts erreicht:

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 Anleitung für Cloud Logging.