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 se refiere 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 los requisitos de la política. Para controlar la ubicación de tus datos, debes especificar 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 los Términos de Servicio.

Los compromisos de residencia de 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 del cliente 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, por ejemplo, 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 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 a los recursos Conversation (incluido el contenido del mensaje y el historial de estado). Estos compromisos no se aplican a los datos de 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 los Términos de Servicio, Google realiza el procesamiento de aprendizaje automático de tus datos solo en la región o multirregión seleccionada.

En las siguientes secciones, se proporcionan detalles sobre la compatibilidad con la residencia de datos para agentes y 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)
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 para tus recursos 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 de la solicitud o el 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 el superior de la solicitud (como /locations/us o projects/PROJECT_ID/locations/us).

Los extremos de servicio para 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 o multirregión única admitida, como eu, us o us-east4.

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

HTTP

Para usar un extremo regional con HTTP, crea la URL de la solicitud con la URL base regional. Primero, configura el base_url para usar el extremo regional elegido, como se muestra en el siguiente ejemplo de Configura los parámetros iniciales 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 crees URLs para solicitudes a la API, como en este ejemplo de Haz preguntas con 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 api_endpoint regional cuando inicialices clientes de la API, como se muestra en el siguiente ejemplo de Configura los parámetros 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 Google Cloud proyecto de.
  • LOCATION: Es la región o multirregión en la que deseas crear tus recursos. Para usar uno de los extremos regionales, especifica eu, us o us-east4.

Limitaciones

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

¿Qué sigue?