Datenstandort

Auf dieser Seite wird beschrieben, wie die Conversational Analytics API die Datenstandort-Anforderungen unterstützt. Der Datenstandort bezieht sich auf den physischen Speicherort Ihrer Daten und die Verpflichtungen, Ihre Daten in einem bestimmten geografischen Gebiet zu speichern und zu verarbeiten, um regulatorische oder Richtlinienanforderungen zu erfüllen. Wenn Sie den Speicherort Ihrer Daten kontrollieren möchten, geben Sie für Ihre API-Anfragen einen regionalen Dienstendpunkt an.

In diesem Dokument bezieht sich Datenstandort auf eine Google Cloud Region oder Multiregion, in der sich Daten befinden, und Ihre Daten hat dieselbe Bedeutung wie „Kundendaten“ im Abschnitt Datenstandort der dienstspezifischen Nutzungsbedingungen.

Die Zusicherungen zur Datenaufbewahrung für die Conversational Analytics API variieren je nachdem, ob Ihr KI-Agent eine Verbindung zu BigQuery oder Looker herstellt.

Umfang des Datenstandorts

Mit der Conversational Analytics API können Sie die Anforderungen an den Datenstandort erfüllen, da Sie den Speicherort von Kundendaten in verschiedenen Zuständen steuern können:

  • Daten sind ruhend, wenn sie in einem nichtflüchtigen Speicher gespeichert sind und nicht aktiv verarbeitet oder übertragen werden.
  • Daten sind in Verwendung, wenn sie sich im Arbeitsspeicher befinden, z. B. wenn Modelle für maschinelles Lernen Daten verarbeiten, um eine Antwort zu generieren, oder wenn der Dienst eine Abfrage ausführt. Für die Conversational Analytics API gelten die Zusicherungen zum Datenstandort für verwendete Daten nur für die ML-Verarbeitung in der jeweiligen Gerichtsbarkeit. Sie bieten keinen umfassenden Datenstandort für alle Zustände der verwendeten Daten.
  • Daten befinden sich bei der Übertragung, wenn sie in den Netzwerkperimeter von Google gelangen oder diesen verlassen.

Die Zusicherungen zur Datenresidenz für die Conversational Analytics API gelten für DataAgent-Ressourcen (einschließlich Kundenkonfigurationen, Kontext, Systemanweisungen und Beispielabfragen) und Conversation-Ressourcen (einschließlich Nachrichteninhalten und Statusverlauf). Diese Zusicherungen gelten nicht für Dienstdaten wie Ressourcenkennungen und Labels oder für Daten bei der Übertragung.

Unterstützte Datenspeicherorte

Die Conversational Analytics API unterstützt globale, regionale und multiregionale Standorte. Wenn Sie einen regionalen oder multiregionalen Endpunkt verwenden, können Sie den Speicherort Ihrer ruhenden Daten steuern.

In den folgenden Tabellen bezieht sich die ML-Verarbeitung (Machine Learning) in der Gerichtsbarkeit (gekennzeichnet als In Verwendung (Gerichtsbarkeit)) auf die Verpflichtungen zur ML-Verarbeitung für Ihre Daten. Wie in den dienstspezifischen Nutzungsbedingungen definiert, führt Google die Verarbeitung Ihrer Daten durch maschinelles Lernen nur in der von Ihnen ausgewählten Region oder Multiregion durch.

In den folgenden Abschnitten finden Sie Details zur Unterstützung der Datenresidenz für KI-Agenten und Unterhaltungen, die BigQuery- und Looker-Datenquellen verwenden.

BigQuery-Daten

Bei Daten-Agents, die eine Verbindung zu BigQuery herstellen, unterstützen regionale und multiregionale Endpunkte den Datenstandort für inaktive Daten und die ML-Verarbeitung für aktive Daten. Unabhängig vom angegebenen Endpunktstandort kann der Agent eine Verbindung zu BigQuery-Datasets an jedem Standort oder jeder Kombination von Standorten herstellen:

Standort Standortbeschreibung Endpunkttyp Endpunkt-URL Dataset-Speicherort Unterstützung für den Datenstandort
global Global Global geminidataanalytics.googleapis.com Beliebige Region oder multiregionale Standorte Nicht unterstützt
eu Europäische Union Multiregional geminidataanalytics.eu.rep.googleapis.com Beliebige Region oder multiregionale Standorte Ruhend, aktiv (rechtlich)
us USA Multiregional geminidataanalytics.us.rep.googleapis.com Beliebige Region oder multiregionale Standorte Ruhend, aktiv (rechtlich)
asia-northeast1 Tokio Regional geminidataanalytics-asia-northeast1.googleapis.com Beliebige Region oder multiregionale Standorte Ruhend, aktiv (rechtlich)
northamerica-northeast1 Montreal Regional geminidataanalytics-northamerica-northeast1.googleapis.com Beliebige Region oder multiregionale Standorte Ruhend, aktiv (rechtlich)
northamerica-northeast2 Toronto Regional geminidataanalytics-northamerica-northeast2.googleapis.com Beliebige Region oder multiregionale Standorte Ruhend, aktiv (rechtlich)
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Beliebige Region oder multiregionale Standorte Ruhend, aktiv (rechtlich)

Looker-Daten

