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 Microsoft 365 Agents SDK:

• 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 u begint met de Agents Toolkit, hebt u alles ingesteld om direct te testen met behulp van de Agents Playground. U kunt testen in de Agents Playground, hetzij lokaal, hetzij in Microsoft 365 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 u uw project start met behulp van de CLI of een voorbeeld 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: 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. Zodra u uw quickstart-agent hebt gemaakt of een voorbeeld uit de opslagplaats hebt gekloond, kunt u deze gebruiken 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 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 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"
   

   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 speeltuininterface.

   

Waar mogelijk raden we u aan om te beginnen 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 installatie van de Azure Bot Service en Azure App-registraties, zodat u dat niet hoeft te doen. Als u handmatig begint, moet u deze handmatige stappen zelf uitvoeren.

Samenvatting

U hebt uw Microsoft 365 Agents SDK lokaal getest met behulp van de Microsoft 365 Agents Playground, te beginnen met een gekloond voorbeeld uit de GitHub-opslagplaats of vanuit de CLI.