Regionalización y residencia de datos

Agent Assist proporciona residencia de datos para mantener tus datos en reposo de forma física dentro de una región o ubicación geográfica especificada. Cuando especificas una región, tus datos en reposo no se almacenan fuera de ella. Los precios son los mismos para todas las regiones.

Especificar una región es particularmente útil en los siguientes casos de uso:

  • Tu sistema tiene requisitos regulatorios o de políticas que rigen la ubicación de tus datos.
  • Las latencias de red pueden mejorarse cuando los datos se encuentran en la misma región que tus clientes. Por ejemplo, si los clientes de Bélgica usan europe-west1, pueden esperar una mejor latencia.

Regiones disponibles

Agrupación por país Ubicación geográfica ID de región ID de la región del almacén de datos
América Iowa us-central1 us (multirregión)
América Carolina del Sur us-east1
América Oregón us-west1
América Montreal northamerica-northeast1 global (multirregión)
América Estados Unidos (multirregión) us* us (multirregión) *
Europa Bélgica europe-west1 eu (multirregión)
Europa Londres europe-west2
Europa Fráncfort europe-west3
Europa Puerto de Ems europe-west4 eu (multirregión)
Europa Zúrich europe-west6 eu (multirregión)
Asia-Pacífico Singapur asia-southeast1
Asia-Pacífico Yakarta asia-southeast2 global (multirregión)
Asia-Pacífico Tokio asia-northeast1
Asia-Pacífico Bombay asia-south1
Asia-Pacífico Sídney australia-southeast1
Global Multirregional global (servicio global, datos en reposo en Estados Unidos) global (preferido) o sin región (predeterminado) ¶ global (multirregión) ¶
Símbolo Descripción
* Vertex AI no admite la ubicación multirregional "us". Como resultado, el uso de las funciones potenciadas por IA generativa de Agent Assist en la multirregión "us" se basará en los extremos existentes de la región única de EE.UU.
Las llamadas a la región de global pueden tener una latencia más alta cuando se realizan desde fuera de EE.UU. Si es posible, elige una región más específica que esté más cerca de tus servicios y usuarios.

Funciones disponibles para la publicación regional

ID de región Agente complementario Resúmenes con secciones personalizadas v6.0/5.0/4.0 Evaluación automática de resúmenes Análisis de opiniones (versión 3) Knowledge Assist generativo (proactivo) Crea tu propia asistencia (versión preliminar) Coach potenciado por IA
us-central1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
us-east1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
us-west1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
us ✓ ✓ ✓ ✓ ✓ ✓
northamerica-northeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west2 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west3 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west4 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west6 ✓ ✓ ✓ ✓ ✓ ✓
asia-southeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
asia-southeast2 ✓ ✓ ✓ ✓ ✓ ✓
asia-northeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
asia-south1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
australia-southeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
global ✓ ✓ ✓ ✓ ✓ ✓ ✓

Datos en reposo

Todos los datos de usuarios finales y usuarios desarrolladores de Agent Assist se incluyen en los datos en reposo. Por ejemplo:

Limitaciones

Se aplica la siguiente limitación:

  • La consola de Agent Assist no admite la regionalización. Solo puedes implementar la regionalización llamando a la API directamente.
  • El entrenamiento de modelos no admite la regionalización. Tus datos pueden enrutarse fuera de la región durante este proceso.

  • El Explorador de APIs, que se encuentra en muchos documentos de referencia de REST, solo admite la región global para las llamadas a la API.

  • Actualmente, CCAI Transcription solo admite datos en uso y datos en reposo multirregionales (si no se usa la función Speech Adaptation) en la UE, EE.UU. y Norteamérica (Canadá).

  • Solo se admiten las siguientes regiones para los almacenes de datos, que utiliza la función de asistencia de conocimiento generativo (proactiva): global, us multirregional y eu multirregional.

  • La fundamentación con la Búsqueda de Google (GWGS) no admite la residencia de datos (DRZ). Cuando se habilita, este control no se aplica a las solicitudes de búsqueda. Para obtener más información, consulta Controles de seguridad de Gemini Enterprise Agent Platform.

Especifica una región con la API

Para usar la regionalización, debes especificar una región para cada solicitud a la API.

Campos obligatorios:

  • Proporciona el ID de región para el parámetro de ruta de URL location.

  • Para la región global, usa dialogflow.googleapis.com para el nombre de host. Para todas las demás regiones, usa [region-id]-dialogflow.googleapis.com para el nombre de host.

Por ejemplo:

  • dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id

  • us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id

Para usar bibliotecas cliente, se requieren los siguientes pasos:

  • Establece el extremo del servicio en REGION_ID-dialogflow.googleapis.com.

  • Establece el nombre del recurso con la ubicación correcta, por ejemplo:

    projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id

Credenciales

Te recomendamos que uses la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para proporcionar credenciales a tus bibliotecas cliente. Consulta las instrucciones de configuración de Dialogflow para obtener más información sobre cómo establecer esta variable.

Si, en cambio, necesitas proporcionar credenciales manuales en tu código, se requiere un paso adicional antes de que puedas llamar a un endpoint regionalizado. Debes establecer el alcance en https://www.googleapis.com/auth/cloud-platform cuando generes tus credenciales de autenticación. En el siguiente ejemplo, se muestra cómo hacerlo en Java cuando se crea un objeto GoogleCredentials:

    GoogleCredentials.fromStream(new FileInputStream("credential_file"))
      .createScoped("https://www.googleapis.com/auth/cloud-platform")

Cloud Logging

Consulta la documentación de Cloud Logging para controlar la región en la que se almacenan tus registros.