Residenza dei dati

Questa pagina spiega in che modo l'API Conversational Analytics supporta la residenza dei dati. La residenza dei dati si riferisce alla posizione fisica dei dati e agli impegni di archiviare ed elaborare i dati all'interno di un'area geografica specifica per soddisfare i requisiti normativi o di policy. Per controllare la località dei dati, devi specificare un endpoint di servizio regionale per le richieste API.

In questo documento, il termine località si riferisce a una Google Cloud regione o a più regioni in cui risiedono i dati, mentre l'espressione i tuoi dati ha lo stesso significato di "Dati del cliente" nella sezione Località dei dati dei Termini di servizio specifici.

Gli impegni di residenza dei dati per l'API Conversational Analytics variano a seconda che l'agente si connetta a BigQuery o a Looker.

Ambito della residenza dei dati

L'API Conversational Analytics ti aiuta a soddisfare i requisiti di residenza dei dati fornendo controlli sulla località dei dati dei clienti in diversi stati:

  • I dati sono a riposo quando vengono archiviati in uno spazio di archiviazione permanente, anziché essere elaborati o trasmessi attivamente.
  • I dati sono in uso quando si trovano in memoria, ad esempio quando i modelli di machine learning (ML) elaborano i dati per generare una risposta o quando il servizio esegue una query. Per l'API Conversational Analytics, gli impegni di residenza dei dati in uso sono specifici per l'elaborazione ML giurisdizionale e non forniscono una residenza completa per tutti gli stati dei dati in uso.
  • I dati sono in transito quando entrano o escono dal perimetro della rete Google.

Gli impegni di residenza dei dati per l'API Conversational Analytics si applicano alle risorse DataAgent (incluse configurazioni dei clienti, contesto, istruzioni di sistema e query di esempio) e alle risorse Conversation (inclusi contenuti dei messaggi e cronologia degli stati). Questi impegni non si applicano ai dati di servizio, come identificatori ed etichette delle risorse, o ai dati in transito.

Località dei dati supportate

L'API Conversational Analytics supporta località globali, regionali e multi-regionali. Quando utilizzi un endpoint regionale o multiregionale, controlli la località in cui i dati vengono archiviati a riposo.

Nelle tabelle seguenti, l'elaborazione di machine learning (ML) giurisdizionale (identificata come In uso (giurisdizionale)) si riferisce agli impegni di elaborazione ML per i tuoi dati. Come definito nei Termini di servizio specifici, Google esegue l'elaborazione di machine learning dei tuoi dati solo nella regione o nelle regioni selezionate.

Le sezioni seguenti forniscono dettagli sul supporto per la residenza dei dati per agenti e conversazioni che utilizzano BigQuery e Looker origini dati.

Dati BigQuery

Per gli agenti di dati che si connettono a BigQuery, gli endpoint regionali e multiregionali supportano la residenza dei dati a riposo e l'elaborazione ML giurisdizionale per i dati in uso. Indipendentemente dalla località dell'endpoint specificata, l'agente può connettersi ai set di dati BigQuery in qualsiasi località o combinazione di località:

Località Descrizione della località Tipo di endpoint URL endpoint Posizione del set di dati Supporto per la residenza dei dati
global Globale Globale geminidataanalytics.googleapis.com Qualsiasi regione o multi-regione Non supportata
eu Unione Europea A più regioni geminidataanalytics.eu.rep.googleapis.com Qualsiasi regione o multi-regione A riposo, In uso (giurisdizionale)
us Stati Uniti A più regioni geminidataanalytics.us.rep.googleapis.com Qualsiasi regione o multi-regione A riposo, In uso (giurisdizionale)
us-east4 Virginia del Nord Regionale geminidataanalytics-us-east4.googleapis.com Qualsiasi regione o multi-regione A riposo, In uso (giurisdizionale)

Dati Looker

Per gli agenti di dati che si connettono a Looker, gli endpoint regionali e multi-regionali supportano la residenza dei dati at-rest. Indipendentemente dalla località dell'endpoint specificata, l'agente può connettersi alle origini dati in qualsiasi località o combinazione di località:

Località Descrizione della località Tipo di endpoint URL endpoint Posizione del set di dati Supporto per la residenza dei dati
global Globale Globale geminidataanalytics.googleapis.com Qualsiasi regione o multi-regione Non supportata
eu Unione Europea A più regioni geminidataanalytics.eu.rep.googleapis.com Qualsiasi regione o multi-regione A riposo, In uso (giurisdizionale)
us Stati Uniti A più regioni geminidataanalytics.us.rep.googleapis.com Qualsiasi regione o multi-regione A riposo
us-east4 Virginia del Nord Regionale geminidataanalytics-us-east4.googleapis.com Qualsiasi regione o multi-regione A riposo

Per l'elenco completo degli endpoint regionali e multi-regionali disponibili, consulta Località dell'API Conversational Analytics.

Applicare la residenza dei dati con gli endpoint regionali

Per applicare la residenza dei dati per le risorse DataAgent e Conversation, utilizza un endpoint regionale quando le crei e vi accedi. Gli endpoint di servizio per l'API Conversational Analytics utilizzano i seguenti formati, a seconda del tipo di località:

  • Globale: geminidataanalytics.googleapis.com
  • Multi-regionale: geminidataanalytics.LOCATION.rep.googleapis.com
  • Regionale: geminidataanalytics-LOCATION.googleapis.com

Sostituisci il segnaposto LOCATION con una regione singola o multi-regione supportata, ad esempio eu, us o us-east4.

Gli esempi seguenti mostrano come configurare un endpoint regionale per le richieste HTTP e SDK Python:

HTTP

Per utilizzare un endpoint regionale con HTTP, crea l'URL della richiesta con l'URL di base regionale. Innanzitutto, configura base_url in modo che utilizzi l'endpoint regionale scelto, come mostrato nell'esempio seguente da Configurare le impostazioni iniziali e l'autenticazione:

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"

Quindi, utilizza la variabile base_url quando crei gli URL per le richieste API, come in questo esempio da Porre domande con chat con stato e senza stato:

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

SDK Python

Per utilizzare un endpoint regionale con l'SDK Python, passa client_options con il parametro api_endpoint regionale quando inizializzi i client API, come mostrato nell'esempio seguente da Configurare le impostazioni e inizializzare i client.

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)

Sostituisci i valori di esempio come segue:

  • PROJECT_ID: l' Google Cloud ID progetto.
  • LOCATION: la regione o la multi-regione in cui vuoi creare le risorse. Per utilizzare uno degli endpoint regionali, specifica eu, us o us-east4.

Limitazioni

Quando utilizzi gli endpoint regionali, tieni presente quanto segue:

Passaggi successivi