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 la 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
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
Asia-Pacífico Singapur asia-southeast1
Asia-Pacífico Tokio asia-northeast1
Asia-Pacífico Bombay asia-south1
Asia-Pacífico Sídney australia-southeast1
Global Multirregional global (entrega global, datos en reposo en Estados Unidos) global (opción recomendada) o ninguna región (predeterminada) ¶ global (multirregión) ¶

Funciones disponibles para la publicación regional

ID de región Resumen con secciones personalizadas v3.1/3.0 Resumen con secciones personalizadas v2.1 Resumen con secciones personalizadas v2.0/1.0 Análisis de opiniones Knowledge Assist generativo (proactivo)
us-central1
us-east1
us-west1
us
northamerica-northeast1
europe-west1
europe-west2
europe-west3
asia-southeast1
asia-northeast1
asia-south1
australia-southeast1
global

Datos en reposo

Todos los datos de usuario final y usuario de desarrollador de Agent Assist se incluyen en los datos en reposo. Por ejemplo:

Limitaciones

Se aplica la siguiente limitación:

  • La consola de Agent Assist aún no admite la regionalización. Solo puedes implementar la regionalización llamando a la API directamente.
  • La capacitación de modelos no admite la regionalización. Es posible que tus datos se enruten fuera de la región durante este proceso.
  • El Explorador de API, que se encuentra en muchos documentos de referencia de REST, solo admite la región global para las llamadas a la API.

  • Actualmente, la transcripción de la IA conversacional solo admite datos multirregionales en uso y datos en reposo (si no se usa la función de adaptación de voz) en la UE, EE.UU. y Norteamérica (Canadá).

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

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 las 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 configurar esta variable.

En cambio, si necesitas proporcionar credenciales manuales en tu código, se requiere un paso adicional antes de que puedas llamar a un extremo regionalizado. Debes configurar el permiso como 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.