Se usó la API de Cloud Translation para traducir esta página.

Regionalización y residencia de datos

Dialogflow proporciona residencia de datos para mantener tus datos en reposo de forma física dentro de una región o ubicación geográfica. Cuando se especifica una región, tus datos en reposo no se replican fuera de esta. Los precios son los mismos para todas las regiones.

Las regiones se usan por los siguientes motivos:

Tu sistema puede tener requisitos regulatorios o de políticas que rigen la ubicación de tus datos.
Las latencias de la red pueden mejorarse cuando los datos se encuentran en la misma región que tus clientes. Por ejemplo, si los clientes del Reino Unido usan europe-west2, pueden esperar una mejor latencia.

Datos en reposo

Todos los datos de usuario final y usuario de Dialogflow se incluyen en datos en reposo. Por ejemplo:

Todos los recursos de agente se configuran con la consola o la API (intents, entidades, etcétera)
Todas las opciones de configuración del agente se establecen con la consola o la API
Historial de consultas
Resultados de validación
Tareas de creación de modelos
Tareas de entrenamiento
Tareas de operaciones de larga duración

Regiones disponibles

Dialogflow proporciona las siguientes regiones:

Agrupación por país	Ubicación geográfica	ID de región
Europa	Bélgica	`europe-west1`
Europa	Londres	`europe-west2`
Asia-Pacífico	Sídney	`australia-southeast1`
Asia-Pacífico	Tokio	`asia-northeast1`
Global	La entrega de Dialogflow es global, los datos en reposo están dentro de EE.UU.	`global` (opción preferida) o ninguna región (predeterminada) *

Símbolo	Descripción
*	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.

Selecciona una región con la consola

El área superior izquierda de la consola de Dialogflow ES tiene un menú desplegable para seleccionar la región. Cada agente tiene una región inmutable que se especifica en el momento de su creación. Cuando seleccionas una región de la consola, solo puedes enumerar o crear agentes para la región seleccionada. La región predeterminada es global.

Selecciona una región con la API

Si tu agente se creó en una región no predeterminada, debes especificar esa región cuando llames a la API para las solicitudes de tiempo de diseño o entorno de ejecución.

Para proporcionar una región, suministra un parámetro location a las solicitudes a la API. Para las llamadas REST, haz lo siguiente:

Proporciona el parámetro de ruta de URL location. Para la región global, usa global.
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.

Ejemplos:

https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents/
https://asia-northeast1-dialogflow.googleapis.com/v2/projects/PROJECT/locations/asia-northeast1/agents/

En el caso de las bibliotecas cliente, consulta la documentación de las bibliotecas cliente. Debe seguir estos pasos:

Establece el extremo del servicio de Dialogflow en una de las siguientes opciones:
```
dialogflow.googleapis.com:443
REGION_ID-dialogflow.googleapis.com:443
```

Configura el nombre de la sesión de la siguiente manera:

projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID

Precaución: Como se describe en la documentación de 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.

Limitaciones

Cuando se selecciona una región no predeterminada en la consola de Dialogflow, las siguientes características no están disponibles:

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.

Operaciones de larga duración

Migrando