Partager via

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 :

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

Utilisation de Microsoft 365 Agents Playground

Vous avez démarré votre projet avec le kit de ressources

Si vous commencez par la boîte à outils, 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 la procédure pas à pas de Visual Studio Code et dans la procédure pas à pas de Visual Studio, respectivement.

Vous avez démarré votre projet en le clonant ou en utilisant l'interface en ligne de commande.

Si vous démarrez votre projet à l’aide de l’interface CLI ou en clonant un exemple et en ouvrant l’exemple dans votre IDE, vous pouvez utiliser le terrain de jeu des agents locaux 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
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

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

  2. Agent Playground prend en charge les modes anonymes et authentifiés. Pour les tests anonymes, aucune configuration supplémentaire n’est requise. Si vous souhaitez tester l’authentification, vous devez configurer les enregistrements d'application pour Microsoft Entra ID pour les Agents Playground (les options sont fournies ci-dessous) et votre application. Pour plus d’informations, consultez Provisionnement d’un bot Azure à utiliser avec le Kit de développement logiciel (SDK) Agents.

  3. Configurez correctement vos ports dans votre application. Choisissez un port disponible pour votre agent (la valeur par défaut est 3978, mais peut être 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 le démarrage 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.

    Microsoft 365 Agents Playground

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.

Summary

Vous avez testé avec succès votre Kit de développement logiciel (SDK) Microsoft 365 Agents localement à l’aide de Microsoft 365 Agents Playground lors du démarrage d’un exemple cloné à partir du dépôt GitHub ou de l’interface CLI.

  • Last updated on