Uw agent lokaal testen in Microsoft 365 Agents Playground

De details van hoe u uw agent lokaal kunt testen, hangen af van hoe u uw agent hebt ontwikkeld.

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

• Begin met de Microsoft 365 Agents Toolkit in C#, JavaScript of Python met Visual Studio of Visual Studio Code
• Kloon een sample en open deze in uw IDE
• De CLI gebruiken

Start uw project met de toolkit

Als u met de Agents Toolkit begint, is alles meteen klaar om te testen in de Agents Playground. U kunt testen in Agents Playground, lokaal of in Microsoft 365 Copilot of Microsoft Teams. Dit scenario wordt behandeld in:

• Visual Studio Code-procedure
• Visual Studio-procedure

Begin uw project met klonen of met de CLI

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

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

Optie 1: installeer het standalone binaire bestand

winget install agentsplayground

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

Optie 2: installeer via npm

• Installeer Node.js (als het nog niet geïnstalleerd is): download en installeer de nieuwste Node.js via 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 u uw quickstart-agent hebt gemaakt of een voorbeeld uit de opslagplaats hebt gekloond, kunt u dit gebruiken met de Agents Playground.

2. De Agents Playground ondersteunt zowel anonieme als geverifieerde modi. Voor anoniem testen is geen andere configuratie vereist. Als u met verificatie wilt testen, moet u Microsoft Entra ID-appregistraties configureren voor zowel de Agents Playground (de opties worden hieronder toegelicht) 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 uw agent (standaard is 3978, maar u 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 verificatie indien vereist 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 een andere gebruikerservaring en activiteitseigenschappen.
   • --client-id: client-id voor verificatie
   • --client-secret: clientgeheim voor verificatie
   • --tenant-id: tenant-id voor verificatie

   Gebruik agentsplayground --help om de volledige lijst met beschikbare opties te zien.

   U kunt ook omgevingsvariabelen gebruiken in plaats van CLI-opties. Als beide zijn gespecificeerd, 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"
   

   Zodra uw agent is gestart, moet deze worden geopend zoals wordt weergegeven in de volgende afbeelding. U kunt vragen stellen en uw agent testen in de playground-interface.

   

Waar mogelijk raden we aan om te beginnen met de Microsoft 365 Agents Toolkit. De toolkit maakt het starten, lokaal testen en implementeren gemakkelijker en sneller. Het abstraheert veel van de handmatige configuratie van de Azure Bot Service en Azure-appregistraties, waardoor u dit niet zelf hoeft te doen. Als u handmatig begint, moet u deze stappen zelf uitvoeren.

Overzicht

U hebt lokaal uw SDK voor Microsoft 365-agenten getest met de Microsoft 365 Agents Playground, waarbij u begon met een gekloond voorbeeld uit de GitHub-opslagplaats of uit de CLI.