Asistente proporciona residencia de datos para mantener tus datos en reposo físicamente en una región o ubicación geográfica específica. Cuando especificas una región, tus datos en reposo no se almacenan fuera de esa región. Los precios son los mismos en todas las regiones.
Especificar una región es especialmente útil en los siguientes casos prácticos:
- Tu sistema tiene requisitos normativos o de políticas que rigen dónde deben residir tus datos.
- La latencia de tu red puede mejorar si los datos se encuentran en la misma región que tus clientes. Por ejemplo, si los clientes de Bélgica usan
europe-west1, pueden esperar una latencia mejor.
Regiones disponibles
| Agrupación de países | Ubicación geográfica | ID de región | ID de región del almacén de datos |
|---|---|---|---|
| América | Iowa | us-central1 |
us (multirregional) |
| América | Carolina del Sur | us-east1 |
|
| América | Oregón | us-west1 |
|
| América | Montreal | northamerica-northeast1 |
global (multirregional) |
| América | Estados Unidos (multirregional) | us * |
us (varias regiones) * |
| Europa | Bélgica | europe-west1 |
eu (multirregional) |
| Europa | Londres | europe-west2 |
|
| Europa | Fráncfort | europe-west3 |
|
| Europa | Eemshaven | europe-west4 |
eu (multirregional) |
| Europa | Zúrich | europe-west6 |
eu (multirregional) |
| Asia-Pacífico | Singapur | asia-southeast1 |
|
| Asia-Pacífico | Yakarta | asia-southeast2 |
global (multirregional) |
| Asia-Pacífico | Tokio | asia-northeast1 |
|
| Asia-Pacífico | Bombay | asia-south1 |
|
| Asia-Pacífico | Sídney | australia-southeast1 |
|
| 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 Asistente en la multirregión "us", se utilizarán los endpoints 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. |
Funciones disponibles para el servicio regional
| ID de región | Summarization with custom sections v4.0 | Summarization with custom sections v3.1/3.0 | Evaluación automática de resúmenes (versión preliminar) | Análisis de sentimiento | Ayuda con conocimientos generativos (proactiva) | Crea tu propio asistente (versión preliminar) |
|---|---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
us |
✓ | ✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | ||
europe-west1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | ||
europe-west3 |
✓ | ✓ | ✓ | ✓ | ||
europe-west4 |
✓ | ✓ | ✓ | |||
europe-west6 |
✓ | ✓ | ✓ | |||
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | ||
asia-southeast2 |
✓ | ✓ | ✓ | |||
asia-northeast1 |
✓ | ✓ | ✓ | ✓ | ||
asia-south1 |
✓ | ✓ | ✓ | ✓ | ||
australia-southeast1 |
✓ | ✓ | ✓ | ✓ | ✓ | |
global |
✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Datos en reposo
Todos los datos de usuario desarrollador y de usuario final de Asistente se incluyen en los datos en reposo. Por ejemplo:
- Bases de conocimientos y documentos de conocimientos.
- Perfiles de conversación.
- Historiales de conversaciones y mensajes.
- Participantes en la conversión.
- Sugerencias devueltas por Asistente para agentes.
- Feedbacks.
Limitaciones
Se aplican las siguientes limitaciones:
- La consola Asistente no admite la regionalización. Solo puedes implementar la regionalización llamando directamente a la API.
- El entrenamiento de modelos no admite la regionalización. Es posible que tus datos se enruten fuera de la región durante este proceso.
API Explorer, que se encuentra en muchos documentos de referencia de REST, solo admite la región
globalpara las llamadas a la API.Transcripción de CCAI solo admite datos multirregionales en uso y datos en reposo (si no se usa la función de adaptación del habla) en la UE, EE. UU. y Norteamérica (Canadá).
Solo se admiten las siguientes regiones para los almacenes de datos que usa la función Asistencia con conocimientos generativos (proactiva):
global,usmultirregión yeumultirregión.
Especificar una región mediante la API
Para usar la regionalización, debe especificar una región en cada solicitud de la API.
Campos obligatorios:
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/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_idus-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id
Para usar bibliotecas de cliente, debes seguir estos pasos:
- Define el endpoint del servicio como
REGION_ID-dialogflow.googleapis.com. Define el nombre del recurso con la ubicación correcta. Por ejemplo:
projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id
Credenciales
Te recomendamos que uses la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para proporcionar credenciales a tus bibliotecas de cliente. Consulta las instrucciones de configuración de Dialogflow para obtener más información sobre cómo definir esta variable.
Si, en cambio, necesitas proporcionar credenciales manualmente en tu código, debes seguir un paso adicional antes de poder llamar a un endpoint regionalizado. Debes definir el permiso https://www.googleapis.com/auth/cloud-platform al generar tus credenciales de autenticación. En el siguiente ejemplo se muestra cómo hacerlo en Java al crear un objeto GoogleCredentials:
GoogleCredentials.fromStream(new FileInputStream("credential_file"))
.createScoped("https://www.googleapis.com/auth/cloud-platform")
Cloud Logging
Consulta la documentación de Cloud Logging para controlar la región en la que se almacenan tus registros.