Testaa agenttiasi paikallisesti Microsoft 365 -agenttien Playgroundissa

Tiedot agentin paikallisesta testaamisesta riippuvat siitä, miten agentti on luotu.

Voit luoda agentin käyttämällä Microsoft 365 -agenttien SDK:ta kolmella tavalla:

  • Aloita Microsoft 365 Agent -työkalupakista C#:ssä, JavaScriptissä tai Pythonissa Visual Studion tai Visual Studio Coden avulla
  • Kloonaa mallista ja avaa se IDE:ssä
  • Komentorivikäyttöliittymän käyttäminen

Aloita projektisi työkalupakilla

Jos aloitat Agents Toolkitillä, sinulla on kaikki valmiina testattavaksi käyttämällä Agents Playgroundia heti. Voit testata Agents Playgroundissa joko paikallisesti tai Microsoft Copilot- tai Microsoft Teams-versioissa. Tätä skenaariota käsitellään seuraavissa osissa:

Aloita projekti kloonaamalla tai komentorivikäyttöliittymän avulla

Jos aloitat projektisi käyttämällä komentokomentoa tai kloonaat näytteen ja avaat sen IDE:ssä, voit testata paikallista Agents Playgroundia. Agents Playground muodostaa yhteyden paikalliseen koodiisi.

Voit asentaa Agents Playgroundin käyttämällä seuraavia menetelmiä:

Vaihtoehto 1: Asenna erillinen binaari

winget install agentsplayground

Vaihtoehto 2: Asenna npm:n avulla

  • Asenna Node.js (jos sitä ei ole vielä asennettu): Lataa ja asenna uusimmat Node.js nodejs.org.

  • Asenna Agents Playground -paketti:

    Yleiselle asennukselle (suositus):

    npm install -g @microsoft/m365agentsplayground

    Projektikohtainen asennus:

    npm install -D @microsoft/m365agentsplayground

Agentin testaaminen

  1. Kun olet luonut pikakäynnistysagentin tai kloonannut näytteen reposita, käytä sitä Agenttien leikkikentän kanssa.

  2. Agents Playground tukee sekä anonyymiä että todennettua tilaa. Anonyymiä testausta varten ei tarvita muita määrityksiä. Jos haluat testata todentamista, sinun on määritettävä Microsoft Entra ID -sovelluksen rekisteröinnit sekä Agents Playgroundille (vaihtoehdot on annettu seuraavassa tekstissä) että sovelluksellesi. Lisätietoja on artikkelissa Azure-botin valmisteleminen käytettäväksi agenttien SDK:n kanssa.

  3. Määritä portit oikein sovelluksessasi. Valitse agentillesi saatavilla oleva portti (oletus on 3978, mutta voit käyttää mitä tahansa saatavilla olevaa porttia).

  4. Suorita koodisi.

  5. Avaa Agenttien leikkikenttä ja aloita agenttisi päätepisteestä:

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

    Määritä todentaminen, jos agenttisi tarvitsee sitä:

    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"

    Avainvaihtoehdot:

    • -e, --app-endpoint: Agenttisi päätepisteen URL-osoite (esimerkiksi http://localhost:3978/api/messages)
    • -c, --channel-id: Kanavan tyyppi (esimerkiksi , emulatorwebchat, msteams). Kukin kanava tarjoaa erilaisia käyttökokemus- ja toiminto-ominaisuuksia.
    • --client-id: Asiakastunnus todentamista varten
    • --client-secret: Todentamisen asiakassalaisuus
    • --tenant-id: Vuokraajatunnus todentamista varten

    agentsplayground --help Toiminnolla näet luettelon kaikista käytettävissä olevista vaihtoehdoista.

    Vaihtoehtoisesti voit käyttää ympäristömuuttujia CLI-asetusten sijaan. Jos molemmat on määritetty, CLI-asetuksella on suurempi prioriteetti.

    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"

    Kun agenttisi aloittaa, se avautuu kuten seuraavassa kuvassa näkyy. Voit esittää kysymyksiä ja testata agenttiasi leikkikentän rajapinnassa.

    Microsoft 365 Agents Playground

Aina kun mahdollista, aloita Microsoft 365 Agents Toolkitista. Työkalupaketin avulla aloittaminen, testaus paikallisesti ja käyttöönotto on helpompaa ja nopeampaa. Se abstraktoi suuren osan Azure Bot Service ja Azure App registrations manuaalisesta asennuksesta, joten sinun ei tarvitse. Aloita manuaalisesti suorittamalla nämä manuaaliset vaiheet itse.

Yhteenveto

Testasit Microsoft 365 -agenttien SDK:ta paikallisesti käyttämällä Microsoft 365 Agents Playgroundia. Aloitit kloonatulla näytteellä GitHub-repositosta tai CLI:stä.

  • Viimeksi päivitetty