Residencia de los datos

En esta página, se explica cómo la API de Conversational Analytics admite la residencia de datos. La residencia de datos hace referencia a la ubicación física de tus datos y a los compromisos de almacenarlos y procesarlos dentro de un área geográfica específica para cumplir con los requisitos reglamentarios o de las políticas. Para controlar la ubicación de tus datos, especifica un extremo de servicio regional para tus solicitudes a la API.

En este documento, ubicación se refiere a una Google Cloud región o multirregión en la que residen los datos, y tus datos tienen el mismo significado que "Datos del cliente" en la sección Ubicación de los datos de las Condiciones Específicas del Servicio.

Los compromisos de residencia de los datos para la API de Conversational Analytics varían según si tu agente se conecta a BigQuery o a Looker.

Alcance de la residencia de datos

La API de Conversational Analytics te ayuda a cumplir con los requisitos de residencia de datos, ya que proporciona controles sobre la ubicación de los datos de los clientes en diferentes estados:

  • Los datos están en reposo cuando se almacenan en un almacenamiento persistente, en lugar de procesarse o transmitirse de forma activa.
  • Los datos están en uso cuando están en la memoria, como cuando los modelos de aprendizaje automático (AA) procesan datos para generar una respuesta o cuando el servicio ejecuta una consulta. En el caso de la API de Conversational Analytics, los compromisos de residencia de datos para los datos en uso son específicos del procesamiento de AA jurisdiccional y no proporcionan una residencia integral para todos los estados de los datos en uso.
  • Los datos están en tránsito cuando entran o salen del perímetro de la red de Google.

Los compromisos de residencia de los datos para la API de Conversational Analytics se aplican a los recursos DataAgent (incluidas las configuraciones del cliente, el contexto, las instrucciones del sistema y las consultas de ejemplo) y los recursos Conversation (incluidos el contenido de los mensajes y el historial de estado). Estos compromisos no se aplican a los datos del servicio, como los identificadores y las etiquetas de recursos, ni a los datos en tránsito.

Ubicaciones de datos admitidas

La API de Conversational Analytics admite ubicaciones globales, regionales y multirregionales. Cuando usas un extremo regional o multirregional, controlas la ubicación en la que se almacenan tus datos en reposo.

En las siguientes tablas, el procesamiento de aprendizaje automático (AA) jurisdiccional (identificado como En uso (jurisdiccional)) se refiere a los compromisos de procesamiento de AA para tus datos. Como se define en las Condiciones específicas del servicio, Google realiza el procesamiento de aprendizaje automático de tus datos solo en la región o multirregión que seleccionaste.

En las siguientes secciones, se proporcionan detalles sobre la compatibilidad con la residencia de datos para los agentes y las conversaciones que usan fuentes de datos de BigQuery y Looker.

Datos de BigQuery

En el caso de los agentes de datos que se conectan a BigQuery, los extremos regionales y multirregionales admiten la residencia de datos para los datos en reposo y el procesamiento de AA jurisdiccional para los datos en uso. Independientemente de la ubicación del extremo que especifiques, el agente puede conectarse a conjuntos de datos de BigQuery en cualquier ubicación o combinación de ubicaciones:

Ubicación Descripción de la ubicación Tipo de extremo URL del extremo Ubicación del conjunto de datos Compatibilidad con la residencia de datos
global Global Global geminidataanalytics.googleapis.com Cualquier región o multirregión No compatible
eu Unión Europea Multirregional geminidataanalytics.eu.rep.googleapis.com Cualquier región o multirregión En reposo, En uso (jurisdiccional)
us Estados Unidos Multirregional geminidataanalytics.us.rep.googleapis.com Cualquier región o multirregión En reposo, En uso (jurisdiccional)
northamerica-northeast1 Montreal Regional geminidataanalytics-northamerica-northeast1.googleapis.com Cualquier región o multirregión En reposo, En uso (jurisdiccional)
northamerica-northeast2 Toronto Regional geminidataanalytics-northamerica-northeast2.googleapis.com Cualquier región o multirregión En reposo, En uso (jurisdiccional)
us-east4 Virginia del Norte Regional geminidataanalytics-us-east4.googleapis.com Cualquier región o multirregión En reposo, En uso (jurisdiccional)

Datos de Looker

En el caso de los agentes de datos que se conectan a Looker, los extremos regionales y multirregionales admiten la residencia de datos para los datos en reposo. Independientemente de la ubicación del extremo que especifiques, el agente puede conectarse a fuentes de datos en cualquier ubicación o combinación de ubicaciones:

Ubicación Descripción de la ubicación Tipo de extremo URL del extremo Ubicación del conjunto de datos Compatibilidad con la residencia de datos
global Global Global geminidataanalytics.googleapis.com Cualquier región o multirregión No compatible
eu Unión Europea Multirregional geminidataanalytics.eu.rep.googleapis.com Cualquier región o multirregión En reposo
us Estados Unidos Multirregional geminidataanalytics.us.rep.googleapis.com Cualquier región o multirregión En reposo
us-east4 Virginia del Norte Regional geminidataanalytics-us-east4.googleapis.com Cualquier región o multirregión En reposo

Para obtener la lista completa de los extremos regionales y multirregionales disponibles, consulta Ubicaciones de la API de Conversational Analytics.

Aplica la residencia de datos con extremos regionales

Para aplicar la residencia de datos a tus recursos de DataAgent y Conversation, usa un extremo regional cuando los crees y accedas a ellos. Cuando llamas a extremos regionales, la ubicación en la ruta de acceso o el elemento superior de la solicitud debe coincidir con la ubicación del extremo al que llamas. Por ejemplo, si llamas al extremo geminidataanalytics.us.rep.googleapis.com, debes especificar us en la ruta de acceso de la solicitud o en el elemento superior de la solicitud (como /locations/us o projects/PROJECT_ID/locations/us).

Los extremos de servicio de la API de Conversational Analytics usan los siguientes formatos, según el tipo de ubicación:

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

Reemplaza el marcador de posición LOCATION por una región admitida o multirregión para tu fuente de datos. Para obtener más detalles, consulta Ubicaciones de datos compatibles.

En los siguientes ejemplos, se muestra cómo configurar un extremo regional para las solicitudes HTTP y del SDK de Python:

HTTP

Para usar un extremo regional con HTTP, construye la URL de la solicitud con la URL base regional. Primero, configura el base_url para usar el extremo regional que elegiste, como se muestra en el siguiente ejemplo de Establece la configuración inicial y la autenticación:

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"

Luego, usa la variable base_url cuando construyas URLs para solicitudes a la API, como en este ejemplo de Haz preguntas con un chat con estado y sin estado:

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

Python SDK

Para usar un extremo regional con el SDK de Python, pasa client_options con el parámetro regional api_endpoint cuando inicialices los clientes de API, como se muestra en el siguiente ejemplo de Establece la configuración y, luego, inicializa los 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)

Reemplaza los valores de muestra de la siguiente manera:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION: Es la región o multirregión en la que deseas crear tus recursos. Para conocer las ubicaciones que admite cada fuente de datos, consulta Ubicaciones de datos compatibles.

Limitaciones

Cuando uses extremos regionales, ten en cuenta los siguientes puntos:

¿Qué sigue?