Cuando creas un agente, debes especificar una región como ubicación del agente. Los servicios de Google gestionan las solicitudes enviadas a tu agente en esta región y los agentes conversacionales (Dialogflow CX) conservan los datos en reposo físicamente en 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, no se puede cambiar su ubicación. Para cambiar la ubicación de un agente, debes exportar y restaurar a un nuevo agente con una ubicación diferente.
Cada ubicación tiene ajustes asociados que se aplican a todo el proyecto. En la mayoría de los casos, no es necesario editar estos ajustes de ubicación y la configuración predeterminada funcionará correctamente. Si su sistema requiere claves de cifrado gestionadas por el cliente (a menudo, las exigen las entidades públicas o los sectores regulados), consulte más información sobre los ajustes de ubicación.
Limitaciones
Se aplican las siguientes limitaciones:
La compatibilidad con las distintas integraciones de telefonía puede variar según la región. Consulta la documentación de cada integración.
La compatibilidad con entidades del sistema varía en función del idioma. Para obtener más información, consulta las limitaciones de las entidades del sistema.
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
Conversational Agents (Dialogflow CX) admite las siguientes regiones para la ubicación de los agentes. Los agentes de almacén de datos también se admiten en las regiones que se indican en la siguiente tabla, pero los IDs de región que usan los almacenes de datos difieren ligeramente de los de los agentes (como se indica). Los agentes de almacén de datos de Vertex AI Conversation admiten todas las regiones en las que se haya introducido un valor en la columna ID de región del almacén de datos.
| Agrupación de países | Ubicación geográfica | ID de región del agente | ID de región del almacén de datos |
|---|---|---|---|
| América | Iowa | us-central1 |
us (multirregional) |
| América | Montreal | northamerica-northeast1 |
global (multirregional) |
| América | Carolina del Sur | us-east1 |
us (multirregional) |
| América | Oregón | us-west1 |
us (multirregional) |
| América | Estados Unidos (multirregional) | us * |
us (multirregional) |
| Europa | Bélgica | europe-west1 |
eu (multirregional) |
| Europa | Londres | europe-west2 |
eu (multirregional) |
| Europa | Fráncfort | europe-west3 |
eu (multirregional) |
| Europa | Países Bajos | europe-west4 |
eu (multirregional) |
| Europa | Zúrich | europe-west6 |
eu (multirregional) |
| Asia-Pacífico | Sídney | australia-southeast1 |
global (multirregional) |
| Asia-Pacífico | Tokio | asia-northeast1 |
global (multirregional) |
| Asia-Pacífico | Bombay | asia-south1 |
global (multirregional) |
| Asia-Pacífico | Singapur | asia-southeast1 |
global (multirregional) |
| Asia-Pacífico | Yakarta | asia-southeast2 |
global (multirregional) |
| Global | Multirregión global (servicio global, datos en reposo en Estados Unidos) | global (preferida) o ninguna región (predeterminada) ¶ |
global (multirregional) ¶ |
| Símbolo | Descripción |
|---|---|
| * | Vertex AI no admite la ubicación multirregión "us". Por lo tanto, para usar las funciones de IA generativa de Conversational Agents (Dialogflow CX) en la multirregión "us", se utilizarán los puntos finales de la región única de EE.UU. correspondientes. |
| ¶ | Las llamadas a la región global pueden tener una latencia mayor si 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 consultar más información sobre las regiones que usa Google Cloud en Regiones de Google Cloud y Geografía y regiones de Google Cloud.
Ajustes de ubicación
Si tu sistema requiere claves de cifrado gestionadas por el cliente (a menudo, las exigen entidades públicas o sectores regulados), puedes usar los ajustes de ubicación para configurar esta función.
Los ajustes de ubicación se comparten en todo el proyecto y cada ubicación única tiene sus propios ajustes.
Una vez que se han configurado los ajustes de una ubicación concreta para un proyecto, se crea un dialogflow.googleapis.com/LocationSettings
recurso inmutable y los ajustes no se pueden cambiar para esa ubicación. Si necesitas cambiar estos ajustes o eliminar 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 la ubicación, se configurará la ubicación predeterminada y no se podrá cambiar en el proyecto. Además, una vez que se crea un agente, su ubicación no se puede cambiar. Para cambiar la ubicación de un agente, debes exportar y restaurar a un nuevo agente con una ubicación diferente.
Puede usar los siguientes ajustes de ubicación:
- Cifrado: este ajuste controla si se usan claves de cifrado gestionadas por Google o por el cliente para proteger los datos. El valor predeterminado es "Gestionado por Google". Para cambiar este ajuste, debes solicitar acceso a la función claves de cifrado gestionadas por el cliente (ponte en contacto con tu representante de Google).
Puedes configurar los ajustes de ubicación de dos formas:
- Haz clic en Configuración de ubicación en la interfaz del selector de agentes.
- Haz clic en el botón Editar situado junto al menú desplegable Ubicación cuando crees un agente.
Especificar una región con la API
Debe especificar una región en todas las solicitudes a la API.
En el caso de las llamadas REST, debes hacer lo siguiente:
Proporciona el ID de la región para el parámetro de ruta de URL
location.En la región
global, usadialogflow.googleapis.compara el nombre de host. En el resto de las regiones, usa[region-id]-dialogflow.googleapis.compara 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 de cliente, consulta la documentación de la biblioteca de cliente para ver una opción de configuración de la región.
Puedes consultar 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.