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 construisez un coéquipier IA, qui nécessite le programme de prévisualisation Frontier, vous pouvez aussi 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.
  • La CLI GitHub (gh), utilisait l’installation des compétences.

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 avec une licence Microsoft 365 E7 ou Microsoft Agent 365 attribuée. Sans cela, la télémétrie est supprimée silencieusement.
  • Outillage (QI de travail). Une licence Microsoft 365 Copilot Le MCP de Work IQ est en aperçu.
  • 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é derrière l’enregistrement, incluant les plans, les permissions et le consentement, voir les concepts clés d’identité d’agent et d’identification de l’agent 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.

Setup sauvegarde les IDs et terminaux générés dans a365.generated.config.json. La configuration standard de l’agent n’a pas besoin d’un fichier de configuration rédigé à la main ; La configuration des coéquipiers IA nécessite un a365.config.jsonfichier .

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 continuent ensuite à l’instrument pour l’observabilité.

Inscrire l’agent

Complétez cette étape si a365-setup vous êtes dirigé vers le chemin de l’agent standard.

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 êtes dirigé vers le chemin des coéquipiers 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.

Important

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 l’identité de l’agent.

Après un essai, les spans de votre agent apparaissent dans Microsoft Defender, Microsoft Purview et le Microsoft 365 admin center.

Important

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 la partie n'a pas de portée valide invoke_agent à la racine, les portées restent interrogables dans la chasse avancée Defender mais n'apparaissent sur aucune des trois surfaces. La portée des racines est la portée de niveau supérieur que le SDK émet pour une invocation d’agent ; Chaque appel d’outil et chaque événement d’inférence s’y imnichent.

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

Câblez Work IQ Mail and 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.

Important

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

Terminez cette étape si vous suivez le chemin des coéquipiers IA, qui nécessite le programme de prévisualisation 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 codage expose la capacité interne Validation & Diagnose de l’Agent 365, demandez-lui de valider cette intégration Agent 365 pour exécuter le prévol 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.
Les rapports de configuration manquant de prérequis Azure Remplissez les prérequis listés a365-setup , puis relancez la compétence.
L’enregistrement des Blueprints échoue, ou les commandes CLI renvoient des erreurs d’autorisation Confirmez que vous êtes connecté avec un compte qui a l’autorisation d’enregistrer les plans d’identité de l’agent dans le locataire.
Aucune télémétrie n’apparaît Confirmez qu’au moins un utilisateur du locataire a une licence Microsoft 365 E7 ou Microsoft Agent 365 attribuée, puis confirmez que la run émet un span valide invoke_agent à sa racine, 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 sont conscientes de l’état et sautent des tâches déjà câblées, donc l’étape est probablement déjà terminée. Relance la compétence spécifique et précise explicitement le résultat.
Les valeurs de configuration doivent changer après la configuration Si votre installation utilise a365.config.json, éditez-la et relancez-la a365 config init -c ./a365.config.json, puis relancez la compétence concernée.

Contenu connexe

  • Last updated on