Liste de contrôle de validation du SDK Agent 365

Utilisez cette checklist de validation du SDK de l’Agent 365 après avoir intégré un agent et avant de le déployer. C’est la dernière étape du parcours d’intégration : les compétences Agent 365 ou la configuration manuelle appliquent l’intégration. Ces vérifications vous aident à confirmer que chaque capacité fonctionne afin que vous puissiez déployer en toute confiance.

Si votre assistant de codage expose la capacité interne Validation & Diagnose de l’Agent 365, également appelée a365-code-validator, vous pouvez lui demander de valider cette intégration Agent 365 pour un prévol au niveau du code. Il vérifie le projet pour détecter des lacunes dans l’instrumentation, les artefacts Microsoft Entra, la messagerie, l’accès aux outils et la configuration associée. La disponibilité et l’invocation dépendent de l’assistant et du package de compétences. Utilisez la liste de contrôle pour confirmer les résultats dans votre environnement cible. Le validateur ne remplace pas les tests de bout en bout ni la revue de la plateforme.

Les sections sur les capacités sont indépendantes, donc évitez toutes les capacités que vous n’avez pas adoptées. Les sections comportement, configuration et déploiement s’appliquent à chaque intégration.

Travaillez sur cette liste de contrôle si vous :

  • J’ai intégré un agent et je souhaite confirmer l’intégration avant le déploiement.
  • Ajout d’une capacité à un agent que vous aviez déjà intégrée.
  • J’ai hérité d’un agent d’une autre équipe et je dois établir ce qui est configuré.

Vérifier le comportement existant

Le SDK étend votre agent, donc l’intégration ne devrait pas changer le fonctionnement de l’agent.

  • L’agent commence sans nouvelles erreurs.
  • L’agent répond à une demande normale comme avant l’intégration.
  • Les appels de modèles, l’orchestration et l’exécution des outils se comportent comme avant.

Note

Si le comportement du cœur a changé, il faut enquêter avant de déployer. Le code généré, les conflits de dépendances, la configuration et la compatibilité des SDK sont toutes des causes possibles. Consultez la rubrique Résolution des problèmes.

Vérifier l’identité

  • Le plan d’identité de l’agent est enregistré dans Microsoft Entra.
  • Une identité d’agent existe, créée à partir de ce plan. La make-a365-agent compétence le crée sur le chemin standard de l’agent, et make-ai-teammate sur le chemin des coéquipiers IA ; voir Démarrage rapide : Connecter un agent existant à l’Agent 365.
  • Au moins un parrain est assigné.
  • Si l’agent nécessite un compte utilisateur, ce compte existe et est lié à l’identité de l’agent.
  • Si l’agent possède un compte utilisateur, les licences requises sont attribuées et des ressources dépendantes telles qu’une boîte aux lettres sont provisionnées.
  • Les permissions d’API et les champs de portée Microsoft Graph sont accordés et correctement délimités.
  • L’agent authentifie et agit sous l’identité attendue.

Important

Les agents disposant de leur propre compte utilisateur ne sont disponibles que pour les locataires participant au programme de prévisualisation Frontier. Évitez les vérifications de compte utilisateur si votre locataire n’est pas inscrit.

Note

Après avoir attribué les licences, la provisionnement des ressources pour un compte utilisateur se termine généralement en 10 à 15 minutes, mais cela peut prendre jusqu’à 24 heures.

Vérifier l’observabilité

  • Au moins un utilisateur du locataire a une licence Microsoft 365 E7 ou Microsoft Agent 365 attribuée. Sans cette licence, la télémétrie est supprimée même si l’ingestion renvoie HTTP 200.
  • Les packages d’observabilité sont installés et configurés.
  • Une requête de test produit des spans pour l’invocation d’agents, l’exécution d’outils et l’inférence.
  • La course a une portée valide invoke_agent à sa racine. Sans un, les portées restent interrogables dans la chasse avancée Defender mais n'atteignent pas les trois surfaces.
  • La télémétrie apparaît dans Microsoft Defender, Microsoft Purview et le centre d’administration Microsoft 365 admin center.
  • Les attributs d’étendue correspondent aux opérations que vous attendez.

Vérification des outils

Complétez cette section si l’agent invoque des serveurs Model Context Protocol (MCP).

  • Une licence Microsoft 365 Copilot est disponible dans le locataire. Le MCP de Work IQ est en aperçu et en nécessite un.
  • L’agent découvre les serveurs MCP auxquels il devrait avoir accès.
  • Une invocation d’outil de test réussit d’un bout à l’autre.
  • L’exécution de l’agent détecte une défaillance d’outil, renvoie une erreur contrôlée et reste disponible.

Vérifier les notifications

Complétez cette section si l’agent reçoit des notifications.

  • L’agent reçoit des notifications des sources configurées, telles que Teams, Outlook, les commentaires Word ou les e-mails.
  • L’agent répond à une notification de test telle qu’elle a été conçue.

Important

Les notifications nécessitent un compte utilisateur d’agent, qui n’est disponible que pour les locataires participant au programme de prévisualisation Frontier. Passez cette section si votre locataire n’est pas inscrit.

Vérifier la configuration

  • Stockez les identifiants et secrets en toute sécurité et ne les mettez pas sous contrôle de version.
  • Séparez les paramètres de développement, de test et de production.
  • Assurez-vous que l’intégration fonctionne bien dans votre hôte cible.

Confirmer la préparation au déploiement

  • Tous les contrôles applicables passent.
  • Effectuez au moins un test de bout en bout dans un environnement non productif.
  • Vérifiez la télémétrie après le déploiement pour confirmer l’état de santé de l’agent.

Résoudre les échecs de vérification

Relance l’étape de configuration concernée, ou demande à ton assistant de codage de compléter la capacité spécifique.

  • Vérifications d’identité : voir Identité de l’agent.
  • Vérifications d’observabilité, d’outillage et de notification : relancer la compétence de correspondance depuis Agent 365 Skills.

Pour les symptômes courants et leurs résolutions, voir Dépannage. Pour des symptômes spécifiques à la configuration basée sur les compétences, consultez le tableau de dépannage dans Quickstart : Connecter un agent existant à l’Agent 365.

Pour les réponses aux questions connexes, voir la foire aux questions du SDK Agent 365.

Contenu connexe

  • Last updated on