Conecta Google Vertex AI a Microsoft Agent 365

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:

  1. Activa la API de Vertex AI.
  2. Activa la API de BigQuery.
  3. Activa la API de Cloud Trace.
  4. Activa la API de Monitorización en la Nube.
  5. Activa la recogida de telemetría en el agente desplegado.
  6. Activar la exportación de Trace Analytics en BigQuery.
  7. Confirma que el trace_analytics_link conjunto de datos y su _AllSpans vista 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

  1. Abra el Centro de administración de Microsoft 365.
  2. Selecciona Agentes>Todos los agentes.
  3. En Plataformas conectadas, selecciona Gestionar.
  4. Selecciona + Conecta una plataforma y elige Google Vertex AI.
  5. Introduce el ID del proyecto, la región y la clave JSON completa de la cuenta de servicio.
  6. Valide las credenciales.
  7. Guarde la conexión.
  8. 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.