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
globalfü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) ¶ |
| Symbole | Beschreibung |
|---|---|
| * | Für Gemini 2.x-Modelle unterstützt Vertex AI die multiregionalen Standorte us und eu nicht. Daher werden die Funktionen basierend auf generativer KI von Dialogflow CX in den multiregionalen Standorten us oder eu über die jeweiligen vorhandenen Endpunkte in den USA oder der EU ausgeführt. Für Gemini 3 und neuere Modelle (z. B. gemini-3.1-flash-lite) werden die multiregionalen Standorte us und eu unterstützt und für US-amerikanische und europäische Regionen verwendet. Weitere Informationen finden Sie unter Generative Kontingente. |
| ¶ | Bei Aufrufen der Region global von außerhalb der USA kann es zu einer höheren Latenz kommen. Wählen Sie nach Möglichkeit eine spezifischere Region aus, die sich näher an Ihren Diensten und Endnutzern befindet. |
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:
- KlickenStandorteinstellungen aus demAgent-Selector-Schnittstelle finden Sie weitere Informationen.
- Klicken Sie beim Erstellen eines Agents neben dem Drop-down-Menü Standort auf den Button Bearbeiten.
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
locationan.Verwenden Sie für die Region
globalden Hostnamendialogflow.googleapis.com. Verwenden Sie für alle anderen Regionen[region-id]-dialogflow.googleapis.comals Hostnamen. Für die multiregionaleus-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:
Verwenden Sie
dialogflow.us.rep.googleapis.comals Hostnamen.Legen Sie den URL-Pfadparameter
locationaufusfest.
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.