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.

Conditions préalables

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

• Vous avez besoin d’un modèle Azure à partir du portail Azure AI Foundry. Vous avez besoin de ces données 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.

Vous pouvez créer un projet d’agent en sélectionnant Créer un agent/application dans le Kit de ressources Microsoft 365 Agents. 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.

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

Créer un assistant

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.

1. Vous avez deux modèles à sélectionner : Agent de moteur personnalisé de base ou Agent météo. L’assistant de moteur de base personnalisé est un assistant non prédéfini. Vous devez ajouter un orchestrateur IA, tel que le noyau sémantique ou LangChain, et vos connaissances.

   

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

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

   

   Vous êtes invité à entrer votre clé, votre URI cible et le nom de votre modèle Azure à partir du portail Azure AI Foundry. Vous trouverez ces informations sous Mes ressources et modèles et points de terminaison dans le portail Foundry.

4. Entrez les détails, en commençant par la clé :

   

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

   

6. 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 avez suivi le guide et utilisé le modèle prédéfini avec LangChain et Azure AI Foundry, vous pouvez demander « Quelle est 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 ou Déboguer pour tester. Il faut quelques minutes de préparation pour rendre l’agent disponible pour Microsoft 365. En arrière-plan, la boîte à outils crée un enregistrement d'application et de service de bot dans Azure Bot Service et déploie votre projet dans votre locataire ainsi qu'un manifeste.

   

2. Une fois cette opération terminée, vous devez voir le chargement de Microsoft 365 Copilot 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 Microsoft 365 Agents à l’aide du kit d’outils Assistants
• 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