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 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:

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) ¶

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:

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 como el nombre de host. Para todas las demás regiones, usa [region-id]-dialogflow.googleapis.com en el nombre de host. Para la multirregión us, 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:

  1. Usa dialogflow.us.rep.googleapis.com para el nombre de host.

  2. Establece el parámetro de ruta de URL location en us.

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.