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 enviadas a tu agente, y Dialogflow CX mantiene los datos en reposo físicamente 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 con entidades del sistema varía según el idioma. Consulta las limitaciones de las entidades del sistema para obtener más detalles.
El Explorador de APIs, que se encuentra en muchos documentos de referencia de REST, solo admite la región
globalpara las llamadas a la API.
Regiones disponibles
Dialogflow CX admite las siguientes regiones para la ubicación del agente. Los agentes de almacén de datos también se admiten en las regiones que se indican en la siguiente tabla, pero los ID de la región que usan los almacenes de datos difieren un poco de las regiones de los agentes (como se indica). Todas las regiones con un valor ingresado en la columna ID de la región del almacén de datos son compatibles con los agentes del almacén de datos en Vertex AI Agents.
| 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 | Multirregión de Estados Unidos | 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 (preferida) o sin región (predeterminada) ¶ |
global (multirregión) ¶ |
| Símbolo | Descripción |
|---|---|
| * | Para los modelos de Gemini 2.x, Vertex AI no admite las ubicaciones multirregionales us ni eu. Como resultado, el uso de las funciones potenciadas por IA generativa de Dialogflow CX en las multirregiones us o eu depende de los extremos de región única existentes de EE.UU. o la UE, respectivamente. Para Gemini 3 y modelos posteriores (como gemini-3.1-flash-lite), se admiten las ubicaciones multirregionales us y eu, y se usan para las regiones de EE.UU. y Europa. Para obtener más información, consulta Cuotas de IA generativa. |
| ¶ | Las llamadas a la región 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 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 para 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 establecer 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: Este parámetro de configuración controla si se usan claves de encriptación administradas por Google o claves de encriptación 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.
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, usadialogflow.googleapis.comcomo el nombre de host. Para todas las demás regiones, usa[region-id]-dialogflow.googleapis.comen el nombre de host. Para la multirregiónus, también puedes usar el extremo multirregional de EE.UU..
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.
Usa el extremo multirregional de EE.UU.
Si tus agentes se encuentran en la multirregión us, puedes enviar solicitudes a la API al extremo multirregional de EE.UU., dialogflow.us.rep.googleapis.com. Un
extremo multirregional finaliza TLS y procesa tus solicitudes dentro de la
multirregión, por lo que los datos de tu solicitud permanecen en EE.UU. mientras están en tránsito. El uso de este extremo no cambia la ubicación en la que se almacenan los datos de tu agente. Para obtener
más información, consulta
Descripción general de los extremos de API regionales y multirregionales
en la guía de seguridad de Google Cloud .
Para usar el extremo multirregional de EE.UU., realiza los siguientes cambios en cada solicitud:
Usa
dialogflow.us.rep.googleapis.compara el nombre de host.Establece el parámetro de ruta de URL
locationenus.
Por ejemplo:
dialogflow.us.rep.googleapis.com/v3/projects/{PROJECT_ID}/locations/us/agents/{AGENT_ID}
Usa el extremo multirregional de EE.UU. solo para los recursos de la ubicación us.
Para los recursos en otras ubicaciones, incluidas us-central1, us-east1 y
us-west1, usa el nombre de host de esa ubicación.
Para usar el extremo multirregional de EE.UU. con las bibliotecas cliente, establece la opción de extremo de API
del cliente en dialogflow.us.rep.googleapis.com. Por
ejemplo, en Python, pasa
client_options={"api_endpoint": "dialogflow.us.rep.googleapis.com"} cuando
creas el cliente. Si usas Terraform, establece el campo dialogflow_cx_custom_endpoint
del proveedor de Google en
https://dialogflow.us.rep.googleapis.com/v3/. Ese parámetro de configuración envía todas las
solicitudes de Dialogflow CX del proveedor al extremo multirregional de EE.UU., por lo que debes usarlo
solo para los recursos de la ubicación us.
Para obtener la lista de extremos de servicio regionales y multirregionales, consulta Extremos de servicio regionales y multirregionales en la guía de nube privada virtual.
Cloud Logging
Consulta la guía de Cloud Logging para controlar la región en la que se almacenan los registros.