Créer des assistants JavaScript dans Visual Studio Code avec le kit de création d’assistants Microsoft 365

Dans cet article, vous apprenez à créer un nouveau projet JavaScript SDK Agents dans Visual Studio, en utilisant le kit de création d’assistants Microsoft 365.

Configuration requise

• Installer l’extension Kit de création d’assistants pour Visual Studio Code.

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

  • Nom
  • URI cible
  • Clé

  Apprenez comment ajouter et configurer des modèles dans les Modèles Azure AI Foundry

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.

1. Dans Visual Studio Code, ouvrez le volet de l’extension Kit de création d’assistants Microsoft 365 en cliquant sur l’icône Assistants Microsoft 365 dans la barre latérale.

2. Pour créer un nouveau projet d’assistant, sélectionnez Créer un assistant/une application. Vous pouvez démarrer à partir d’un modèle dans la boîte à outils ou à partir d’exemples dans l’Agents SDK. Ce guide traite du démarrage avec le Kit de création d’assistants.

1. Pour commencer à créer un assistant avec l’Agents SDK, sélectionnez Assistant de moteur personnalisé :

Créer un assistant

Lorsque l’option « Assistant moteur personnalisé » est sélectionnée, vous êtes guidé à travers une série de requêtes pour ajouter vos propres services d’IA.

Vous pouvez choisir entre deux modèles :

• Assistant de moteur personnalisé de base
• Assistant météorologique.

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, ainsi que vos connaissances, pour que l’assistant soit utile.

1. Dans cet exemple, sélectionnez Assistant météorologique pour créer un assistant qui utilise LangChain et Azure AI Foundry, selon la langue choisie.

Une invite vous demande de sélectionner un service LLM.

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

   

   Vous êtes invité à saisir votre Clé, votre URI cible et le Nom de votre modèle Azure OpenAI dans le portail Microsoft Foundry. Vous pouvez trouver ces informations dans le portail Foundry, sous Mes ressources et Modèles et points de terminaison.

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

   

3. Sélectionnez JavaScript ou TypeScript, sélectionnez le dossier par défaut, et saisissez 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. Assurez-vous d’être connecté au locataire souhaité.

   

Déboguer et tester votre assistant dans Agents Playground

Vous pouvez déboguer et tester votre code avec le nouveau Microsoft 365 Agent Playground disponible dans la boîte à outils. Le playground vous permet de déboguer votre code facilement, 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 playground, attendez quelques instants pendant qu’il prépare votre machine locale avec les composants nécessaires. La préparation prend quelques minutes.

   

2. En attendant le déploiement, vérifiez votre dossier de code et examinez-le pour vous familiariser avec son contenu.

   

3. Une fois que le playground de débogage et de test a fini de charger, un navigateur s’ouvre et vous êtes prêt à interagir avec votre assistant via le playground. Si vous suivez le guide et utilisez le modèle prédéfini avec LangChain et Azure AI Foundry, vous pouvez demander « Quel temps fera-t-il demain à {votre emplacement} ? » L’assistant répond avec une carte adaptative indiquant la météo, en utilisant le service d’IA de votre choix.

   

   

Déboguer et tester votre assistant dans Microsoft 365 Copilot

Une fois les tests locaux terminés dans l’Agents Playground, vous pouvez déployer sur Azure Bot Service et configurer le canal Microsoft 365 Copilot. Assurez-vous d’être connecté à un locataire ayant accès à Microsoft 365 Copilot.

1. Changez la cible de débogage en Copilot, afin que vous puissiez déboguer dans Microsoft 365 Copilot. Sélectionnez F5 sur le clavier ou Déboguer pour tester. Il faut quelques minutes de préparation pour rendre l’assistant disponible pour Microsoft 365. En arrière-plan, 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 dans votre locataire avec un manifeste.

   

2. Une fois votre projet déployé, vous devriez voir Microsoft 365 Copilot se lancer et pouvoir poser des questions, ajouter des points d’arrêt et effectuer un débogage, selon les 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
• Tester l’assistant localement en utilisant Microsoft 365 Agents Playground
• Déploiement de l’assistant pour le débogage directement dans le canal Microsoft 365