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
globalpara las llamadas a la API.
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 recomendada) o ninguna región (predeterminada) ¶ |
global (multirregión) ¶ |
| Símbolo | Descripción |
|---|---|
| * | Vertex AI no admite la ubicación multirregional "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 de EE.UU. existentes. |
| ¶ | 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, 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:
- 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.compara el nombre de host. Para todas las demás 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 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.