Créer des agents JavaScript dans Visual Studio Code avec microsoft 365 Agents Toolkit

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

Prerequisites

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

• Vous avez besoin d’un modèle OpenAI Azure à partir du portail Microsoft Foundry. Vous avez besoin des données suivantes sur le modèle :

  • Nom
  • URI cible
  • Clé

  Découvrez comment ajouter et configurer des modèles à des modèles Azure AI Foundry

Créer 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.

1. Dans Visual Studio Code, ouvrez le panneau latéral de l’extension Microsoft 365 Agents Toolkit en sélectionnant l’icône Microsoft 365 Agents dans la barre latérale.

2. Pour générer un projet d’agent, sélectionnez Créer un agent/application. 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 guide explique comment commencer par le kit de ressources Agents.

1. Pour commencer à créer un agent avec le Kit de développement logiciel (SDK) Agents, sélectionnez Agent de moteur personnalisé :

Créer un agent

Avec l'agent de moteur personnalisé sélectionné en tant qu'option, vous êtes guidé à travers une série d'instructions pour ajouter vos propres services d'IA.

Vous avez deux modèles à sélectionner :

• Agent de moteur personnalisé de base
• Agent météo.

L’assistant de moteur de base personnalisé est un assistant non prédéfini. Vous devez ajouter un orchestrateur IA, comme Noyau sémantique ou LangChain, et vos connaissances, pour que l’agent soit utile.

1. Dans cet exemple, sélectionnez Weather Agent pour créer un agent qui utilise LangChain et Azure AI Foundry, en fonction de votre langue choisie.

Vous êtes invité à sélectionner un service LLM.

1. Sélectionnez Azure OpenAI pour votre modèle.

   

   Vous êtes invité à entrer votre URI Key, Target URI et le Name de votre modèle OpenAI Azure à partir du portail Microsoft Foundry. Vous trouverez ces informations sous Mes ressources et modèles et points de terminaison dans le portail Foundry.

2. Entrez les détails du modèle, en commençant par la clé de service OpenAI Azure.

   

3. Sélectionnez JavaScript ou TypeScript, sélectionnez le dossier par défaut, puis entrez un nom d’application pour stocker votre dossier racine de projet à l’emplacement par défaut.

   Votre nouveau projet s’ouvre.

   

4. Vérifiez que vous êtes connecté à l’aide de l’extension en sélectionnant le logo Microsoft 365 dans la barre d’outils de Visual Studio Code. Vérifiez que vous êtes connecté au locataire auquel vous souhaitez vous connecter.

   

Déboguer et tester votre agent dans Agents Playground

Vous pouvez déboguer et tester votre code avec le nouveau terrain de jeu de jeux de l’agent Microsoft 365 disponible dans le kit de ressources. Le terrain de jeu vous permet de déboguer facilement votre code et sans avoir à passer par un cycle de déploiement complet.

1. Sélectionnez l'option de débogage dans Microsoft 365 Agents Playground.

   Lorsque vous sélectionnez le terrain de jeu, patientez un peu pendant qu’il prépare votre ordinateur local avec les composants requis. La préparation prend quelques minutes.

   

2. Pendant que vous attendez le déploiement, vérifiez votre dossier pour le code et examinez-le pour vous familiariser.

   

3. Une fois que l'environnement de test et de débogage a terminé de charger, un navigateur s’ouvre et vous êtes prêt à interagir avec votre agent à l’aide du terrain de jeu. Si vous suivez le guide et utilisez le modèle prédéfini avec LangChain et Azure AI Foundry, vous pouvez demander « Qu’est-ce que la météo dans {votre emplacement} demain ? » L’agent répond avec une carte adaptative avec le temps, à l’aide de votre service IA choisi.

   

   

Déboguer et tester votre agent dans Microsoft 365 Copilot

Une fois que vous avez terminé de tester localement dans Agent Playground, vous pouvez déployer sur Azure Bot Service et configurer pour le canal Microsoft 365 Copilot. Vérifiez que vous êtes connecté à un locataire qui a accès à Microsoft 365 Copilot.

1. Remplacez la cible de débogage par Copilot pour pouvoir déboguer à l’aide de Microsoft 365 Copilot. Sélectionnez F5 sur le clavier ou Déboguer pour tester. Il faut quelques minutes de préparation pour rendre l’agent disponible pour Microsoft 365. En coulisses, le kit d'outils crée une inscription d'application et un enregistrement Azure Bot Service dans Azure Bot Service, puis déploie votre projet sur votre locataire accompagné d'un manifeste.

   

2. Une fois votre projet déployé, vous devez voir Microsoft 365 Copilot charger et être en mesure de poser des questions, d’ajouter des points d’arrêt et de déboguer, en fonction des besoins, directement dans Microsoft 365 Copilot :

   

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éploiement de l’assistant pour le débogage directement dans le canal Microsoft 365