Tester votre assistant localement dans le terrain de jeu des assistants Microsoft 365

Les détails de la procédure de test local de votre assistant dépendent de la manière dont vous l’avez créé.

Vous pouvez créer un assistant en utilisant Microsoft 365 Agents SDK de trois façons :

  • Commencez avec la boîte à outils Microsoft 365 Agents en C#, JavaScript ou Python en utilisant Visual Studio ou Visual Studio Code
  • Clonez un exemple et ouvrez-le dans votre IDE
  • Utiliser l’interface CLI

Commencez votre projet avec la boîte à outils

Si vous commencez avec la boîte à outils Agents, vous avez tout configuré pour tester directement avec le terrain de jeu Agents. Vous pouvez tester dans le terrain de jeu Agents soit localement, soit dans Microsoft 365 Copilot ou Microsoft Teams. Ce scénario est abordé dans :

Commencez votre projet par un clonage ou avec la CLI

Si vous démarrez votre projet avec la CLI ou clonez un exemple et l’ouvrez dans votre IDE, vous pouvez utiliser le terrain de jeu Agents local pour effectuer des tests. Le terrain de jeu Agents se connecte à votre code local.

Vous pouvez installer le terrain de jeux Agents : installez le terrain de jeu Agents via l’une des méthodes suivantes :

Option 1 : Installer le binaire autonome

winget install agentsplayground

Option 2 : Installer avec npm

  • Installez Node.js (si ce n’est pas déjà fait) : téléchargez et installez la dernière version de Node.js sur nodejs.org.

  • Installez le package de terrain de jeu Agents :

    Pour une installation générale (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, vous pouvez l’utiliser avec le terrain de jeu Agents.

  2. Le terrain de jeu Agents prend en charge à la fois les modes anonymes et authentifiés. Pour les tests anonymes, aucune autre configuration n’est requise. Si vous souhaitez effectuer des tests avec authentification, vous devez configurer les enregistrements d’applications Microsoft Entra ID à la fois pour le terrain de jeu Agents (des options sont fournies dans le texte qui suit) et pour 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 assistant (le port par défaut est 3978, mais vous pouvez utiliser tout 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 votre assistant l’exige :

    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 assistant (par exemple, http://localhost:3978/api/messages)
    • -c, --channel-id : type de canal (par exemple, emulator, webchat, msteams). Chaque canal offre une expérience utilisateur et des propriétés d’activité différentes.
    • --client-id : ID client pour l’authentification
    • --client-secret : secret client pour l’authentification
    • --tenant-id : ID locataire pour l’authentification

    Utilisez agentsplayground --help pour voir la liste complète des options disponibles.

    Vous pouvez également utiliser des variables d’environnement au lieu des options de la CLI. Si les deux sont spécifiés, l’option de la CLI a la priorité.

    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 assistant démarré, il doit s’ouvrir comme indiqué dans l’image suivante. Vous pouvez poser des questions et tester votre assistant dans l’interface du de terrain de jeu.

    Terrain de jeu Microsoft 365 Agents

Dans la mesure du possible, nous vous recommandons de commencer par la boîte à outils Microsoft 365 Agents. La boîte à outils facilite et accélère le démarrage, les tests locaux et le déploiement. Elle automatise une grande partie de la configuration manuelle d’Azure Bot Service et des enregistrements d’applications Azure, vous évitant ainsi d’avoir à le faire. En procédant manuellement, vous devrez réaliser ces étapes vous-même.

Résumé

Vous avez testé votre instance de Microsoft 365 Agents SDK en local avec le terrain de jeu Microsoft 365 Agents, en commençant par un exemple cloné depuis le dépôt GitHub ou via la CLI.

  • Last updated on