Regionalización y configuración de la ubicación

Cuando creas un agente, debes especificar una región como la ubicación del agente. Los servicios de Google en esta región controlan las solicitudes que se envían a tu agente, y los agentes conversacionales (Dialogflow CX) mantienen los datos en reposo de forma física dentro de la región o ubicación geográfica. Para obtener el mejor rendimiento, debes elegir una región que esté cerca de tus servicios y usuarios finales.

Una vez que se crea un agente, su ubicación no puede cambiar. Para cambiar la ubicación del agente, debes exportar y restablecer a un agente nuevo con una ubicación diferente.

Cada ubicación tiene una configuración asociada que se aplica a todo tu proyecto. En la mayoría de los casos, no es necesario editar esta configuración, y la configuración predeterminada funcionará bien. Si tu sistema requiere claves de encriptación administradas por el cliente (que suelen requerir las entidades gubernamentales o las industrias reguladas), lee más sobre la configuración de la ubicación.

Limitaciones

Se aplica la siguiente limitación:

Regiones disponibles

Los agentes conversacionales (Dialogflow CX) admiten las siguientes regiones para la ubicación del agente. Los agentes de almacenes de datos admiten un subconjunto de estas regiones, y los IDs de región que usan los almacenes de datos difieren ligeramente de las regiones de los agentes. Los agentes de almacenes de datos de Vertex AI Conversation admiten todas las regiones con un valor para la columna ID de región del almacén de datos.

Agrupación por país Ubicación geográfica ID de la región del agente ID de la región del almacén de datos
América Iowa us-central1 us (multirregión)
América Montreal northamerica-northeast1
América Carolina del Sur us-east1
América Oregón us-west1
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 Sídney australia-southeast1
Asia-Pacífico Tokio asia-northeast1
Asia-Pacífico Bombay asia-south1
Asia-Pacífico Singapur asia-southeast1
Global Multirregional global (entrega global, datos en reposo en Estados Unidos) global (opción preferida) o sin región (configuración predeterminada) global (multirregión) ¶

Puedes obtener más información sobre las regiones que usa Google Cloud en regiones de Google Cloud y Geografía y regiones de Google Cloud.

Configuración de la ubicación

Si tu sistema requiere claves de encriptación administradas por el cliente (a menudo requeridas por entidades gubernamentales o industrias reguladas), puedes usar los parámetros de ubicación para configurar este atributo.

Esta configuración se comparte en todo el proyecto, y cada ubicación única tiene su propia configuración de la ubicación. Una vez que se establece la configuración de una ubicación específica en un proyecto, no se puede cambiar la ubicación de esa ubicación. Si necesitas cambiar esta configuración, debes crear un proyecto nuevo.

Si creas un agente sin editar la configuración de ubicación, esta se establecerá para esa ubicación y no se podrá cambiar para el proyecto. Además, una vez que se crea un agente, su ubicación no puede cambiar. Para cambiar la ubicación del agente, debes exportar y restablecer a un agente nuevo con una ubicación diferente.

Las siguientes opciones de configuración de la ubicación están disponibles:

  • Encriptación: Esta configuración controla si se usan claves de encriptación administradas por Google o administradas por el cliente para proteger los datos. La opción predeterminada es Google. Debes solicitar acceso (comunícate con tu representante de Google) a la función de claves de encriptación administradas por el cliente para cambiar esta configuración.

Hay dos formas de configurar las opciones de ubicación y son las siguientes:

Especifica una región con la API

Debes especificar una región para todas las solicitudes a la API.

Sigue estas indicaciones para las llamadas REST:

  • 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/projects/{PROJECT_ID}/locations/global/agents/{AGENT_ID}

  • us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}

En el caso de las bibliotecas cliente, consulta la documentación de las bibliotecas cliente para acceder la opción de configuración de una región.

Puedes encontrar ejemplos en la guía de inicio rápido de la API.

Cloud Logging

Consulta la guía de Cloud Logging para controlar la región en la que se almacenan los registros.