Agent Assist proporciona residencia de datos para mantener tus datos en reposo de forma física dentro de una región o ubicación geográfica especificada. Cuando especificas una región, tus datos en reposo no se almacenan fuera de ella. Los precios son los mismos para todas las regiones.
Especificar una región es particularmente útil en los siguientes casos de uso:
- Tu sistema tiene 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 de Bélgica usan
europe-west1
, pueden esperar una mejor latencia.
Regiones disponibles
Agrupación por país | Ubicación geográfica | ID de región | ID de la región del almacén de datos |
---|---|---|---|
América | Iowa | us-central1 |
us (multirregión) |
América | Carolina del Sur | us-east1 |
|
América | Oregón | us-west1 |
|
América | Montreal | northamerica-northeast1 |
|
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 | Singapur | asia-southeast1 |
|
Asia-Pacífico | Tokio | asia-northeast1 |
|
Asia-Pacífico | Bombay | asia-south1 |
|
Asia-Pacífico | Sídney | australia-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 multirregión "us". Como resultado, el uso de las funciones de IA generativa de Agent Assist en la multirregión "us" dependerá de los extremos de región única de EE.UU. existentes. |
¶ | Es posible que las llamadas a la región global tengan una latencia más alta cuando se realicen 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 la publicación regional
ID de región | Resumen con secciones personalizadas v3.1/3.0 | Resumen con secciones personalizadas v2.1 | Resumen con secciones personalizadas v2.0/1.0 | Análisis de opiniones | Knowledge Assist generativo (proactivo) |
---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | |
europe-west1 |
✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | |
europe-west3 |
✓ | ✓ | ✓ | ✓ | |
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
asia-northeast1 |
✓ | ✓ | ✓ | ✓ | |
asia-south1 |
✓ | ✓ | ✓ | ||
australia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
global |
✓ | ✓ | ✓ | ✓ | ✓ |
Datos en reposo
Todos los datos de usuario final y usuario de desarrollador de Agent Assist se incluyen en los datos en reposo. Por ejemplo:
- Bases de conocimiento y documentos de conocimiento.
- Perfiles de conversación.
- Historiales de conversaciones y de mensajes.
- Participantes en las conversiones.
- Son sugerencias que muestra Agent Assist.
- Comentarios.
Limitaciones
Se aplica la siguiente limitación:
- La consola de Agent Assist aún no admite la regionalización. Solo puedes implementar la regionalización llamando a la API directamente.
- La capacitación de modelos no admite la regionalización. Es posible que tus datos se enruten fuera de la región durante este proceso.
El Explorador de API, que se encuentra en muchos documentos de referencia de REST, solo admite la región
global
para las llamadas a la API.Actualmente, la transcripción de la IA conversacional solo admite datos multirregionales en uso y datos en reposo (si no se usa la función de adaptación de voz) 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 de asistencia de conocimiento generativo (proactivo):
global
,us
multirregional yeu
multirregional.
Especifica una región con la API
Para usar la regionalización, debes especificar una región para cada solicitud a la API.
Campos obligatorios:
Proporciona el ID de región para el parámetro de ruta de URL
location
.Para la región
global
, usadialogflow.googleapis.com
para el nombre de host. Para todas las demás regiones, usa[region-id]-dialogflow.googleapis.com
para el nombre de host.
Por ejemplo:
dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id
us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id
Para usar las bibliotecas cliente, se requieren los siguientes pasos:
- Establece el extremo del servicio en
REGION_ID-dialogflow.googleapis.com
. Establece 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 cliente. Consulta las instrucciones de configuración de Dialogflow para obtener más información sobre cómo configurar esta variable.
En cambio, si necesitas proporcionar credenciales manuales en tu código, se requiere un paso adicional antes de que puedas llamar a un extremo regionalizado. Debes configurar el permiso como https://www.googleapis.com/auth/cloud-platform cuando generes tus credenciales de autenticación. En el siguiente ejemplo, se muestra cómo hacerlo 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 documentación de Cloud Logging para controlar la región en la que se almacenan tus registros.