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 la boîte à outils des agents, vous avez tout configuré pour tester en utilisant directement le terrain de jeu des agents. Vous pouvez tester dans l’Agents Playground soit localement, soit dans Microsoft Copilot ou Microsoft Teams. Ce scénario est abordé dans :

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

Si vous commencez votre projet en utilisant la CLI ou clonez un échantillon et l’ouvrez dans votre IDE, vous pouvez utiliser le Terrain de jeu local des agents pour tester. L'Agents Playground se connecte à votre code local.

Vous pouvez installer l’Agents Playground en utilisant l’une des méthodes suivantes :

Option 1 : Installer le fichier binaire autonome

winget install agentsplayground

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 assistant de démarrage rapide ou cloné un exemple du dépôt, utilisez-le avec le terrain de jeu Agents.

  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 (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"

    Lorsque votre agent commence, il s’ouvre comme on le voit sur l’image suivante. Vous pouvez poser des questions et tester votre agent dans l’interface de terrain de jeu.

    Microsoft 365 Agents Playground

Dans la mesure du possible, commencez par la boîte à outils Microsoft 365 Agents. Le kit de ressources facilite la prise en main, le test localement et le déploiement plus facile et plus rapide. Elle automatise une grande partie de la configuration manuelle d’Azure Bot Service et des inscriptions d’applications Azure, vous évitant ainsi d’avoir à le faire. En commençant manuellement, vous devez effectuer ces étapes manuelles vous-même.

Résumé

Vous avez testé votre Microsoft 365 Agents SDK localement en utilisant le Playground des Agents Microsoft 365. Vous avez commencé avec un échantillon cloné du dépôt GitHub ou de la ligne de commande.

  • Dernière mise à jour :