Cet article répond aux questions courantes sur le SDK Agent 365 : ce qu’il fait ou ne fait pas, quand vous en avez besoin, quelles fonctionnalités sont disponibles, comment fonctionne l’identité et comment valider une intégration.
Portée et positionnement
Puis-je créer un agent avec le SDK Agent 365 ?
Non. Le SDK n’est pas un cadre de construction d’agents. Construis ton agent avec le framework que tu as choisi, puis utilise le SDK Agent 365 pour l’intégrer dans Agent 365. Voir Quand utiliser le SDK Agent 365.
Le SDK effectue-t-il des appels au modèle de langage ou orchestre-t-il des étapes ?
Non. Votre agent continue de faire ses propres appels de modèles, et l’orchestration reste dans votre framework ou runtime. Voir le SDK de l’agent 365 et l’écosystème de l’agent.
Le SDK héberge-t-il ou déploie-t-il mon agent ?
Non. Votre agent fonctionne où il est aujourd’hui. Voyez en quoi le SDK de l’Agent 365 est-il différent ?
Le SDK exécute-t-il les appels d’outils de mon agent ?
Non. Les registres SDK gouvernaient les serveurs du protocole de contexte modèle (MCP) ; L’exécution reste dans votre temps d’exécution. Voir le SDK de l’agent 365 et l’écosystème de l’agent.
Le SDK remplace-t-il mon framework d’agent ?
Non. Gardez votre modèle, framework ou runtime, et hôte. Le SDK s’exécute parallèlement à eux et ajoute identité, observabilité, outils et notifications. Pour la frontière couche par couche, voir l’aperçu du SDK de l’Agent 365.
En quoi le SDK Agent 365 diffère-t-il du Microsoft 365 Agents SDK ?
Le Microsoft 365 Agents SDK construit des agents conversationnels, gérant la connectivité du canal et l’état de la conversation. Le SDK de l’Agent 365 prolonge un agent que vous avez déjà construit. Les deux travaillent ensemble. Voir l’aperçu du SDK de l’Agent 365.
Quels langages le SDK supporte-t-il ?
Python, JavaScript et .NET. Voir les packages SDK de l’Agent 365.
Choisir un mécanisme d’intégration
Ai-je besoin du SDK ?
Pas toujours. Si l’intégration intégrée ou la synchronisation du registre offre déjà les fonctionnalités dont votre agent a besoin, vous n’aurez peut-être pas besoin du SDK. Voir Choisir l’option d’intégration.
Quand une intégration intégrée suffit-elle ?
Lorsque le chemin de la plateforme fournit déjà les capacités Agent 365 requises par votre scénario. Copilot Studio et Azure AI Foundry peuvent entrer dans cette catégorie, mais le support dépend de la manière dont l’agent est construit, authentifié et hébergé. Posséder ou déployer du code ne nécessite pas en soi le SDK. Voir Comparer les mécanismes d’intégration de l’Agent 365.
Quelle est la différence entre la synchronisation du registre et l’intégration SDK ?
La synchronisation du registre relie les agents des plateformes connectées, telles que Google Vertex AI et Amazon Bedrock, vers Agent 365 via une configuration au niveau de la plateforme. L’intégration SDK est destinée aux agents que vous construisez avec un SDK ou framework d’agents, et elle vous donne un contrôle au niveau du code. Voir Comparer les mécanismes d’intégration de l’Agent 365.
Mon agent est en dehors d’Azure. Puis-je toujours utiliser le SDK ?
Yes. Le SDK ne change pas l’endroit où votre agent est exécuté. Il fonctionne avec des agents hébergés sur Azure, AWS, Google Cloud ou sur site. Voir le cycle de vie du développement de l’agent 365.
Capacités
Dois-je adopter les quatre capacités ?
Non, mais ils ont des prérequis. Un plan d’identité d’agent sous-tend les capacités d’identité, d’outils et de notifications, et les notifications nécessitent en plus un compte utilisateur d’agent, qui n’est disponible que pour les locataires participant au programme d’aperçu Frontier. L’observabilité fonctionne également avec une inscription standard à l’application Microsoft Entra. Au-delà de cela, ajoutez des capacités dans n’importe quel ordre. Voir Vérifier les notifications.
Avec quelle capacité devrais-je commencer ?
Identité. L’enregistrement est ce qui rend l’agent visible dans l’Agent 365, donc commencez par là. Ajoutez ensuite l’observabilité, lorsque vous avez besoin de visibilité opérationnelle. Voir Enregistrer l’agent et l’instrument pour l’observabilité.
Où va ma télémétrie ?
Les spans d’agent apparaissent dans Microsoft Defender, Microsoft Purview et le Microsoft 365 admin center.
Deux choses peuvent donner l’impression que la télémétrie a disparu, même si l’ingestion renvoie HTTP 200.
Si aucun utilisateur du locataire n’a une licence Microsoft 365 E7 ou Microsoft Agent 365 attribuée, la requête entière est abandonnée.
Si la partie n'a pas de portée valide invoke_agent à la racine, les portées sont toujours interrogables dans la chasse avancée Defender mais n'apparaissent dans aucune des trois surfaces.
Voyez où apparaissent vos données ainsi que les limites et conditions de chute.
Qu’est-ce que Work IQ ?
Work IQ est l’ensemble de serveurs MCP régis qui exposent les charges de travail Microsoft 365, telles que Mail, Calendar, Word, SharePoint et Teams, à votre agent sous contrôle administrateur. Work IQ MCP est en version preview et nécessite une licence Microsoft 365 Copilot. Voir Outil de vérification (Verify outils).
Quelles sources de notifications sont prises en charge ?
Teams, Outlook, commentaires Word et e-mail. Les notifications nécessitent un compte utilisateur d’agent, qui n’est disponible que pour les locataires participant au programme de prévisualisation Frontier. Voir Types de notifications et Vérifier les notifications.
Identity
Mon agent a-t-il besoin de sa propre identité ?
Chaque intégration Agent 365 a besoin d’un modèle d’identité, mais cela ne signifie pas toujours donner à l’agent son propre compte utilisateur. L’agent peut utiliser S2S comme identité d’agent, OBO pour agir au nom d’un utilisateur connecté, ou Agentic-User agir via son propre compte utilisateur Microsoft Entra. Choisissez le mode qui correspond au travail de l'agent, aux permissions et aux ressources Microsoft 365 requises. Voir l’identité de l’agent.
Quelle est la différence entre un blueprint d’identité d’agent et un plan d’identité d’agent ?
Le blueprint est le modèle réutilisable qui contient les identifiants et les autorisations déclarées d’un type d’agent. L’identité d’un agent est le compte qu’un agent individuel authentifie. Un seul plan peut créer de nombreuses identités d’agents. Voir Objets d’identité et S2S, identité d’agent dérivé de Blueprint.
Où sont stockées les identifiants de mon agent ?
Sur le plan, pas sur l’identité de l’agent. Parce qu’un plan compromis affecte chaque agent créé à partir de celui-ci, considérez le nombre de plans comme une décision de frontière de sécurité. Voir l’identité de l’agent.
Combien de plans devrais-je créer ?
Autant que nécessaire pour garder séparées les limites entre les accréditations et les autorisations. Des identités d’agent uniquement de groupe qui peuvent partager en toute sécurité les identifiants du plan et les permissions héritées. Voir La fondation de l’identité et S2S, l’identité de l’agent dérivé du Blueprint.
Quel modèle d’autorisation dois-je utiliser ?
Autorisations d’application pour le travail service-à-service, où l’agent agit avec ses propres permissions. Autorisations déléguées pour le travail en nom d’un travail, où l’agent agit avec les autorisations et le contexte de l’utilisateur connecté. Voir l’identité de l’agent.
Mon agent a-t-il besoin d’une licence Microsoft 365 ?
Seulement s'il possède un compte utilisateur d'agent et a besoin de services tels que Teams, Exchange ou SharePoint. Les agents disposant de leur propre compte utilisateur ne sont disponibles que pour les locataires du programme de prévisualisation Frontier. La licence au niveau du locataire s’applique toujours à d’autres fonctionnalités : la télémétrie est supprimée à moins qu’au moins un utilisateur du locataire ne possède une licence Microsoft 365 E7 ou Microsoft Agent 365 attribuée, et le MCP Work IQ nécessite une licence Microsoft 365 Copilot. Voir le compte utilisateur de l’agent, Vérifier l’identité, Vérifier l’observabilité et Vérifier les outils.
Pourquoi la boîte aux lettres de mon agent n’est-elle pas encore disponible ?
Le provisionnement des ressources peut retarder l’attribution des licences. Consultez la liste de vérification de validation du SDK de l’Agent 365 pour les timings attendus.
Qu’est-ce qu’un sponsor ?
Le représentant commercial est responsable de la raison d’être et du cycle de vie de l’agent. Au moins un sponsor est requis pour chaque blueprint d’identité d’agent et d’identité de l’agent. Les équipes de sécurité utilisent le sponsor pour atteindre un humain responsable lors d’un incident. Voir les sponsors et vérifier l’identité.
Mise en place et compétences
Qu’est-ce que les compétences Agent 365 ?
Un moyen de faire en sorte qu’un assistant de codage, comme GitHub Copilot CLI, réalise les étapes d’intégration pour vous. Voir Compétences de l’Agent 365.
Qu’est-ce qui a remplacé le flux de travail de configuration instructions.md ?
Agent 365 Skills a remplacé ce flux de travail. Utilisez plutôt des compétences.
Si votre assistant de codage expose la capacité interne de validation et diagnostic, vous pouvez lui demander de valider l’intégration Agent 365 ; On l’appelle aussi en interne a365-code-validator.
La disponibilité dépend de l’assistant et du pack Skills installé. Voir Compétences de l’Agent 365.
Dois-je utiliser les compétences ?
Non. Vous pouvez effectuer chaque étape manuellement. Les compétences conviennent aux configurations standards et à l’intégration répétable ; La configuration manuelle convient aux environnements non standards et au dépannage. Voir quand utiliser les compétences.
Est-il sûr de jouer une compétence plusieurs fois ?
Yes. Les compétences sont additives et idempotentes, donc les étapes complétées sont sautées plutôt que dupliquées. Voir Sécurité et répétabilité.
Une compétence sembla sauter une étape. Est-ce un problème ?
En général, non. Les compétences sautent des tâches déjà configurées. Relance la compétence spécifique et précise explicitement le résultat si tu veux confirmer. Voir Sécurité et répétabilité.
Puis-je tester avant de déployer sur le cloud ?
Sur le chemin des coéquipiers IA, oui.
La test-local compétence fait fonctionner votre agent avec Agents Playground, un harnais de test local, pour les tests de fumée.
Agents Playground se connecte via le point de terminaison de messagerie de l’agent, donc cela ne s’applique pas aux agents standards.
Voir Les sept compétences et l’agent de test dans Agents Playground.
Validation
Comment puis-je confirmer que l’intégration a fonctionné ?
Mon agent se comporte différemment après l’intégration. Qu’est-ce qui s’est passé ?
Le SDK prolonge votre agent plutôt que de remplacer une partie de celui-ci. Enquêtez sur tout changement de comportement avant le déploiement : code généré, conflits de dépendances, configuration et compatibilité SDK sont toutes des causes possibles. Commencez par vérifier le comportement existant.