Connectez Google Vertex AI à Microsoft Agent 365

Utilisez ce guide pour connecter les agents Google Vertex AI à Microsoft Agent 365.

Avant de commencer

  • Confirmez que l’administrateur IA de l’Agent 365 peut créer des connexions dans le centre d’administration Microsoft 365 admin center.
  • Demandez à l’administrateur de la plateforme l’identifiant et la région du projet Google Cloud.
  • Créez un compte de service Google Cloud et une clé JSON pour ce compte.
  • Utilisez le projet et la région où les agents sont déployés.

Créer le compte de service

Accordez au compte service les permissions Vertex AI requises pour la découverte et la gestion des agents :

aiplatform.reasoningEngines.list
aiplatform.reasoningEngines.get
aiplatform.reasoningEngines.delete

La clé JSON doit contenir le document complet de la clé de compte de service, y compris les entretoises d’ouverture et de fermeture. Ne saisissez pas uniquement la valeur private_key.

Ajouter des permissions d’observabilité

Pour collecter des données d’observabilité, accordez au même service ces rôles :

Role ID de rôle Purpose
Visionneuse de Données BigQuery roles/bigquery.dataViewer Lisez les tables de traces exportées
Utilisateur de BigQuery Job roles/bigquery.jobUser Exécuter des requêtes pour récupérer les spans
Visualiseur de surveillance roles/monitoring.viewer Consulter les métriques du nombre de requêtes et de latence
Utilisateur Cloud Trace roles/cloudtrace.user Lecture des portées de trace du nuage

Vous avez besoin des deux rôles BigQuery. Data Viewer permet de lire les tableaux, tandis que Job User permet d’exécuter les requêtes qui récupèrent les résultats.

Configurez la télémétrie de Google Cloud

Concernant le projet où vous avez déployé l’agent :

  1. Activez l’API Vertex AI.
  2. Activez l’API BigQuery.
  3. Activez l’API Cloud Trace.
  4. Activez l’API de surveillance du cloud.
  5. Activez la collecte de télémétrie sur l’agent déployé.
  6. Activez l’exportation vers BigQuery de Trace Analytics.
  7. Confirmez que le trace_analytics_link jeu de données et sa _AllSpans vue existent.

L’agent 365 ne peut pas activer la collecte de télémétrie ou l’exportation de traces pour vous.

Créer la connexion

  1. Ouvrez le centre d’administration Microsoft 365.
  2. Sélectionner les agents>Tous les agents.
  3. Dans les plateformes connectées, sélectionnez Gérer.
  4. Sélectionnez + Connecter une plateforme et choisissez Google Vertex AI.
  5. Saisissez l’ID du projet, la région et la clé JSON complète du compte de service.
  6. Validez les informations d’identification.
  7. Enregistrez la connexion.
  8. Sélectionnez Sync agents.

Vérifier la connexion

Confirmez que les agents attendus sont importés. Une connexion peut valider et importer des agents sans fournir de télémétrie si le projet, la région, les rôles, les API ou l’exportation de traces ne sont pas configurés correctement.

Troubleshoot

Symptôme Cause la plus probable Résolution
Les assistants sont importés, mais aucune activité n’apparaît L’observabilité n’est pas configurée Complétez les étapes des rôles, de l’API, de la télémétrie et de l’exportation des traces.
Pas de portées, mais des métriques apparaissent Les rôles BigQuery ou l’exportation de traces manquent Attribuez les deux rôles BigQuery et activez l’export des traces.
Les requêtes échouent bien que les tables soient lisibles roles/bigquery.jobUser est manquant Attribuez le rôle « Utilisateur des tâches BigQuery » au compte de service.
Pas de métriques de nombre de requêtes ni de latence Le rôle de surveillance ou l’API est manquant Accordez le rôle Lecteur de surveillance et activez l’API Cloud Monitoring.
_AllSpans n’existe pas L’exportation BigQuery de Trace Analytics n’est pas activée Activez l’export et vérifiez le jeu de données et la vue.
Les agents sont importés, mais aucune donnée de télémétrie n’est disponible Le périmètre de connexion ne correspond pas à celui de déploiement Utilisez le projet et la région de l’agent déployé.

Pour les problèmes de connexion qui ne sont pas spécifiques à Google Vertex AI, voir Dépannage des plateformes connectées.

  • Dernière mise à jour :