Créer des assistants .NET dans Visual Studio avec Microsoft 365 Agents Toolkit

Dans cet article, vous apprenez à créer un nouveau projet Agents SDK .NET dans Visual Studio, en utilisant le Microsoft 365 Agents Toolkit.

Configuration requise

• Installez l’extension Agents Toolkit pour Visual Studio pour Visual Studio.

• Un modèle Azure OpenAI disponible sur le Portail Azure AI Foundry. Vous avez besoin des données suivantes sur le modèle :

  • Nom
  • URI cible
  • Clé

Créer un projet

Le kit de création d’assistants fournit un modèle de projet pour vous aider à démarrer la création d’un assistant. Vous pouvez démarrer à partir d’un modèle dans la boîte à outils ou à partir d’exemples dans l’Agents SDK. Ce document se concentre sur les modèles disponibles dans Agents Toolkit. Différents modèles et options sont disponibles pour créer des projets Agents SDK à l’aide de la boîte à outils. Ce guide se concentre sur la création d’un assistant météorologique utilisant Noyau sémantique et Azure AI Foundry.

1. Ouvrez Visual Studio et sélectionnez Créer un projet. Recherchez « assistant » pour trouver de nouveaux modèles utilisant Microsoft 365 Agent Toolkit et Agents SDK Sélectionnez Microsoft 365 Agents>Suivant.

   

   Une boîte de dialogue apparaît pour que vous puissiez nommer l’assistant. Vous pouvez aussi changer l’emplacement et le nom de la solution si vous le souhaitez.

2. Lorsque vous avez terminé, cliquez sur Créer

   

   Vous pouvez choisir parmi différentes options proposées par la boîte à outils pour créer des assistants.

3. Dans le cadre de ce guide, sélectionnez Assistant météo>Suivant pour utiliser le Microsoft 365 Agents SDK. Cet exemple prédéfini implémente Noyau sémantique pour l’orchestration avec Azure AI Foundry ou des modèles Azure OpenAI. Vous pouvez également utiliser l’exemple d’assistant vide si vous souhaitez démarrer sans modèle ni orchestrateur.

   

   

   Une boîte de dialogue vous invite à choisir le service LLM.

4. Pour cette procédure pas à pas, sélectionnez Azure OpenAI.

   Ces informations sont disponibles dans Azure AI Foundry sous Modèles et points de terminaison.

   

5. Remplissez les entrées requises : clé de service Azure OpenAI, point de terminaison Azure OpenAI, et nom de déploiement Azure OpenAI.

6. Sélectionnez Créer. Le Toolkit crée le projet à partir d’un modèle de projet pour vous.

7. En peu de temps, vous devriez avoir un nouveau projet créé avec le SDK Agents.

   

Tester votre assistant dans Microsoft 365 Agents Playground

Pour commencer, vous pouvez tester localement en utilisant Microsoft 365 Agents Playground dans la boîte à outils.

Pour commencer les tests, définissez la cible de débogage dans votre projet sur Microsoft 365 Agents Playground.

Le terrain de jeu s’ouvre pour que vous puissiez tester dans une nouvelle fenêtre de navigateur avec votre hébergeur local et affiche le terrain de jeu prêt à être testé. Commencez à envoyer des messages à votre assistant pour tester son comportement.

Déboguez et testez votre assistant dans Microsoft Teams ou Microsoft 365 Copilot

Vous pouvez également définir la cible de débogage directement dans Microsoft Teams ou Microsoft 365 Copilot.

1. Sélectionnez l’une des options de débogage à utiliser comme cible dans la liste des cibles.

   

   Il faut quelques instants pour passer à Microsoft Teams. On vous invite à ajouter votre assistant dans le client Teams qui s’ouvre.

   

2. Sélectionnez Ajouter. Un volet de notification apparaît, indiquant que l’assistant a été ajouté avec succès.

   

3. Sélectionnez Ouvrir pour votre nouvel assistant afin de l’ouvrir dans Teams. Vous pouvez poser des questions à votre assistant, directement dans Teams. Vous pouvez définir des points d’arrêt pour déboguer votre expérience si nécessaire.

   

Résumé

Vous avez maintenant réussi à :

• Lancement d’un nouveau projet Microsoft 365 Agents à l’aide du kit d’outils Assistants
• Tester l’assistant localement en utilisant Microsoft 365 Agents Playground
• Déployez l’assistant pour le débogage directement dans le canal Teams ou Microsoft 365