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:

• La compatibilidad de la región para diferentes integraciones de telefonía puede variar. Consulta la documentación de cada integración.

• La compatibilidad de las entidades del sistema es diferente para cada idioma. Si deseas obtener más detalles, consulta las limitaciones de entidades del sistema.

• 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.

Regiones disponibles

Importante: El compromiso de "Ubicación de datos de IA/AA" (residencia de datos para el procesamiento de AA) solo se admite en las ubicaciones de EE.UU. y la UE. El procesamiento de AA para modelos generativos puede ocurrir en cualquier ubicación de las multirregiones cuando se realizan solicitudes a las APIs regionales incluidas en una multirregión. Para obtener más información, consulta la documentación de Vertex AI.

Los agentes conversacionales (Dialogflow CX) admiten las siguientes regiones para la ubicación del agente. Los agentes de almacenes de datos también son compatibles con las regiones que se indican en la siguiente tabla, pero los IDs de región que usan los almacenes de datos difieren ligeramente de las regiones de los agentes (como se indica). Los agentes de almacén de datos de Vertex AI Conversation admiten todas las regiones con un valor ingresado en 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	global (multirregión)
América	Carolina del Sur	us-east1	us (multirregión)
América	Oregón	us-west1	us (multirregión)
América	Estados Unidos multirregión	us*	us (multirregión)
Europa	Bélgica	europe-west1	eu (multirregión)
Europa	Londres	europe-west2	eu (multirregión)
Europa	Fráncfort	europe-west3	eu (multirregión)
Europa	Países Bajos	europe-west4	eu (multirregión)
Europa	Zúrich	europe-west6	eu (multirregión)
Asia-Pacífico	Sídney	australia-southeast1	global (multirregión)
Asia-Pacífico	Tokio	asia-northeast1	global (multirregión)
Asia-Pacífico	Bombay	asia-south1	global (multirregión)
Asia-Pacífico	Singapur	asia-southeast1	global (multirregión)
Asia-Pacífico	Yakarta	asia-southeast2	global (multirregión)
Global	Multirregional global (entrega global, datos en reposo en Estados Unidos)	global (opción recomendada) o ninguna región (predeterminada) ¶	global (multirregión) ¶

Símbolo	Descripción
*	Vertex AI no admite la ubicación multirregión "us". Como resultado, el uso de las funciones de IA generativa de los agentes conversacionales (Dialogflow CX) en la multirregión "us" dependerá de los extremos de región única existentes de EE.UU.
¶	Las llamadas a la región global pueden tener una latencia más alta cuando se llaman 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 finales.

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, se crea un recurso dialogflow.googleapis.com/LocationSettings inmutable, y la configuración no se puede cambiar para esa ubicación. Si necesitas cambiar esta configuración o borrar el recurso, debes crear un proyecto nuevo.

Si necesitas permitir que los desarrolladores de tu organización configuren agentes solo en ubicaciones específicas, puedes configurar una política de la organización que incluya una restricción de ubicaciones de recursos.

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:

• Haz clic en Location settings en la interfaz del selector de agentes.
• Haz clic en el botón Edit junto al menú desplegable Location cuando crees un agente.

Nota: Actualmente, no puedes actualizar la configuración de ubicación con la API.

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.

Precaución: Como se describe en la documentación de la configuración, debes usar la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para proporcionar a tus bibliotecas cliente credenciales. Sin embargo, si necesitas proporcionar un archivo de credenciales en el código de forma manual, debes realizar un paso adicional cuando llames a un extremo regionalizado. Configura el permiso como https://www.googleapis.com/auth/cloud-platform cuando generes tus credenciales de autenticación. Por ejemplo, esto se logra 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 guía de Cloud Logging para controlar la región en la que se almacenan los registros.