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 ist je nach Sprache unterschiedlich. 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 | Agenten-Regions-ID | 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 auf generativer KI basierenden Funktionen von Dialogflow CX in den multiregionalen Standorten us oder eu über die jeweiligen vorhandenen Endpunkte in den Einzelregionen „US“ oder „EU“ verwendet. 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 Kontingente für generative KI. |
| ¶ | 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-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 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.
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.
Cloud Logging
Informationen zum Steuern der Region, in der Logs gespeichert werden, finden Sie in der Anleitung für Cloud Logging.