Test agenten lokalt i Microsoft 365 Agents Playground

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

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

  • Start med Microsoft 365 Agents Toolkit i C#, JavaScript eller Python ved hjelp av Visual Studio eller Visual Studio Code
  • Klone fra et eksempel og åpne i IDE
  • Bruk CLI

Start prosjektet med verktøysettet

Hvis du starter med Agents Toolkit, har du alt satt opp for å teste ved å bruke Agents Playground med en gang. Du kan teste i Agents Playground enten lokalt, eller i Microsoft Copilot eller Microsoft Teams. Dette scenarioet dekkes av:

Start prosjektet ved å klone eller med CLI

Hvis du starter prosjektet ditt ved å bruke CLI eller klone et eksempel og åpne det i IDE-en din, kan du bruke den lokale Agents Playground for å teste. Agentens Playground kobler til din lokale kode.

Du kan installere Agents Playground ved å bruke en av følgende metoder:

Alternativ 1: Installere den frittstående binærfilen

winget install agentsplayground

Alternativ 2: Installere ved hjelp av npm

  • Installer Node.js (hvis ikke allerede installert): Last ned og installer den nyeste Node.js fra nodejs.org.

  • Installer Agents Playground-pakken:

    For global installasjon (anbefales):

    npm install -g @microsoft/m365agentsplayground

    For prosjektspesifikk installasjon:

    npm install -D @microsoft/m365agentsplayground

Test agenten

  1. Etter at du har opprettet din quickstart-agent eller klonet et sample fra repoet, bruk det med Agents Playground.

  2. Agents Playground støtter både anonyme og godkjente moduser. Ingen annen konfigurasjon kreves for anonym testing. Hvis du vil teste med godkjenning, må du konfigurere Microsoft Entra ID-appregistreringer for både Agents Playground (alternativene er angitt i teksten som følger) og programmet. 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. Velg en tilgjengelig port for agenten din (standard er 3978, men du kan bruke hvilken som helst tilgjengelig port).

  4. Kjør koden din.

  5. Åpne Agents Playground og start med agentens endepunkt:

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

    Konfigurer godkjenning hvis det kreves 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"

    Viktige alternativer:

    • -e, --app-endpoint: Url-adressen til agentens endepunkt (for eksempel http://localhost:3978/api/messages)
    • -c, --channel-id: Kanaltype (for eksempel , emulator, webchatmsteams). Hver kanal gir ulike brukeropplevelser og aktivitetsegenskaper.
    • --client-id: Klient-ID for godkjenning
    • --client-secret: Klienthemmelighet for godkjenning
    • --tenant-id: Leier-ID for godkjenning

    Bruk agentsplayground --help denne til å se den fullstendige listen over tilgjengelige alternativer.

    Alternativt kan du bruke miljøvariabler i stedet for CLI-alternativer. Hvis begge er angitt, 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 din starter, åpner den som vist på bildet nedenfor. Du kan stille spørsmål og teste agenten din i grensesnittet på lekeplassen.

    Microsoft 365 Agents Lekeplass

Der det er mulig, start med Microsoft 365 Agents Toolkit. Verktøysettet gjør det enklere og raskere å komme i gang, teste lokalt og distribuere. Det abstraherer mye av den manuelle oppsettet av Azure Bot Service og Azure App registrations slik at du slipper det. Når du starter manuelt, må du utføre disse manuelle trinnene selv.

Sammendrag

Du testet SDK for Microsoft 365-agenter lokalt ved å bruke Microsoft 365 Agents Playground. Du startet med et klonet sample fra GitHub-repoet eller fra CLI-en.

  • Sist oppdatert