Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Utiliza esta guía para conectar agentes de IA de Google Vertex con Microsoft Agent 365.
Antes de empezar
- Confirma que el administrador de IA de Agent 365 puede crear conexiones en el centro de administración de Centro de administración de Microsoft 365.
- Pregunta al administrador de la plataforma por el ID del proyecto Google Cloud y la región.
- Crea una cuenta de servicio Google Cloud y una clave JSON para esa cuenta.
- Utiliza el proyecto y la región donde se despliegan los agentes.
Creación de la cuenta de servicio
Otorga a la cuenta de servicio los permisos de Vertex AI necesarios para el descubrimiento y la gestión de agentes:
aiplatform.reasoningEngines.list
aiplatform.reasoningEngines.get
aiplatform.reasoningEngines.delete
La clave JSON debe contener el documento completo de la clave de la cuenta de servicio, incluidas las llaves de apertura y cierre. No introduzcas solo el valor private_key.
Añadir permisos de observabilidad
Para recopilar datos de observabilidad, concede a la misma cuenta de servicio estos roles:
| Función | Identificación de rol | propósito |
|---|---|---|
| Visualizador de datos de BigQuery | roles/bigquery.dataViewer |
Lee tablas de trazos exportadas |
| Usuario de trabajo de BigQuery | roles/bigquery.jobUser |
Ejecutar consultas para recuperar tramos |
| Visor de monitorización | roles/monitoring.viewer |
Métricas de conteo de peticiones y latencia de lectura |
| Usuario de Cloud Trace | roles/cloudtrace.user |
Leer intervalos de Cloud Trace |
Necesitas ambos roles en BigQuery. Data Viewer permite leer las tablas, mientras que Job User permite ejecutar las consultas que recuperan los resultados.
Configurar la telemetría de Google Cloud
Sobre el proyecto donde desplegaste al agente:
- Activa la API de Vertex AI.
- Activa la API de BigQuery.
- Activa la API de Cloud Trace.
- Activa la API de Monitorización en la Nube.
- Activa la recogida de telemetría en el agente desplegado.
- Activar la exportación de Trace Analytics en BigQuery.
- Confirma que el
trace_analytics_linkconjunto de datos y su_AllSpansvista existen.
Agent 365 no puede habilitar la recopilación de telemetría ni la exportación de trazas por usted.
Creación de la conexión
- Abra el Centro de administración de Microsoft 365.
- Selecciona Agentes>Todos los agentes.
- En Plataformas conectadas, selecciona Gestionar.
- Selecciona + Conecta una plataforma y elige Google Vertex AI.
- Introduce el ID del proyecto, la región y la clave JSON completa de la cuenta de servicio.
- Valide las credenciales.
- Guarde la conexión.
- Selecciona agentes de sincronización.
Verifique la conexión
Confirma que se han importado los agentes esperados. Una conexión puede validar e importar agentes sin devolver telemetría si el proyecto, región, roles, APIs o exportación de trazos no están configurados correctamente.
Troubleshoot
| Síntoma | Causa probable | Resolution |
|---|---|---|
| Los agentes importan pero no aparece actividad | La observabilidad no está configurada | Complete los pasos de roles, API, telemetría y exportación de seguimientos. |
| No hay tramos, pero sí aparecen métricas | Faltan roles en BigQuery o exportación de seguimientos | Otorga ambos roles de BigQuery y activa la exportación de trazas. |
| Las consultas fallan aunque las tablas son legibles |
roles/bigquery.jobUser falta |
Otorga el rol BigQuery Job User a la cuenta de servicio. |
| No hay métricas de recuento de peticiones ni de latencia | Falta el rol de monitorización o la API | Concede el Visor de supervisión y activa la API de Supervisión en la nube. |
_AllSpans no existe |
La exportación de Trace Analytics en BigQuery no está habilitada | Activa la exportación y verifica el conjunto de datos y la vista. |
| Importan agentes pero la telemetría está vacía | El alcance de la conexión no coincide con el alcance de despliegue | Utiliza el proyecto y la región del agente desplegado. |
Para problemas de conexión que no sean específicos de Google Vertex AI, consulta Solucionar problemas en plataformas conectadas.