Guide de démarrage rapide pour l’utilisation de l’API Assistants avec la bibliothèque d’IA Teams

Prise en main d’OpenAI ou de l’API Assistants Azure OpenAI avec la bibliothèque IA Teams dans Math tutor assistant exemple. Ce guide utilise l’outil OpenAI Code Interpreter pour vous aider à créer un assistant spécialisé dans les mathématiques. Le bot utilise le modèle gpt-3.5-turbo pour discuter avec les utilisateurs de Microsoft Teams et répondre de manière polie et respectueuse, en restant dans le cadre de la conversation.

Configuration requise

Pour commencer, vérifiez que vous disposez des outils suivants :

Installer	Pour l’utilisation...
Visual Studio Code	Environnements de build JavaScript, TypeScript ou C Sharp. Utilisez la dernière version.
Toolkit Teams	Microsoft Visual Studio Code extension qui crée une structure de projet pour votre application. Utilisez la dernière version.
Git	Git est un système de gestion de version qui vous permet de gérer différentes versions de code dans un dépôt.
Node.js	Environnement runtime JavaScript principal. Pour plus d’informations, consultez Node.js table de compatibilité des versions pour le type de projet.
Microsoft Teams	Pour collaborer avec tout le monde, vous utilisez des applications pour la conversation, les réunions et les appels en un seul endroit.
OpenAI ou Azure OpenAI	Commencez par créer votre clé API OpenAI pour utiliser le GPT d’OpenAI. Si vous souhaitez héberger votre application ou accéder à des ressources dans Azure, vous devez créer un service Azure OpenAI.
Microsoft Edge (recommandé) ou Google Chrome	Un navigateur avec des outils de développement.
Compte de développeur Microsoft 365	Accès au compte Teams avec les autorisations appropriées pour installer une application et activer les applications Teams personnalisées et activer le chargement d’applications personnalisées.

Si vous avez déjà exécuté les exemples auparavant ou si vous avez rencontré une erreur d’exécution, procédez comme suit pour démarrer à nouveau :

• Vérifiez tous les .env fichiers et env/.env.*.* de l’exemple et supprimez toutes les valeurs remplies automatiquement pour vous assurer que teams Toolkit génère de nouvelles ressources pour vous.
• Si vous ne souhaitez pas que Teams Toolkit génère l’ID et le mot de passe de l’application, mettez à jour et MicrosoftAppIdMicrosoftAppPassword dans le .env fichier avec vos propres valeurs.
• Supprimez les valeurs ou laissez les valeurs vides pour SECRET_BOT_PASSWORD et TEAMS_APP_UPDATE_TIME dans le .env fichier afin d’éviter les conflits.

Le Kit de ressources Teams provisionne MicrosoftAppId automatiquement les ressources.MicrosoftAppPassword Si vous souhaitez utiliser vos propres ressources, vous devez les ajouter manuellement au .env fichier. Teams Toolkit ne génère pas automatiquement les ressources suivantes :

• Une clé Azure OpenAI ou OpenAI
• Une base de données ou des options de stockage similaires

Générer et exécuter l’exemple d’application

Prise en main de la bibliothèque IA Teams à l’aide de l’exemple de assistant de cours de mathématiques. Il permet à localhost de votre ordinateur d’exécuter rapidement un exemple basé sur une bibliothèque IA Teams.

1. Accédez à l’exemple.

2. Exécutez la commande suivante pour cloner le référentiel :

   git clone https://github.com/microsoft/teams-ai.git
   

3. Allez à Visual Studio Code.

4. Sélectionnez Fichier>Ouvrir le dossier.

5. Accédez à l’emplacement où vous avez cloné le référentiel teams-ai et sélectionnez le dossier teams-ai .

6. Sélectionnez Sélectionner un dossier.

   

7. Sélectionnez Afficher le>terminal. Une fenêtre de terminal s’ouvre.

8. Dans la fenêtre de terminal, exécutez la commande suivante pour accéder au dossier js :

   cd .\js\
   

9. Exécutez la commande suivante pour installer les dépendances :

   yarn install
   

10. Exécutez la commande suivante pour générer des dépendances :

    yarn build
    

11. Une fois les dépendances installées, sélectionnez Fichier>Ouvrir le dossier.

12. Accédez à teams-ai > js > samples > 04.ai-apps > d.assistants-mathBot et sélectionnez Sélectionner un dossier. Tous les fichiers de l’exemple de assistant de cours de mathématiques sont répertoriés sous la section EXPLORATEUR dans Visual Studio Code.

13. Sous EXPLORATEUR, dupliquez le sample.env fichier et mettez à jour le fichier en double avec .env.

14. Mettez à jour les étapes suivantes en fonction des services IA que vous sélectionnez.

    • Clé OpenAI
    • Azure OpenAI

    1. Accédez au env dossier et mettez à jour le code suivant dans le ./env/.env.local.user fichier :

       SECRET_OPENAI_KEY=<your OpenAI key>
       ASSISTANT_ID=<your Assistant ID>
       

    2. Accédez au infra dossier et vérifiez que les lignes suivantes du azure.bicep fichier sont commentées :

           // {
           //  name: 'AZURE_OPENAI_KEY'
           //  value: azureOpenAIKey
           // }
           // {
           //  name: 'AZURE_OPENAI_ENDPOINT'
           //  value: azureOpenAIEndpoint
           // }
       

15. Copiez l’exemple dans un nouveau répertoire qui n’est pas un sous-répertoire de teams-ai.

16. Dans le volet de gauche, sélectionnez Boîte à outils Teams.

17. Sous COMPTES, connectez-vous aux éléments suivants :

    • Compte Microsoft 365
    • Compte Azure

18. Pour déboguer votre application, sélectionnez la touche F5 .

    Un onglet de navigateur ouvre un client web Teams demandant à ajouter le bot à votre locataire.

19. Sélectionnez Ajouter.

    

    Une fenêtre de conversation s’ouvre.

20. Dans la zone de composition des messages, envoyez un message pour appeler le bot.

    

Outils supplémentaires

Vous pouvez également utiliser les outils suivants pour exécuter et configurer un exemple :

1. Interface CLI du Kit de ressources Teams : vous pouvez utiliser l’interface CLI du Kit de ressources Teams pour créer et gérer des applications Microsoft Teams à partir de la ligne de commande. Pour plus d’informations, consultez Les instructions de configuration de l’interface CLI du Kit de ressources Teams.

2. Bot Framework Emulator : le Bot Framework Emulator est une application de bureau qui vous permet de tester et de déboguer votre bot localement. Vous pouvez vous connecter à votre bot en entrant l’URL du point de terminaison du bot, ainsi que l’ID et le mot de passe de l’application Microsoft. Vous pouvez ensuite envoyer des messages à votre bot et voir ses réponses en temps réel. Pour plus d’informations, consultez Bot Framework Emulator instructions de configuration.

3. Configuration manuelle : si vous préférez configurer vos ressources manuellement, vous pouvez le faire en suivant les instructions fournies par les services respectifs. Pour plus d’informations, consultez instructions de configuration manuelle.

Étape suivante