Delen via

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:

  • Klonen vanuit een voorbeeld en openen in uw IDE
  • Begin met de Microsoft 365 Agents Toolkit in C#, JS of Python met behulp van Visual Studio of Visual Studio Code
  • Gebruik de CLI, zoals wordt weergegeven in de quickstart

De Microsoft 365 Agents Playground gebruiken

U hebt uw project gestart met de toolkit

Als u met de toolkit begint, 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 de handleiding van Visual Studio Code en in die van Visual Studio.

U bent uw project gestart door te klonen met de command line interface (CLI).

Als u uw project start met behulp van de CLI of door een voorbeeld te klonen en het voorbeeld te openen 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
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

  1. Zodra uw quickstart-agent is gemaakt of een voorbeeld uit de opslagplaats is gekloond, kunt u deze met Agents Playground gebruiken.

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

  3. Configureer uw poorten correct in uw app. Kies een beschikbare poort voor uw agent (standaard is 3978, maar kan elke beschikbare poort zijn).

  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 deze is gestart, moet deze worden geopend zoals wordt weergegeven in de volgende afbeelding. U kunt vragen stellen en uw agent testen in de speeltuininterface.

    Microsoft 365 Agents Playground

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.

Summary

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

  • Last updated on