Regionalisierung und Standorteinstellungen

Wenn Sie einen Agent erstellen, müssen Sie eine Region als Standort des Agents angeben. Anfragen, die an Ihren Agenten gesendet werden, werden von Google-Diensten in dieser Region verarbeitet. Dialogflow CX speichert ruhende Daten physisch in der geografischen Region oder am geografischen 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 von Systementitäten unterscheidet sich je nach Sprache. Weitere Informationen finden Sie unter Einschränkungen für Systementitäten.

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

Verfügbare Regionen

Dialogflow CX unterstützt die folgenden Regionen für den Agentenstandort. Datenspeicher-Agenten 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 Agentenregionen (wie aufgeführt). Alle Regionen, für die in der Spalte Datenspeicher-Regions-ID ein Wert eingegeben wurde, werden von Datenspeicher-KI-Agenten in Vertex AI Agents unterstützt.

Ländergruppierung Geografischer Ort Regions-ID des Agenten Regions-ID des Datenspeichers
Nord- und Südamerika Iowa us-central1 us (multiregional)
Nord- und Südamerika Montreal northamerica-northeast1 global (multiregional)
Nord- und Südamerika South Carolina us-east1 us (multiregional)
Nord- und Südamerika Oregon us-west1 us (multiregional)
Nord- und Südamerika USA, multiregional us * us (multiregional)
Europa Belgien europe-west1 eu (multiregional)
Europa London europe-west2 eu (multiregional)
Europa Frankfurt europe-west3 eu (multiregional)
Europa Niederlande europe-west4 eu (multiregional)
Europa Zürich europe-west6 eu (multiregional)
Asiatisch-pazifischer Raum Sydney australia-southeast1 global (multiregional)
Asiatisch-pazifischer Raum Tokio asia-northeast1 global (multiregional)
Asiatisch-pazifischer Raum Mumbai asia-south1 global (multiregional)
Asiatisch-pazifischer Raum Singapur asia-southeast1 global (multiregional)
Asiatisch-pazifischer Raum Jakarta asia-southeast2 global (multiregional)
Global Globale Multiregion (globale Bereitstellung, ruhende Daten in den USA) global (bevorzugt) oder keine Region (Standard) ¶ global (multiregional) ¶

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.

Sobald 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 den Entwicklern Ihrer Organisation erlauben möchten, Agenten nur an bestimmten Standorten zu 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-Kontaktperson/Mitarbeiter (in case of representation: Vertreter von Google) kontaktieren.

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

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. Für die multiregionale us-Region können Sie auch den multiregionalen US-Endpunkt verwenden.

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.

Multiregionalen Endpunkt in den USA verwenden

Wenn sich Ihre Agenten in der Multiregion us befinden, können Sie API-Anfragen an den multiregionalen Endpunkt für die USA (dialogflow.us.rep.googleapis.com) senden. Ein multiregionaler Endpunkt beendet TLS und verarbeitet Ihre Anfragen innerhalb der Multiregion, sodass Ihre Anfragedaten während der Übertragung in den USA bleiben. Die Verwendung dieses Endpunkts ändert nichts daran, wo Ihre Agentendaten gespeichert werden. Weitere Informationen finden Sie im Google Cloud -Sicherheitsleitfaden unter Regionale und multiregionale API-Endpunkte – Übersicht.

Wenn Sie den multiregionalen Endpunkt in den USA verwenden möchten, nehmen Sie die folgenden Änderungen an jeder Anfrage vor:

  1. Verwenden Sie dialogflow.us.rep.googleapis.com als Hostnamen.

  2. Legen Sie den URL-Pfadparameter location auf us fest.

Beispiel:

  • dialogflow.us.rep.googleapis.com/v3/projects/{PROJECT_ID}/locations/us/agents/{AGENT_ID}

Verwenden Sie den multiregionalen Endpunkt „US“ nur für Ressourcen am Standort us. Verwenden Sie für Ressourcen an anderen Standorten, einschließlich us-central1, us-east1 und us-west1, den Hostnamen für diesen Standort.

Wenn Sie den multiregionalen Endpunkt in den USA mit den Clientbibliotheken verwenden möchten, legen Sie die API-Endpunktoption des Clients auf dialogflow.us.rep.googleapis.com fest. In Python übergeben Sie beispielsweise client_options={"api_endpoint": "dialogflow.us.rep.googleapis.com"}, wenn Sie den Client erstellen. Wenn Sie Terraform verwenden, setzen Sie das Feld dialogflow_cx_custom_endpoint des Google-Anbieters auf https://dialogflow.us.rep.googleapis.com/v3/. Mit dieser Einstellung werden alle Dialogflow CX-Anfragen des Anbieters an den multiregionalen US-Endpunkt gesendet. Verwenden Sie sie daher nur für Ressourcen am Standort us.

Eine Liste der regionalen und multiregionalen Dienstendpunkte finden Sie im Virtual Private Cloud-Leitfaden unter Regionale und multiregionale Dienstendpunkte.

Cloud Logging

Informationen zum Steuern der Region, in der Logs gespeichert werden, finden Sie in der Anleitung für Cloud Logging.