Démarrage rapide : Connectez un agent existant à l’Agent 365

Dans ce démarrage rapide, vous connectez un agent existant à Agent 365 en utilisant les compétences Agent 365 dans votre assistant de codage. Le chemin commence par l’enregistrement de l’agent, puis ajoute les capacités que vous choisissez, et se termine par la validation. Si vous créez un coéquipier IA, ce qui nécessite le programme Frontier Preview, vous pouvez également le tester localement.

Chaque étape nomme la compétence qui la gère et montre un exemple de demande. Vous invoquez une compétence en indiquant le résultat, pas en tapant le nom de la compétence.

Prerequisites

  • Un agent existant sur une pile supportée : Python, Node.jsou .NET.
  • Un locataire Microsoft avec l’Agent 365 activé. Connectez-vous en tant qu’Administrateur Global, ou en tant que Développeur d’ID d’Agent avec un Administrateur Global disponible pour compléter les autorisations OAuth.
  • Un abonnement Azure avec la permission de créer des ressources.
  • Un assistant de codage pris en charge : Claude Code, GitHub Copilot CLI, ou VS Code agent mode.
  • L’interface en ligne de commande GitHub (gh), utilisée pour installer les compétences.

Note

La configuration de l'Agent 365 utilise l'application Agent 365 Enterprise Business, gérée par Microsoft, lorsqu'elle est disponible dans votre locataire. Vous n’avez pas besoin de créer une application client personnalisée pour ce chemin. Si l’application entreprise n’est pas disponible, la configuration revient à une application détenue par un locataire nommé Agent 365 CLI. Une application client personnalisée configurée explicitement reste prise en charge. Pour plus d’informations, consultez Enregistrement personnalisé de l’application client pour l’Agent 365 CLI.

La licence dépend des capacités que vous adoptez :

  • Identité. Pas de permis supplémentaire. Le locataire doit avoir Agent 365 activé.
  • Observabilité. Au moins un utilisateur dans le locataire à qui une licence Microsoft 365 E7 ou Microsoft Agent 365 est attribuée. Sans cela, les données de télémétrie sont ignorées silencieusement.
  • Outillage (QI de travail). Une licence Microsoft 365 Copilot Le MCP de Work IQ est en préversion.
  • Notifications. Un compte utilisateur d’agent, disponible uniquement pour les locataires dans le programme d’aperçu Frontier.

Tip

Vérifiez d’abord que le SDK est le bon mécanisme d’intégration pour votre agent. Voir Choisir l’option d’intégration. Pour le modèle d’identité sous-jacent à l’inscription, y compris les plans directeurs, les autorisations et le consentement, voir Identité de l’agent et Concepts clés de Identifiant d’assistant Microsoft Entra.

Installez les compétences

Intégrez ces compétences dans votre assistant de codage :

gh skill add microsoft/agent365-skills

La même commande fonctionne pour Claude Code, GitHub Copilot CLI et le mode agent VS Code. Redémarrez votre assistant ensuite pour qu’il acquiert les nouvelles compétences.

Mettre en place et détecter le projet

Ouvrez votre projet d’agent dans votre assistant de codage, puis exécutez :

Compétence : a365-setup

mise en place de ce projet pour l’Agent 365

Répondez aux questions concernant votre agent. Quand la compétence est terminée, elle valide vos prérequis et détecte votre stack.

Le programme d’installation enregistre les identifiants et les points de terminaison générés dans a365.generated.config.json. La configuration standard de l’agent ne nécessite pas de fichier de configuration créé manuellement ; la configuration des coéquipiers IA nécessite un fichier de configuration créé manuellement a365.config.json.

a365-setup Puis vous oriente vers l’un des deux chemins de provisionnement. Complétez celui qu’il sélectionne, puis continuez avec les étapes partagées qui suivent :

Les deux chemins se poursuivent ensuite au niveau de l’instrumentation pour l’observabilité.

Inscrire l’agent

Effectuez cette étape si a365-setup vous a dirigé vers le parcours standard de l’agent.

Compétence : make-a365-agent

Enregistrez cet agent auprès de l’Agent 365

Lorsque la compétence est terminée, votre agent dispose d’un plan enregistré dans Microsoft Entra, d’une identité d’agent créée à partir de celui-ci, ainsi que des autorisations nécessaires. L’inscription offre une visibilité du catalogue ; L’étape d’observabilité ajoute la télémétrie.

Ajouter des messages et notifications

Terminez cette étape si a365-setup vous a redirigé vers le parcours du coéquipier IA.

Compétence : make-ai-teammate

ajouter des messages et notifications à cet agent

La compétence ajoute la couche d’hébergement et le routage des messages, et enregistre l’agent. Les gens peuvent ensuite y accéder via Teams, Outlook, les commentaires Word et par email.

Importante

Cette étape donne à votre agent son propre compte utilisateur, incluant une boîte aux lettres et une présence Teams. Cette fonctionnalité est disponible uniquement pour les locataires participant au programme de prévisualisation Frontier. Saute cette étape si ton locataire n’est pas inscrit.

Instrument d’observabilité

Terminez cette étape dans l’un ou l’autre des chemins. La compétence demande quel type d’agent vous avez.

