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), us (obsoleta) o ninguna región (predeterminada) |
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 us
.
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
. - Usa el nombre de host específico de la región con el formato
REGION_ID-dialogflow.googleapis.com
. Por ejemplo:asia-northeast1-dialogflow.googleapis.com
. Se rechazará la solicitud si la región especificada en el nombre de host no coincide con la región especificada en la ruta de URL.
En el caso de las bibliotecas cliente, consulta la documentación de las bibliotecas cliente. Debe seguir estos pasos:
Configura el extremo del servicio de Dialogflow de la siguiente manera:
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
Por ejemplo:
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto de Google Cloud.
- REGION_ID: Es un ID de región, por ejemplo:
europe-west2
. - SESSION_ID: Es un ID de sesión.
HTTP method and URL:
POST https://REGION_ID-dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID:detectIntent
Cuerpo JSON de la solicitud:
{ "query_input": { "text": { "text": "I want a pony.", "language_code": "en-US" } } }
Para enviar tu solicitud, expande una de estas opciones:
Java
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Dialogflow, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Idiomas adicionales
C#: sigue lasinstrucciones de configuración de C# en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Dialogflow para .NET.
PHP: sigue las instrucciones de configuración de PHP en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Dialogflow para PHP.
Ruby: sigue las instrucciones de configuración de Ruby en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Dialogflow para Ruby.
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:
- Integraciones
- Conectores de conocimiento
- Agentes compilados previamente
- Charla
- Herramienta de entrenamiento
El Explorador de APIs, que se encuentra en muchos documentos de referencia de REST, solo es compatible con la región global
para las llamadas a la API.