Testa din agent lokalt i Testplats för Microsoft 365-agenter

Detaljerna kring hur du testar din agent lokalt beror på hur du skapade agenten.

Du kan skapa en agent med SDK för Microsoft 365-agenter på tre sätt:

• Börja med Microsoft 365 Agents Toolkit i C#, JavaScript eller Python med Visual Studio eller Visual Studio Code
• Klona från ett sample och öppna i din IDE
• Använda CLI

Starta ditt projekt med verktygslådan

Om du börjar med Agents Toolkit har du allt klart för att testa med Agents Playground direkt. Du kan testa i Agents Playground antingen lokalt eller i Microsoft 365 Copilot eller Microsoft Teams. Detta scenario behandlas i:

• Visual Studio Code-genomgång
• Visual Studio-genomgång

Starta ditt projekt genom att klona ett exempel eller via CLI

Om du startar ditt projekt med hjälp av CLI eller klonar ett exempel och öppnar det i din IDE, kan du använda Agents Playground lokalt för att testa. Agents Playground ansluter till din lokala kod.

Du kan installera testplats för agenter med hjälp av något av följande metoder:

Alternativ 1: Installera den fristående binären

winget install agentsplayground

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

Alternativ 2: Installera med npm

• Installera Node.js (om det inte redan är installerat): Ladda ner och installera den senaste versionen av Node.js från nodejs.org.

• Installera Agents Playground-paketet:

  För global installation (rekommenderas):

  npm install -g @microsoft/m365agentsplayground
  

  För projektspecifik installation:

  npm install -D @microsoft/m365agentsplayground
  

Testa din agent

1. När du har skapat din snabbstartagent eller klonat en exempelkod från kodförrådet kan du använda den med Agents Playground.

2. Testplatsen för agenter stödjer både anonyma och autentiserade lägen. För anonym testning behövs ingen ytterligare konfiguration. Om du vill testa med autentisering behöver du konfigurera Microsoft Entra ID-appregistreringar för både Agents Playground (alternativ beskrivs i texten som följer) och din applikation. Mer information finns i Etablera en Azure-robot som ska användas med Agents SDK.

3. Konfigurera dina portar korrekt i din app. Välj en tillgänglig port för din agent (standard är 3978, men du kan använda valfri tillgänglig port).

4. Kör koden.

5. Öppna Testplats för agenter och börja med din agents slutpunkt:

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

   Konfigurera autentisering om din agent kräver det:

   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"
   

   Viktiga alternativ:

   • -e, --app-endpoint: Din agents endpoint-URL (till exempel, http://localhost:3978/api/messages)
   • -c, --channel-id: Kanaltyp (till exempel, emulator, webchat, msteams). Varje kanal erbjuder olika användarupplevelser och aktivitetsegenskaper.
   • --client-id: Klient-ID för autentisering
   • --client-secret: Klienthemlighet för autentisering
   • --tenant-id: Klientorganisations-ID för autentisering

   Använd agentsplayground --help för att se den fullständiga listan över tillgängliga alternativ.

   Alternativt kan du använda miljövariabler istället för CLI-alternativ. Om båda anges har CLI-alternativet högre prioritet.

   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"
   

   När agenten har startats bör den öppnas enligt följande bild. Du kan ställa frågor och testa din agent i Playground-gränssnittet.

   

Om möjligt rekommenderar vi att du börjar med Microsoft 365 Agents Toolkit. Toolkit gör det enklare och snabbare att komma igång, testa lokalt och distribuera. Det abstraherar mycket av den manuella installationen av Azure Bot Service och Azure App Registrations så att du slipper. Om du börjar manuellt måste du utföra dessa steg själv.

Översikt

Du testade ditt SDK för Microsoft 365-agenter lokalt med hjälp av Microsoft 365 Agents Playground, genom att utgå från ett klonat exempel från GitHub-repot eller från CLI:n.