Bei KI-Datenagenten, die eine Verbindung zu Looker herstellen, unterstützen regionale und multiregionale Endpunkte die Datenresidenz für ruhende Daten. Unabhängig vom angegebenen Endpunktstandort kann der Agent eine Verbindung zu Datenquellen an einem beliebigen Standort oder einer beliebigen Kombination von Standorten herstellen:

Standort Standortbeschreibung Endpunkttyp Endpunkt-URL Dataset-Speicherort Unterstützung für den Datenstandort
global Global Global geminidataanalytics.googleapis.com Beliebige Region oder multiregionale Standorte Nicht unterstützt
eu Europäische Union Multiregional geminidataanalytics.eu.rep.googleapis.com Beliebige Region oder multiregionale Standorte In Ruhe
us USA Multiregional geminidataanalytics.us.rep.googleapis.com Beliebige Region oder multiregionale Standorte In Ruhe
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Beliebige Region oder multiregionale Standorte In Ruhe

Eine vollständige Liste der verfügbaren regionalen und multiregionalen Endpunkte finden Sie unter Standorte der Conversational Analytics API.

Datenstandort mit regionalen Endpunkten erzwingen

Wenn Sie die Datenstandortanforderungen für Ihre DataAgent- und Conversation-Ressourcen erzwingen möchten, verwenden Sie beim Erstellen und Zugreifen auf diese Ressourcen einen regionalen Endpunkt. Wenn Sie regionale Endpunkte aufrufen, muss der Standort im Anfragepfad oder im übergeordneten Element der Anfrage mit dem Standort des aufgerufenen Endpunkts übereinstimmen. Wenn Sie beispielsweise den Endpunkt geminidataanalytics.us.rep.googleapis.com aufrufen, müssen Sie us im Anfragepfad oder im übergeordneten Element der Anfrage angeben (z. B. /locations/us oder projects/PROJECT_ID/locations/us).

Die Dienstendpunkte für die Conversational Analytics API verwenden je nach Standorttyp die folgenden Formate:

  • Global: geminidataanalytics.googleapis.com
  • Multiregional: geminidataanalytics.LOCATION.rep.googleapis.com
  • Regional: geminidataanalytics-LOCATION.googleapis.com

Ersetzen Sie den Platzhalter LOCATION durch eine unterstützte Region oder Multiregion für Ihre Datenquelle. Weitere Informationen finden Sie unter Unterstützte Datenspeicherorte.

Die folgenden Beispiele zeigen, wie Sie einen regionalen Endpunkt für HTTP- und Python SDK-Anfragen konfigurieren:

HTTP

Wenn Sie einen regionalen Endpunkt mit HTTP verwenden möchten, erstellen Sie die Anfrage-URL mit der regionalen Basis-URL. Konfigurieren Sie zuerst den base_url so, dass der ausgewählte regionale Endpunkt verwendet wird, wie im folgenden Beispiel aus Anfängliche Einstellungen und Authentifizierung konfigurieren gezeigt:

project_id = "PROJECT_ID"
location = "LOCATION"

# Set the base URL based on location.
if not location or location == "global":
  base_url = "https://geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  base_url = f"https://geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  base_url = f"https://geminidataanalytics.{location}.rep.googleapis.com"

Verwenden Sie dann die Variable base_url, wenn Sie URLs für API-Anfragen erstellen, wie in diesem Beispiel aus Fragen mit zustandsorientiertem und zustandslosem Chat stellen:

# Example API request URL construction using base_url:
chat_url = f"{base_url}/v1beta/projects/{project_id}/locations/{location}:chat"

Python SDK

Wenn Sie einen regionalen Endpunkt mit dem Python SDK verwenden möchten, übergeben Sie beim Initialisieren von API-Clients client_options mit dem regionalen Parameter api_endpoint, wie im folgenden Beispiel unter Einstellungen konfigurieren und Clients initialisieren gezeigt.

from google.cloud import geminidataanalytics
from google.api_core import client_options

project_id = "PROJECT_ID"
location = "LOCATION"

# Set client options based on location.
if not location or location == "global":
  endpoint = "geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  endpoint = f"geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  endpoint = f"geminidataanalytics.{location}.rep.googleapis.com"
opts = client_options.ClientOptions(api_endpoint=endpoint)

# Use client options when initializing API clients.
data_agent_client = geminidataanalytics.DataAgentServiceClient(client_options=opts)
data_chat_client = geminidataanalytics.DataChatServiceClient(client_options=opts)

# Use clients to make API requests. For example:
# response = data_chat_client.chat(request=request)

Ersetzen Sie die Beispielwerte so:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION: Die Region oder Multiregion, in der Sie Ihre Ressourcen erstellen möchten. Informationen zu den von den einzelnen Datenquellen unterstützten Speicherorten finden Sie unter Unterstützte Datenspeicherorte.

Beschränkungen

Beachten Sie bei der Verwendung regionaler Endpunkte Folgendes:

  • Wenn Sie kundenverwaltete Verschlüsselungsschlüssel (CMEK) mit der Conversational Analytics API verwenden, muss sich Ihr Cloud KMS-Schlüssel an einem Standort befinden, der mit Ihrem regionalen Endpunkt kompatibel ist. Bei einer einzelnen Region muss sich der Schlüssel in derselben Region befinden. Für die Multiregionen us und eu hängt der erforderliche Schlüsselspeicherort vom Ressourcentyp ab. Weitere Informationen finden Sie unter Standortanforderungen.

Nächste Schritte