Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le Microsoft 365 Agents SDK est un framework de développement pour créer des assistants conversationnels. Les assistants conversationnels sont des logiciels capables de recevoir des messages de la part des utilisateurs, de les traiter et d’y répondre. Imaginez-le comme la couche intermédiaire entre un utilisateur qui envoie un message (que ce soit dans Teams, sur un site web, Slack ou ailleurs) et la logique que vous avez développée pour répondre à ce message.
Le SDK gère la mécanique de réception et d’envoi de messages sur divers canaux, permettant aux développeurs de se concentrer sur ce que l’assistant fait réellement plutôt que sur les protocoles de communication sous-jacents.
Langues prises en charge
Agents SDK prend en charge les points suivants :
- C# utilisant le SDK .NET 8.0
- JavaScript à l’aide de Node.js version 18 et ultérieures
- Python utilisant les versions 3.9 à 3.11
Trois problèmes que le kit de développement logiciel (SDK) des assistants résout
Votre assistant doit travailler à plusieurs endroits. Les utilisateurs ne communiquent pas tous par le même canal. Certains utilisent Microsoft Teams, d’autres Microsoft 365 Copilot, d’autres un site web de société, et d’autres encore des outils non Microsoft tels que Slack ou Facebook Messenger. Sans framework, un développeur doit écrire un code d’intégration séparé pour chacun de ces canaux, chacun avec son propre format de message, schéma d’authentification et protocole de connexion.
Le kit de développement logiciel fournit une couche d’abstraction de canal. Vous écrivez la logique de votre assistant une seule fois, et le kit de développement logiciel traduit les messages entrants et sortants dans et depuis le format que chaque canal attend. L’ajout d’un nouveau canal ne nécessite pas de réécrire le comportement central de l’assistant.
Vous ne voulez pas rester enfermé dans un seul service d’IA. Le choix du service d’IA qui alimente un assistant, qu’il s’agisse d’Azure AI Foundry, d’OpenAI, de Noyau sémantique ou de tout autre chose, évolue fréquemment à mesure que le paysage évolue et que différents cas d’usage apparaissent. Une infrastructure d’assistants qui intègre un fournisseur d’IA spécifique oblige les développeurs à réécrire de grandes parties de leur code lorsque ce choix change.
Le kit de développement logiciel est agnostique vis-à-vis de l’IA par conception. Il fournit l’infrastructure nécessaire pour recevoir les messages, gérer l’état et router les événements, mais ne fait aucune hypothèse sur ce qui génère la réponse. Les développeurs intègrent les services d’IA ou les bibliothèques d’orchestration de leur choix. Le kit de développement logiciel n’entrave pas ce choix.
Il est difficile de gérer l’état de la conversation. Les conversations ne sont pas sans état. Un utilisateur peut poser une question complémentaire, faire référence à ce qui a été dit deux tours auparavant, ou arrêter une conversation puis la reprendre plus tard. Gérer ce contexte, notamment suivre ce qui s’est passé, où il est stocké et comment il circule entre les messages, est fastidieux et propice aux erreurs lorsqu’on doit l’implémenter soi-même.
Le kit de développement logiciel offre une gestion native de l’état et du stockage. Il introduit le concept de tour (une unité de travail dans une conversation) et assure le suivi de l’état d’un tour à l’autre sans que les développeurs aient à implémenter leur propre couche de persistance. Cela signifie moins de code générique et moins de bugs dans la logique de flux de conversation.
Articulation
Au cœur du kit de développement logiciel, lorsque qu’un message arrive, il effectue trois opérations :
Reçoit le message depuis n’importe quel canal (Teams, chat web, Slack, etc.) et le normalise dans un format commun appelé
Activity.Achemine l’activité vers le gestionnaire approprié dans le code de votre assistant. Par exemple, une activité de message déclenche un gestionnaire, tandis qu’un utilisateur rejoignant une conversation en déclenche un autre.
Envoie la réponse par le même canal, en convertissant votre réponse dans le format attendu par ce canal.
Les développeurs écrivent des gestionnaires pour les types d’activités qui les intéressent. Le kit de développement logiciel gère tout le reste, y compris l’authentification, la traduction des formats de messages et la connectivité des canaux.
Ce qu’Agents SDK n’est pas
Le SDK Agents n’est pas un modèle d’IA, un moteur d’orchestration ou un constructeur sans code. Le SDK Agents ne décide pas de ce que dit un assistant. Ces éléments sont du ressort de n’importe quel service d’IA ou logique métier que le développeur connecte à l’assistant. L’Agents SDK constitue le cadre qui assure la transmission fiable des messages vers et depuis cette logique, sur tous les canaux, en maintenant l’état de la conversation intact.
Étapes suivantes
- Découvrez le protocole d’activité
- Découvrez AgentApplication
- Démarrage rapide : Créer et tester un assistant de base