Testa din agent lokalt i Microsoft 365 Agents Playground

Information om hur du testar din agent lokalt beror på hur du skapade din agent.

Du kan skapa en agent med Microsoft 365 Agents SDK på tre sätt:

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

Starta projektet med verktygslådan

Om du börjar med Agents Toolkit har du allt konfigurerat för att testa med Agents Playground direkt. Du kan testa i Agents Playground antingen lokalt eller i Microsoft 365 Copilot eller Microsoft Teams. Det här scenariot beskrivs i:

• Genomgång av Visual Studio Code
• Genomgång av Visual Studio

Starta projektet genom att klona eller med CLI

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

Du kan installera Agents Playground med någon av följande metoder:

Alternativ 1: Installera den fristående binärfilen

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 inte redan installerat): Ladda ned och installera den senaste 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 snabbstartsagenten eller klonar ett exempel från lagringsplatsen kan du använda den med Agents Playground.

2. Agents Playground stöder både anonyma och autentiserade lägen. För anonym testning krävs ingen annan konfiguration. Om du vill testa med autentisering måste du konfigurera Microsoft Entra ID-appregistreringar för både Agents Playground (alternativ finns i texten nedan) och ditt program. 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 (standardvärdet ä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 det krävs av din 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"
   

   Viktiga alternativ:

   • -e, --app-endpoint: Agentens slutpunkts-URL (till exempel http://localhost:3978/api/messages)
   • -c, --channel-id: Kanaltyp (till exempel emulator, webchat, msteams). Varje kanal ger olika egenskaper för användarupplevelse och aktivitet.
   • --client-id: Klient-ID för autentisering
   • --client-secret: Klienthemlighet för autentisering
   • --tenant-id: Tenant-ID för autentisering

   Använd agentsplayground --help om du vill se en fullständig lista över tillgängliga alternativ.

   Du kan också använda miljövariabler i stä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.

   

När det är möjligt rekommenderar vi att du börjar med Microsoft 365 Agents Toolkit. Verktygslådan gör det enklare och snabbare att komma igång, testa lokalt och distribuera. Den sammanfattar mycket den manuella installationen av Azure Bot Service och Azure App Registrations så att du inte behöver göra det. Genom att starta manuellt måste du utföra de här manuella stegen själv.

Sammanfattning

Du har testat ditt Microsoft 365 Agents SDK lokalt med hjälp av Microsoft 365 Agents Playground, och inledde med ett klonat exempel från GitHub-repositoryt eller från CLI.