Tester votre agent localement dans Microsoft 365 Agents Playground

Les détails de la façon de tester votre agent localement dépendent de la façon dont vous avez créé votre agent.

Vous pouvez créer un agent à l’aide du Kit de développement logiciel (SDK) Microsoft 365 Agents de trois façons :

• Commencez par le Kit de ressources Microsoft 365 Agents en C#, JavaScript ou Python à l’aide de Visual Studio ou de Visual Studio Code
• Cloner à partir d’un exemple et ouvrir dans votre IDE
• Utiliser l’interface CLI

Démarrer votre projet avec le kit de ressources

Si vous commencez avec le kit de ressources Agents, vous avez tout configuré pour tester directement l’utilisation de Agents Playground. Vous pouvez tester dans le « Agents Playground » soit localement, soit dans Microsoft 365 Copilot ou Microsoft Teams. Ce scénario est abordé dans :

• Procédure pas à pas de Visual Studio Code
• Procédure pas à pas de Visual Studio

Démarrez votre projet en clonant ou avec l’interface CLI

Si vous démarrez votre projet à l’aide de l’interface CLI ou clonez un exemple et ouvrez dans votre IDE, vous pouvez utiliser le terrain de jeu des agents local pour tester. L'Agents Playground se connecte à votre code local.

Vous pouvez installer Agents Playground à l’aide de l’une des méthodes suivantes :

Option 1 : Installer le fichier binaire autonome

winget install agentsplayground

curl -s https://raw.githubusercontent.com/OfficeDev/microsoft-365-agents-toolkit/dev/.github/scripts/install-agentsplayground-linux.sh | bash

Option 2 : Installer à l’aide de npm

• Installez Node.js (s’il n’est pas déjà installé) : téléchargez et installez la dernière Node.js à partir de nodejs.org.

• Installez le package Agents Playground :

  Pour une installation globale (recommandé) :

  npm install -g @microsoft/m365agentsplayground
  

  Pour une installation spécifique au projet :

  npm install -D @microsoft/m365agentsplayground
  

Tester votre assistant

1. Une fois que vous avez créé votre agent de démarrage rapide ou cloné un exemple à partir du dépôt, vous pouvez l’utiliser avec Agent Playground.

2. Agent Playground prend en charge les modes anonymes et authentifiés. Pour les tests anonymes, aucune autre configuration n’est requise. Si vous souhaitez tester l’authentification, vous devez configurer les inscriptions d’applications Microsoft Entra ID pour les deux agents Playground (les options sont fournies dans le texte suivant) et votre application. Pour plus d’informations, consultez Provisionnement d’un bot Azure à utiliser avec le SDK Agents.

3. Configurez correctement vos ports dans votre application. Sélectionnez un port disponible pour votre agent (la valeur par défaut est 3978, mais vous pouvez utiliser n’importe quel port disponible).

4. Exécutez votre code.

5. Ouvrez le terrain de jeu Assistants et commencez par le point de terminaison de votre assistant :

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator"
   

   Configurez l’authentification si nécessaire par votre agent :

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator" --client-id "your-client-id" --client-secret "your-client-secret" --tenant-id "your-tenant-id"
   

   Options clés :

   • -e, --app-endpoint: URL du point de terminaison de votre agent (par exemple, http://localhost:3978/api/messages)
   • -c, --channel-id: Type de canal (par exemple, emulator, webchat, msteams). Chaque canal fournit différentes propriétés d’expérience utilisateur et d’activité.
   • --client-id: ID client pour l’authentification
   • --client-secret: clé secrète client pour l’authentification
   • --tenant-id: ID de locataire pour l’authentification

   Permet agentsplayground --help d’afficher la liste complète des options disponibles.

   Vous pouvez également utiliser des variables d’environnement plutôt que des options CLI. Si les deux sont spécifiés, l’option CLI a une priorité plus élevée.

   export BOT_ENDPOINT="http://localhost:<your-agent-port>/api/messages"
   export DEFAULT_CHANNEL_ID="emulator"
   export AUTH_CLIENT_ID="your-client-id"
   export AUTH_CLIENT_SECRET="your-client-secret"
   export AUTH_TENANT_ID="your-tenant-id"
   

   Une fois votre agent démarré, il doit s’ouvrir comme indiqué dans l’image suivante. Vous pouvez poser des questions et tester votre agent dans l’interface de terrain de jeu.

   

Dans la mesure du possible, nous vous recommandons de commencer par microsoft 365 Agents Toolkit. Le kit de ressources facilite la prise en main, le test localement et le déploiement plus facile et plus rapide. Il extrait beaucoup la configuration manuelle d’Azure Bot Service et d’Azure App Registrations afin que vous n’ayez pas à le faire. En commençant manuellement, vous devez effectuer ces étapes manuelles vous-même.

Résumé

Vous avez testé votre Kit de développement logiciel (SDK) Microsoft 365 Agents localement à l’aide de Microsoft 365 Agents Playground, en commençant par un exemple cloné à partir du dépôt GitHub ou de l’interface CLI.