Compétence : instrument-observability

ajouter de l’observabilité à cet agent

Lorsque vous le demandez, choisissez le mode d’authentification utilisé par votre agent : OBO (au nom d’un utilisateur connecté), Agentic-User (le compte utilisateur propre à l’agent, qui nécessite le programme d’aperçu Frontier), ou S2S (service-à-service, pour les opérations en arrière-plan). L’exportateur utilise le même mode que votre agent authentifie, donc choisissez le mode qui correspond à votre modèle d’autorisation. Voir Identité de l’agent.

Après une exécution de test, les spans de votre assistant apparaissent dans Microsoft Defender, Microsoft Purview et le centre d’administration Microsoft 365.

Importante

Deux choses peuvent faire paraître la télémétrie disparue, même si la requête renvoie HTTP 200. Si aucun utilisateur du locataire n'a une licence Microsoft 365 E7 ou Microsoft Agent 365 attribuée, la demande entière est abandonnée ; la présence du SKU n'est pas suffisante. Si l’exécution ne comporte pas de span invoke_agent valide à sa racine, les spans restent interrogeables dans la recherche avancée de Defender, mais n’apparaissent dans aucune des trois interfaces. Le span racine est le span de plus haut niveau que le SDK émet pour une invocation d’un agent ; chaque appel d’outil et chaque événement d’inférence y est imbriqué.

Connecter les données Microsoft 365

Complétez cette étape sur l’un ou l’autre chemin si votre agent lit ou agit sur les données Microsoft 365. Les outils Work IQ nécessitent un modèle d’autorisations déléguées, donc cette étape est automatiquement sautée si vous choisissez S2S dans l’étape d’observabilité.

Compétence : add-workiq-tools

connecter Work IQ Mail et Calendar

Nommez les charges de travail dont vous avez besoin, comme Mail, Calendar ou Word. La compétence connecte les serveurs MCP Work IQ correspondants, et votre agent peut alors accéder à ces données sous contrôle administrateur.

Importante

Work IQ MCP est en version preview et nécessite une licence Microsoft 365 Copilot. Un administrateur global doit accorder les autorisations OAuth pour les serveurs Work IQ avant que votre agent puisse les appeler. Voir Ajouter et gérer des outils.

Tester localement

Effectuez cette étape si vous suivez le parcours Coéquipier IA, qui nécessite le programme en version préliminaire Frontier. Agents Playground se connecte via le point de terminaison de messagerie de l’agent, donc cela ne s’applique pas aux agents standards.

Compétence : test-local

Tester cet agent localement

Votre agent est en concurrence avec Agents Playground, un harnais local de test, donc vous pouvez le tester avant de déployer.

Validez le résultat

Votre agent doit commencer et répondre comme avant l’intégration, et apparaître dans l’Agent 365 sous son identité enregistrée.

Si votre assistant de programmation expose la capacité interne Agent 365 Validate & Diagnose, demandez-lui de valider cette intégration à Agent 365 afin d’exécuter la vérification préalable au niveau du code sur le projet. Il vérifie les lacunes dans l’instrumentation, les artefacts Microsoft Entra, la messagerie, l’accès aux outils et la configuration associée. La capacité est également appelée a365-code-validatoren interne ; la disponibilité et le routage exact dépendent de l’assistant de codage et du package Skills installé.

Avant de déployer, suivez la checklist de validation du SDK de l’Agent 365.

Troubleshoot

Utilisez le tableau suivant pour identifier et résoudre les problèmes courants lors de la mise en relation de votre agent à l’Agent 365.

Symptôme Résolution
L’assistant de codage décrit les commandes mais ne les exécute pas Utilisez un mode qui offre un accès au terminal. Dans VS Code, utilisez le mode agent. Les modes Demande et Édition ne peuvent pas exécuter les commandes terminales.
Le programme d’installation signale des prérequis Azure manquants. Effectuez les prérequis indiqués par a365-setup, puis exécutez de nouveau la compétence.
L’enregistrement des Blueprints échoue, ou les commandes CLI renvoient des erreurs d’autorisation Vérifiez que vous êtes connecté avec un compte disposant de l’autorisation d’inscrire des blueprints d’identité d’assistant dans le locataire.
Aucune télémétrie n’apparaît Confirmez qu’au moins un utilisateur du locataire s’est vu attribuer une licence Microsoft 365 E7 ou Microsoft Agent 365, puis confirmez que l’exécution émet à sa racine un span valide invoke_agent, puis confirmez que le mode d’authentification que vous avez sélectionné correspond à votre environnement. Demandez à votre assistant de codage de valider l’intégration Agent 365 ; La compétence de validateur installée peut diagnostiquer l’instrumentation.
On dirait qu’une étape a été sautée Les compétences tiennent compte de l’état et ignorent les tâches déjà configurées. Il est donc probable que cette étape soit déjà terminée. Exécute de nouveau la compétence en question et indique explicitement le résultat.
Les valeurs de configuration doivent changer après la configuration Si votre configuration utilise a365.config.json, modifiez-la et exécutez de nouveau a365 config init -c ./a365.config.json, puis exécutez de nouveau la compétence correspondante.

Contenu connexe

  • Last updated on