Residência dos dados

Esta página explica como a API Conversational Analytics oferece suporte à residência de dados. A residência de dados se refere à localização física dos seus dados e aos compromissos de armazenar e processar seus dados em uma área geográfica específica para atender aos requisitos regulatórios ou de política. Para controlar a localização dos dados, especifique um endpoint de serviço regional para suas solicitações de API.

Neste documento, local se refere a uma Google Cloud região ou multirregião em que os dados residem, e seus dados têm o mesmo significado de "Dados do cliente" na seção Local dos dados dos Termos Específicos do Serviço.

Os compromissos de residência de dados para a API Conversational Analytics variam de acordo com a conexão do seu agente com o BigQuery ou o Looker.

Escopo da residência de dados

A API Conversational Analytics ajuda você a atender aos requisitos de residência de dados, oferecendo controles sobre a localização dos dados dos clientes em diferentes estados:

  • Os dados estão em repouso quando são armazenados em um armazenamento permanente, em vez de serem processados ou transmitidos ativamente.
  • Os dados estão em uso quando estão na memória, como quando os modelos de machine learning (ML) processam dados para gerar uma resposta ou quando o serviço executa uma consulta. Para a API Conversational Analytics, os compromissos de residência de dados em uso são específicos do tratamento de ML jurisdicional e não oferecem residência abrangente para todos os estados de dados em uso.
  • Os dados estão em trânsito quando entram ou saem do perímetro da rede do Google.

Os compromissos de residência de dados da API Conversational Analytics se aplicam aos recursos DataAgent (incluindo configurações do cliente, contexto, instruções do sistema e consultas de exemplo) e Conversation (incluindo conteúdo da mensagem e histórico de estado). Esses compromissos não se aplicam a dados de serviço, como identificadores e rótulos de recursos, nem a dados em trânsito.

Locais de dados compatíveis

A API Conversational Analytics é compatível com locais globais, regionais e multirregionais. Ao usar um endpoint regional ou multirregional, você controla o local em que os dados são armazenados em repouso.

Nas tabelas a seguir, o processamento jurisdicional de machine learning (ML), identificado como Em uso (jurisdicional), se refere aos compromissos de processamento de ML para seus dados. Conforme definido nos Termos específicos do serviço, o Google realiza o processamento de machine learning dos seus dados apenas na região ou multirregião selecionada.

As seções a seguir fornecem detalhes sobre o suporte à residência de dados para agentes e conversas que usam fontes de dados do BigQuery e do Looker.

Dados do BigQuery

Para agentes de dados que se conectam ao BigQuery, os endpoints regionais e multirregionais oferecem suporte à residência de dados em repouso e ao tratamento de ML jurisdicional para dados em uso. Independente do local do endpoint especificado, o agente pode se conectar a conjuntos de dados do BigQuery em qualquer local ou combinação de locais:

Local Descrição do local Tipo de endpoint URL do endpoint Local do conjunto de dados Suporte à residência de dados
global Global Global geminidataanalytics.googleapis.com Qualquer região ou multirregião Sem suporte
eu União Europeia Multirregional geminidataanalytics.eu.rep.googleapis.com Qualquer região ou multirregião Em repouso, Em uso (jurisdicional)
us Estados Unidos Multirregional geminidataanalytics.us.rep.googleapis.com Qualquer região ou multirregião Em repouso, Em uso (jurisdicional)
us-east4 Norte da Virgínia Regional geminidataanalytics-us-east4.googleapis.com Qualquer região ou multirregião Em repouso, Em uso (jurisdicional)

Dados do Looker

Para agentes de dados que se conectam ao Looker, os endpoints regionais e multirregionais oferecem suporte à residência de dados em repouso. Independente do local do endpoint especificado, o agente pode se conectar a fontes de dados em qualquer local ou combinação de locais:

Local Descrição do local Tipo de endpoint URL do endpoint Local do conjunto de dados Suporte à residência de dados
global Global Global geminidataanalytics.googleapis.com Qualquer região ou multirregião Sem suporte
eu União Europeia Multirregional geminidataanalytics.eu.rep.googleapis.com Qualquer região ou multirregião Em repouso, Em uso (jurisdicional)
us Estados Unidos Multirregional geminidataanalytics.us.rep.googleapis.com Qualquer região ou multirregião Em repouso
us-east4 Norte da Virgínia Regional geminidataanalytics-us-east4.googleapis.com Qualquer região ou multirregião Em repouso

Para conferir a lista completa de endpoints regionais e multirregionais disponíveis, consulte Locais da API Conversational Analytics.

Aplicar a residência de dados com endpoints regionais

Para aplicar a residência de dados aos recursos do DataAgent e do Conversation, use um endpoint regional ao criá-los e acessá-los. Os endpoints de serviço da API Conversational Analytics usam os seguintes formatos, dependendo do tipo de local:

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

Substitua o marcador de posição LOCATION por uma região única ou multirregião compatível, como eu, us ou us-east4.

Os exemplos a seguir mostram como configurar um endpoint regional para solicitações HTTP e do SDK do Python:

HTTP

Para usar um endpoint regional com HTTP, crie o URL da solicitação com o URL base regional. Primeiro, configure o base_url para usar o endpoint regional escolhido, conforme mostrado no exemplo a seguir em Configurar as configurações iniciais e a autenticação:

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"

Em seguida, use a variável base_url ao criar URLs para solicitações de API, como neste exemplo de Fazer perguntas com chat com e sem estado:

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

SDK do Python

Para usar um endpoint regional com o SDK do Python, transmita client_options com o parâmetro regional api_endpoint ao inicializar clientes de API, como mostrado no exemplo a seguir em Configurar definições e inicializar clientes.

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)

Substitua os valores de exemplo da seguinte forma:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: a região ou multirregião em que você quer criar seus recursos. Para usar um dos endpoints regionais, especifique eu, us ou us-east4.

Limitações

Ao usar endpoints regionais, considere os seguintes pontos:

A seguir