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 Toolkitistä, olet määrittänyt kaiken, jotta voit testata agenttien playgroundin käyttöä heti. Voit testata Agentteja Playgroundissa joko paikallisesti tai Microsoft 365 Copilotissa tai Microsoft Teamsissa. Tätä skenaariota käsitellään seuraavissa osissa:

• Visual Studio Coden vaiheittaiset ohjeet
• Visual Studion vaiheittaiset ohjeet

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

Jos aloitat projektisi komentorivikäyttöliittymän avulla tai kloonaat näytteen ja avaat sen integroidyssa kehitysympäristössäsi, voit testata sitä paikallisten agenttien Playgroundin avulla. Agents Playground muodostaa yhteyden paikalliseen koodiisi.

Voit asentaa Agents Playgroundin jollakin seuraavista menetelmistä:

Vaihtoehto 1: Asenna erillinen binaari

winget install agentsplayground

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

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 pika-aloitusagentin tai kloonannut näytteen säilöstä, voit käyttää sitä Agents Playgroundin 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 agentille käytettävissä oleva portti (oletusarvo on 3978, mutta voit käyttää mitä tahansa käytettävissä 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 on käynnistetty, sen pitäisi avautua seuraavassa kuvassa esitetyllä tavalla. Voit esittää kysymyksiä ja testata agenttiasi leikkikentän rajapinnassa.

   

Suosittelemme, että aloitat Microsoft 365 -agenttien Työkalupakista aina kun mahdollista. Työkalupaketin avulla aloittaminen, testaus paikallisesti ja käyttöönotto on helpompaa ja nopeampaa. Se abstakti paljon Azure Bot Servicen ja Azure-sovellusrekisteröintien manuaalisen määrityksen, joten sinun ei tarvitse tehdä sitä itse. Aloita manuaalisesti suorittamalla nämä manuaaliset vaiheet itse.

Summary

Testasit Microsoft 365 -agenttien SDK:ta paikallisesti Microsoft 365 Agent Playgroundin avulla alkaen GitHub-säilöstä tai komentorivikäyttöliittymästä peräisin olevasta kloonatusta näytteestä.