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 ruhende Daten physisch in der geografischen Region oder an dem 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 API-Explorer, der in vielen REST-Referenzdokumentenzu finden ist, unterstützt nur die global Region für API-Aufrufe.

Verfügbare Regionen

**Wichtig**: Die Verpflichtung „AI/ML Data Location“ (Datenstandort für ML-Verarbeitung) wird nur an den Standorten in den USA und der EU unterstützt. Die ML-Verarbeitung 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 Vertex AI-Dokumentation.

Dialogflow CX unterstützt folgende 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, für die in der Spalte Datenspeicher-Regions-ID ein Wert eingegeben wurde, werden von Datenspeicher Agents in Vertex AI Agents 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	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. Wenn Sie die Funktionen für generative KI von Dialogflow CX in der Multiregion „us“ verwenden, werden daher 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 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 können für diesen Standort 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 zulassen möchten, dass die Entwickler Ihrer Organisation Agents nur an bestimmten Standorten konfigurieren, können Sie eine Organisationsrichtlinie mit einer Einschränkung für 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 Standort Drop-down-Menü auf den Bearbeiten Button.

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 dialogflow.googleapis.com als Hostnamen. 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 Umgebungsvariable verwenden, um Anmeldedaten für Ihre Clientbibliotheken bereitzustellen. 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.