Test agenten lokalt på lekeplassen for Microsoft 365-agenter

Detaljene for hvordan du tester agenten lokalt, avhenger av hvordan du har opprettet den.

Du kan opprette en agent ved å bruke SDK for Microsoft 365-agenter på tre måter:

• Start med Microsoft 365-agentverktøysettet med C#, JavaScript eller Python ved å bruke Visual Studio eller Visual Studio Code
• Klon fra et eksempelprosjekt og åpne i IDE
• Bruk CLI

Start prosjektet med verktøysettet

Hvis du starter med agentverktøysettet, har du alt klart til å teste i Lekeplass for agenter umiddelbart. Du kan teste i Lekeplass for agenter enten lokalt, eller i Microsoft 365 Copilot eller Microsoft Teams. Dette scenarioet er dekket i:

• Visual Studio Code-gjennomgang
• Visual Studio-gjennomgang

Start prosjektet ditt ved å klone eller bruke CLI

Hvis du starter prosjektet ditt med CLI eller kloner et eksempel og åpner det i IDE, kan du bruke den lokale lekeplassen for agenter til testing. Lekeplass for agenter kobles til din lokale kode.

Du kan installere Lekeplass for agenter ved å bruke en av følgende metoder:

Alternativ 1: Installer den frittstå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: Installer med npm

• Installer Node.js (hvis det ikke allerede er installert): Last ned og installer siste versjon av Node.js fra nodejs.org.

• Installer Lekeplass for agenter-pakken:

  For global installasjon (anbefalt):

  npm install -g @microsoft/m365agentsplayground
  

  For prosjektspesifikk installasjon:

  npm install -D @microsoft/m365agentsplayground
  

Test agenten

1. Når du har opprettet en hurtigstartagent eller klonet et eksempel fra repositoriet, kan du bruke den med Lekeplass for agenter.

2. Lekeplass for agenter støtter både anonyme og autentiserte moduser. For anonymtesting kreves ingen konfigurasjon. Hvis du vil teste med autentisering, må du konfigurere Microsoft Entra ID-appregistreringer for både Lekeplass for agenter (alternativer er oppgitt i teksten nedenfor) og appen. Hvis du vil ha informasjon, kan du se Klargjør en Azure-robot som skal brukes med SDK for agenter.

3. Konfigurer portene riktig i appen din. Velg en tilgjengelig port for agenten (standard er 3978, men du kan bruke hvilken som helst tilgjengelig port).

4. Kjør koden din.

5. Åpne Lekeplass for agenter og start med agentens endepunkt:

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

   Konfigurer autentisering hvis det kreves av agenten din:

   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"
   

   Viktige alternativer:

   • -e, --app-endpoint: Agentens endepunktnettadresse (f.eks. http://localhost:3978/api/messages)
   • -c, --channel-id: Kanaltype (f.eks. emulator, webchat, msteams). Hver kanal tilbyr ulike brukeropplevelser og aktivitetsegenskaper.
   • --client-id: Klient-ID for autentisering
   • --client-secret: Klienthemmelighet for autentisering
   • --tenant-id: Leier-ID for godkjenning

   Bruk agentsplayground --help for å se hele listen over tilgjengelige alternativer.

   Alternativt kan du bruke miljøvariabler i stedet for CLI-alternativer. Hvis begge er spesifisert, har CLI-alternativet høyere 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 er startet, skal den åpnes som vist på følgende bilde. Du kan stille spørsmål og teste agenten i lekeplassgrensesnittet.

   

Der det er mulig, anbefaler vi at du starter med verktøysettet for Microsoft 365-agenter. Verktøysettet gjør det enklere og raskere å komme i gang, teste lokalt og rulle ut. Det automatiserer mye av det manuelle oppsettet av Azure Bot Service og Azure-appregistreringer slik at du slipper å gjøre det selv. Ved å starte manuelt må du utføre disse manuelle trinnene selv.

Sammendrag

Du testet SDK for Microsoft 365-agenter lokalt ved å bruke Lekeplass for Microsoft 365-agenter og startet med en klonet eksempelkode fra GitHub-repositoriet eller fra CLI.