Agentin testaaminen paikallisesti Microsoft 365:n agenttien testausalustalla

Agentin paikallisen testauksen yksityiskohdat riippuvat siitä, miten loit agenttisi.

Microsoft 365 -agenttien SDK:n avulla voit luoda agentin kolmella eri tavalla:

• Aloita projekti Microsoft 365 Agents Toolkitilla C#-, JavaScript- tai Python-kielellä käyttäen Visual Studiota tai Visual Studio Codea
• Kloonaa esimerkkiprojekti ja avaa se IDE:ssäsi
• CLI:n käyttäminen

Aloita projektisi toolkitilla

Jos aloitat Agents Toolkitilla, sinulla on kaikki valmiina testaukseen agenttien testausalustassa heti. Voit testata agenttien testausalustassa joko paikallisesti, Microsoft 365 Copilotissa tai Microsoft Teamsissa. Tämä skenaario on käsitelty kohdassa:

• Visual Studio Code -esittely
• Visual Studio -esittely

Aloita projektisi kloonaamisella tai komentorivillä

Jos aloitat projektisi CLI:llä tai kloonaat näytteen ja avaat sen IDE:ssä, voit testata paikallista agenttien testausalustaa. Agenttien testausalusta muodostaa yhteyden paikalliseen koodiisi.

Voit asentaa agenttien testausalustan jollakin seuraavista vaihtoehdoista:

Vaihtoehto 1: Asenna itsenäinen binaarinen

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 uusin Node.js versio osoitteesta nodejs.org.

• Asenna agenttien testausalustapaketti:

  Globaali asennus (suositeltava):

  npm install -g @microsoft/m365agentsplayground
  

  Projektikohtainen asennus:

  npm install -D @microsoft/m365agentsplayground
  

Agentin testaaminen

1. Kun olet luonut pikakäynnistysagentin tai kloonannut esimerkin säilöstä, voit käyttää sitä agenttien testausalustassa.

2. Agenttien testausalusta tukee sekä anonyymiä että todennettua käyttötilaa. Anonyymia testausta varten ei tarvita muita asetuksia. Jos haluat testata todennetussa tilassa, sinun täytyy määrittää Microsoft Entra ID -sovellusrekisteröinnit sekä agenttien testausalustalle (vaihtoehdot löytyvät seuraavasta tekstistä) että sovelluksellesi. Lisätietoja on kohdassa Azure Botin valmisteleminen Agents SDK:ta varten.

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

4. Suorita koodi.

5. Avaa agenttien testausalusta ja aloita agenttisi päätepisteellä:

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

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

   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"
   

   Keskeiset vaihtoehdot:

   • -e, --app-endpoint: Agenttisi päätepisteen URL-osoite (esimerkiksi http://localhost:3978/api/messages)
   • -c, --channel-id: Kanavatyyppi (esim. emulator, webchat, msteams). Jokainen kanava tarjoaa erilaisen käyttäjäkokemuksen ja aktiviteettiominaisuudet.
   • --client-id: Asiakastunnus todennukseen
   • --client-secret: Asiakassalaisuus autentikointia varten
   • --tenant-id: Vuokraajatunnus todennukseen

   Käytä agentsplayground --help nähdäksesi kaikki saatavilla olevat vaihtoehdot.

   Vaihtoehtoisesti voit käyttää ympäristömuuttujia CLI-vaihtoehtojen sijaan. Jos molemmat on määritelty, CLI-vaihtoehdolla on korkeampi 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 agentti on käynnistetty, sen pitäisi avautua, kuten seuraavassa kuvassa näkyy. Voit esittää kysymyksiä ja testata agenttiasi testausalustan käyttöliittymässä.

   

Aina kun mahdollista, suosittelemme aloittamaan Microsoft 365 Agents Toolkitilla. Työkalupakki tekee aloittamisesta, paikallisesta testauksesta ja käyttöönotosta helpompaa ja nopeampaa. Se hoitaa suuren osan Azure Bot Service -palvelun ja Azure App Registration -rekisteröintien manuaalisesta asennuksesta, joten sinun ei tarvitse tehdä sitä itse. Jos aloitat manuaalisesti, sinun täytyy suorittaa nämä manuaaliset vaiheet itse.

Yhteenveto

Testasit Microsoft 365 -agenttien SDK:ta paikallisesti Microsoft 365 agenttien testausalustan avulla, aloittaen kloonatusta esimerkistä GitHub-reposta tai CLI:stä.