Créer des agents .NET dans Visual Studio à l’aide du Kit de ressources Microsoft 365 Agents

Dans cet article, vous allez apprendre à créer un projet .NET sdk Agents dans Visual Studio à l’aide du Kit de ressources Microsoft 365 Agents.

Prerequisites

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

• Modèle OpenAI Azure à partir du portail Azure AI Foundry. Vous avez besoin des données suivantes sur le modèle :

  • Name
  • URI cible
  • Clé

Création d'un projet

Le Kit de ressources Agents fournit un modèle de projet pour vous aider à commencer à créer un agent. Vous pouvez commencer à partir d’un modèle dans le kit de ressources ou à partir d’exemples dans le Kit de développement logiciel (SDK) Agents. Ce document se concentre sur les modèles disponibles dans le Kit de ressources Agents. Il existe différents modèles et options disponibles pour créer des projets sdk Agents avec le kit de ressources. Cette procédure pas à pas se concentre sur la création d’un agent météo à l’aide de Noyau sémantique et de Azure AI Foundry.

1. Ouvrez Visual Studio et sélectionnez Créer un nouveau projet.

2. Cherchez « agent » pour trouver de nouveaux modèles utilisant le kit d’outils et le SDK des agents Microsoft 365.

3. Sélectionnez Microsoft 365 Agents, puis sélectionnez Suivant.

   

   Une boîte de dialogue s’affiche pour que vous puissiez nommer l’agent. Vous pouvez également modifier l’emplacement et le nom de la solution si vous le souhaitez.

4. Lorsque vous avez terminé, sélectionnez Créer

   

   Vous pouvez sélectionner quelques options différentes que fournit le kit de ressources pour la création d’agents.

5. Pour cette procédure pas à pas, sélectionnez Weather Agent>Suivant pour utiliser l'exemple Microsoft 365 Agents SDK. Cet exemple prédéfini implémente le noyau sémantique pour l’orchestration avec des modèles Azure AI Foundry ou Azure OpenAI. Vous pouvez également utiliser l’exemple d’agent vide si vous souhaitez commencer sans modèle ou orchestrateur.

   

   Un dialogue vous invite à choisir le service LLM que vous souhaitez utiliser.

   

6. 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.

   

7. Renseignez les entrées requises : Azure clé de service OpenAI, Azure point de terminaison OpenAI et Azure nom du déploiement OpenAI.

8. Cliquez sur Créer. Le kit de ressources crée le projet à partir d’un modèle pour vous.

9. Dans un court laps de temps, vous devez avoir un projet créé à l’aide du Kit de développement logiciel (SDK) Agents.

   

Tester votre agent dans Microsoft 365 Agents Playground

Pour commencer, vous pouvez tester localement à l’aide de Microsoft 365 Agents Playground dans le Kit de ressources.

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

Le terrain de jeu s’ouvre pour vous permettre de tester dans une nouvelle fenêtre de navigateur avec votre hôte local et affiche le terrain de jeu avec celui-ci prêt à être testé. Commencez à envoyer des messages à votre agent pour tester son comportement.

Débogez et testez votre agent dans Microsoft Teams ou Microsoft Copilot

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

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

   

   Il faut quelques instants pour passer à Microsoft Teams. Vous êtes invité à ajouter votre agent dans le client Teams qui s’ouvre.

   

2. Sélectionnez Ajouter. Un volet de notification s’affiche, indiquant que l’agent est ajouté avec succès.

   

3. Sélectionnez Ouvrir sur votre nouvel agent pour l’ouvrir dans Teams. Vous pouvez poser des questions à votre agent, 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 et d'un agent Microsoft 365 Agents à l'aide de l'Ensemble d'outils des agents
• Testé l’agent localement à l’aide de Microsoft 365 Agents Playground
• Déployez l’assistant pour le débogage directement dans le canal Teams ou Microsoft 365