Regionalisierung und Standorteinstellungen

Wenn Sie einen Agent erstellen, müssen Sie eine Region als Standort des Agents angeben. An Ihren Agent gesendete Anfragen werden von Google-Diensten in dieser Region verarbeitet und Conversational Agents (Dialogflow CX) sorgen dafür, dass ruhende Daten bleiben. sich innerhalb der geografischen Region oder des geografischen Standorts befinden. 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 vom Kunden verwaltete 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 language [Sprache]. Weitere Informationen finden Sie in der Einschränkungen für Systementitäten .

• Die APIs Explorer gefunden auf vielen REST-Referenzdokumente unterstützt nur die Region global für API-Aufrufe.

Verfügbare Regionen

Wichtig :Bei generativen Modellen erfolgt die Verarbeitung durch maschinelles Lernen (ML) in den USA, wenn Anfragen an regional verfügbare APIs in den USA gestellt werden, oder innerhalb der EU, wenn Anfragen an regional verfügbare APIs in Europa gestellt werden. Weitere Informationen zu unterstützten Regionen finden Sie in der Vertex AI-Dokumentation.

Konversations-Agents (Dialogflow CX) unterstützen die folgenden Regionen für den Agent-Standort. Datenspeicher-Agents unterstützen nur einen Teil dieser Regionen und die von Datenspeicher verwendeten Regions-IDs unterscheiden sich geringfügig von den Agent-Regionen. Alle Regionen mit einem Wert in der Spalte „Regions-ID des Datenspeichers“ 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
Amerika	South Carolina	us-east1
Amerika	Oregon	us-west1
Nord- und Südamerika	USA (mehrere Regionen)	us *	us (mehrere Regionen) *
Europa	Belgien	europe-west1	eu (mehrere Regionen)
Europa	London	europe-west2
Europa	Frankfurt	europe-west3
Asiatisch-pazifischer Raum	Sydney	australia-southeast1
Asiatisch-pazifischer Raum	Tokio	asia-northeast1
Asiatisch-pazifischer Raum	Mumbai	asia-south1
Asiatisch-pazifischer Raum	Singapur	asia-southeast1
Global	Globale Multiregion (globale Bereitstellung, ruhende Daten in den USA)	global (bevorzugt) oder keine Region (Standardeinstellung) ¶	global (mehrere Regionen) ¶

Symbole	Beschreibung
*	Vertex AI unterstützt den multiregionalen Standort „us“ nicht. Die Nutzung der generativen KI-Funktionen von Conversational Agents (Dialogflow CX) in „uns“ hat dazu geführt, Multiregion basiert auf den jeweiligen vorhandenen US-Endpunkten für eine einzelne Region.
¶	Aufrufe an die Region global können eine höhere Latenz haben, wenn sie von außerhalb der USA aufgerufen werden. Wählen Sie nach Möglichkeit eine spezifischere Region aus, 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.

Hinweis: Der Endpunkt us-dialogflow.googleapis.com und die Ressource locations/us Standort, der als Alias für die Ressourcen der Region global diente, sind eingestellt seit dem 21. Mai 2024. Informationen zur korrekten Angabe der Region global finden Sie unter Versionshinweise

Standorteinstellungen

Wenn Ihr System vom Kunden verwaltete 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, können die Einstellungen für diesen Standort nicht mehr geändert werden. Wenn Sie diese Einstellungen ändern müssen, müssen Sie ein neues Projekt erstellen.

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 vom Kunden verwaltete 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 vom Kunden verwaltete 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 Standorteinstellungen nicht mit der API aktualisiert werden.

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 den multiregionalen Standort us usa-dialogflow.googleapis.com als Hostnamen. Verwenden Sie für alle anderen Regionen [region-id]-dialogflow.googleapis.com als Hostnamen.

Beispiel:

• usa-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us/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.