Uw agent lokaal testen in Microsoft 365 Agents Playground

De details van het lokaal testen van uw agent zijn afhankelijk van hoe u uw agent hebt gemaakt.

U kunt op drie manieren een agent maken met behulp van de SDK voor Microsoft 365-agenten:

• Begin met de Microsoft 365 Agents Toolkit in C#, JavaScript of Python met behulp van Visual Studio of Visual Studio Code
• Klonen vanuit een voorbeeld en openen in uw IDE
• De CLI gebruiken

Uw project starten met de toolkit

Als je begint met de Agents Toolkit, heb je alles direct ingesteld om te testen door de Agents Playground te gebruiken. Je kunt het testen in de Agents Playground lokaal of in Microsoft Copilot of Microsoft Teams. Dit scenario wordt behandeld in:

• Overzicht van Visual Studio Code
• Overzicht van Visual Studio

Start uw project door te klonen of met de CLI

Als je je project start met de CLI of een voorbeeld kloont en opent in je IDE, kun je de lokale Agents Playground gebruiken om te testen. De Agents Playground maakt verbinding met uw lokale code.

Je kunt de Agents Playground installeren met een van de volgende methoden:

Optie 1: Het zelfstandige binaire bestand installeren

winget install agentsplayground

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

Optie 2: Installeren met npm

• Installeer Node.js (indien nog niet geïnstalleerd): Download en installeer de meest recente Node.js van nodejs.org.

• Installeer het Agents Playground-pakket:

  Voor globale installatie (aanbevolen):

  npm install -g @microsoft/m365agentsplayground
  

  Voor projectspecifieke installatie:

  npm install -D @microsoft/m365agentsplayground
  

Uw agent testen

1. Nadat je je quickstart-agent hebt gemaakt of een sample uit de repo hebt gekloond, gebruik je deze met de Agents Playground.

2. De Agents Playground ondersteunt zowel anonieme als geverifieerde modi. Voor anonieme tests is geen andere configuratie vereist. Als u wilt testen met verificatie, moet u app-registraties van Microsoft Entra ID configureren voor zowel de Agents Playground (opties worden weergegeven in de volgende tekst) als uw toepassing. Zie Een Azure-bot inrichten voor gebruik met agents-SDK voor meer informatie.

3. Configureer uw poorten correct in uw app. Selecteer een beschikbare poort voor je agent (de standaard is 3978, maar je kunt elke beschikbare poort gebruiken).

4. Voer uw code uit.

5. Open de Agents Playground en begin met het eindpunt van uw agent:

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

   Configureer indien nodig verificatie door uw 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"
   

   Belangrijkste opties:

   • -e, --app-endpoint: de eindpunt-URL van uw agent (bijvoorbeeld http://localhost:3978/api/messages)
   • -c, --channel-id: Kanaaltype (bijvoorbeeld emulator, webchat, msteams). Elk kanaal biedt verschillende gebruikerservarings- en activiteitseigenschappen.
   • --client-id: Client-id voor verificatie
   • --client-secret: Clientgeheim voor verificatie
   • --tenant-id: Tenant-id voor verificatie

   Gebruik agentsplayground --help deze optie om de volledige lijst met beschikbare opties weer te geven.

   U kunt ook omgevingsvariabelen gebruiken in plaats van CLI-opties. Als beide zijn opgegeven, heeft de CLI-optie een hogere prioriteit.

   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"
   

   Wanneer je agent start, wordt deze geopend zoals in de volgende afbeelding. U kunt vragen stellen en uw agent testen in de speeltuininterface.

   

Begin waar mogelijk met de Microsoft 365 Agents Toolkit. Met de toolkit kunt u eenvoudiger en sneller aan de slag, lokaal testen en implementeren. Het abstraheert veel van de handmatige opzet van de Azure Bot Service en Azure App-registraties zodat je dat niet hoeft te doen. Als u handmatig begint, moet u deze handmatige stappen zelf uitvoeren.

Overzicht

Je hebt je SDK voor Microsoft 365-agenten lokaal getest met behulp van de Microsoft 365 Agents Playground. Je begon met een gekloonde sample uit de GitHub-repo of uit de CLI.