Agenttien testaaminen Dev Tunnelsin avulla

Dev Tunnelsin avulla voit testata Agent 365 -agenttia Microsoft 365 -sovellusten (kuten Teamsin, Outlookin tai Word) kanssa samalla, kun agentit suoritetaan paikallisesti kehityskoneella. Tämä menetelmä yhdistää paikallisen kehityksen ja reaalimaailman testauksen, joten voit varmistaa agentin toiminnan todellisissa Microsoft 365 -ympäristöissä ennen käyttöönottoa pilveen.

Edellytykset

Ennen kuin käytät Dev Tunnelsia, varmista, että asennat Dev Tunnelsin komentorivityökalun.

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: Lataa osoitteesta aka.ms/devtunnels/download

Dev Tunnelin määrittäminen

Määritä Dev Tunnel, jotta paikallinen agentin päätepiste on käytettävissä Microsoft 365 -palveluissa.

Tunnelin luominen ja käynnistäminen

1. Kirjaudu Dev Tunneliin:

   devtunnel user login
   

2. Luo pysyvä tunneli:

   devtunnel create --allow-anonymous
   

   Tämä komento palauttaa tunnelin tunnuksen. Tallenna tämä tunniste myöhempää käyttöä varten.

3. Määritä tunnelin portti:

   Määritä portti, jota agentin palvelin käyttää (yleensä 3978):

   devtunnel port create <tunnel-id> -p <port-number>
   

4. Käynnistä tunneli:

   devtunnel host <tunnel-id>
   

   Komento näyttää tunnelin URL-osoitteen (esimerkiksi https://abc123xyz.devtunnels.ms:3978). Kopioi tämä URL-osoite seuraavaan vaiheeseen.

Agentin viestinnän päätepisteen määrittäminen

Rekisteröi Dev Tunnelin URL-osoite (esimerkiksi https://abc123xyz.devtunnels.ms:3978/api/messages) agentin viestinnän päätepisteeksi, jotta Microsoft 365 tietää, minne viestit tulee reitittää. Älä unohda /api/messages-päätettä päätepisteelle.

Lisätietoja on kohdassa Agentin viestinnän päätepisteen määrittäminen

Testaaminen Microsoft 365:ssä

Kun Dev Tunnel on aktiivinen ja päätepiste rekisteröity, testaa agentti Microsoft 365 -sovelluksissa.

Testaaminen Microsoft Teamsissa

1. Käynnistä paikallinen agentti seuraamalla ohjeita kohdassa Riippuvuuksien asentaminen ja agentin sovelluspalvelimen käynnistäminen.

2. Varmista tunnelin yhteys:

   devtunnel list
   

   Tarkista, että tunnelissa näkyvät aktiiviset isäntäyhteydet. Isännän yhteydet -sarakkeessa tulee näkyä luku, joka on suurempi kuin 0.

3. Ole vuorovaikutuksessa agentin kanssa Teamsissa:

   • Avaa Microsoft Teams (selaimessa tai työpöytäsovelluksessa)
   • Hae Teamsin hakupalkissa agenttia nimellä tai sähköpostiosoitteella
   • Aloita keskustelu agentin kanssa
   • Lähetä viesti ja tarkkaile vastausta
   • Tarkista paikallisesta konsolista saapuvat pyynnöt ja agentin toiminta

Sähköposti-ilmoitusten testaaminen

Jos agentti on määritetty sähköposti-ilmoituksia varten:

1. Lähetä sähköpostiviesti agentin sähköpostiosoitteeseen
2. Lisää agentille sähköpostiviestin kopio sähköpostiketjussa
3. Seuraa paikallista konsolia webhook-ilmoitusta varten
4. Varmista, että agentti käsittelee sähköpostiviestin ja vastaa siihen

Word-integroinnin testaaminen

Jos agentti vastaa Wordin kommentteihin:

1. Avaa Word-dokumentti, jonka käyttöoikeus agentilla on.
2. Lisää kommentti, jossa agentti mainitaan.
3. Tarkista ilmoitus paikallisessa konsolissa.
4. Varmista, että agentin vastaus näkyy Wordissa.

Tunnelin toiminnan seuraaminen

Dev Tunnels mahdollistaa liikenteen tarkastelun yhteysongelmien selvittämiseksi ja pyyntöjen kulun ymmärtämiseksi seuraavasti:

devtunnel show <tunnel-id>

Tämä komento näyttää:

• Aktiiviset yhteydet ja istuntojen yksityiskohdat.
• Pyyntö- ja vastaustiedot.
• Liikennemäärien tilastot.
• Yhteysvirheet ja varoitukset.

Voit myös tarkkailla tunnelin toimintaa reaaliajassa seuraamalla devtunnel host-komennon antamaa tulosta.

Tunnelin yhteyksien ylläpitäminen

Dev Tunnels vaativat devtunnel host-prosessin, jotta ne pysyvät käynnissä. Jos passiivisuus, verkko-ongelmat tai tietokoneen siirtyminen lepotilaan aiheuttavat yhteyden katkeamisen, tunneli on käynnistettävä uudelleen.

Tunnelin tilan tarkistaminen

Varmista seuraavalla tavalla, onko tunneli aktiivinen:

devtunnel list

Tulos sisältää seuraavat tiedot:

• Tunnelin tunnus: Tunnelin tunniste
• Palvelinyhteydet: Aktiivisten yhteyksien määrä (vähintään yksi, kun devtunnel host on käynnissä)
• Portit: Määritetyt portit
• Vanheneminen: Tunnelin vanhenemisaika

Jos Isäntäyhteydet-arvo on 0, tunneli on olemassa, mutta sitä ei tällä hetkellä isännöidä.

Tunnelin katkenneen yhteyden käynnistäminen uudelleen

Jos tunnelin yhteys katkeaa, käynnistä se uudelleen käyttämällä samaa tunnelin tunnusta seuraavasti:

devtunnel host <tunnel-id>

Tunnelin URL-osoite pysyy samana, joten agentin viestinnän päätepisteen määritystä ei tarvitse päivittää.

Tunnelien pitäminen aktiivisina kehityksen aikana

Voit ylläpitää vakaita yhteyksiä seuraavasti:

• Pidä pääteikkuna auki – Älä sulje pääteikkunaa, jossa suoritettavana on devtunnel host.
• Estä tietokoneen lepotila – Määritä järjestelmä pysymään hereillä testauksen aikana.
• Seuraa yhteysvirheitä – Seuraa devtunnel host-terminaalin tulosta yhteyden katkaisemista koskevien viestien varalta.
• Käynnistä uudelleen verkon muutosten jälkeen – Jos vaihdat verkkoa tai yhdistät VPN:ään, käynnistä tunneli uudelleen.

Puhdista

Kun testaus Dev Tunnelsilla on päättynyt, tee seuraavaa:

Tunnelin pysäyttäminen

Pysäytä tunneli painamalla Ctrl+C terminaalissa, jossa devtunnel host on käynnissä.

Tämä komento poistaa Dev Tunnelin URL-osoitteen agentin viestinnän päätepisteestä. Kun se otetaan käyttöön tuotantoympäristössä, määritä pilvipalvelussa isännöidyn päätepisteen URL-osoite.

Rajoitukset

Ota nämä rajoitukset huomioon, kun testaat Dev Tunnelsia seuraavasti:

• Vain kehityskäyttöön: Käytä Dev Tunnelsia kehitykseen ja testaukseen, ei tuotantoon.
• Suorituskyky: Odota suurempaa viivettä verrattuna pilvi-isännöityihin agentteihin reitityksen vuoksi.
• Yhteyden vakaus: Tunneliyhteydet voivat toisinaan katketa ja vaatia manuaalisen uudelleenkäynnistyksen.
• Turvallisuusnäkökohdat: --allow-anonymous-merkintä on kätevä testaukseen, mutta älä käytä sitä arkaluonteisten tietojen kanssa.
• Istunnon hallinta: Saatat joutua kirjautumaan uudelleen säännöllisesti istunnon kestosta riippuen.

Seuraavat vaiheet

Onnistuneen Dev Tunnel testauksen jälkeen:

• Ota agentti käyttöön pilvessä: Ota käyttöön Azure-palvelussa, aseta agentin viestinnän päätepiste AWS-palvelussa tai aseta agentin viestinnän päätepiste GCP-palvelussa.
• Määritä agentin viestinnän päätepisteet: Agentin viestinnän päätepisteet.
• Seuraa koko kehityksen elinkaarta: Agent 365:n kehityksen elinkaari.

Vianmääritys

Jos kohtaat ongelmia Dev Tunneliin liittyvässä testauksessa, aloita täältä tunneli-, yhteys- ja päätepisteongelmien ratkaisemiseksi. Tietoja laajemmasta Agent 365 -vianmäärityksestä (asennus, todennus ja viestintä) on kohdassa Vianetsintä.

Tunnelin yhteys epäonnistuu

Oireet: Dev Tunnel ei käynnisty tai sen yhteys katkeaa välittömästi.

Ratkaisut:

• Varmista, että olet kirjautunut sisään: devtunnel user login
• Tarkista, käyttääkö jokin muu prosessi samaa porttia
• Varmista, että palomuuri sallii Dev Tunnel -yhteydet
• Poista tunneli ja luo se uudelleen devtunnel delete <tunnel-id> -komennolla ja luo sitten uusi

Viestit eivät tavoita paikallista agenttia

Oireet: Microsoft 365 osoittaa, että viesti on lähetetty, mutta paikallinen agenttisi ei vastaanota sitä.

Ratkaisut:

• Varmista, että agentti on käynnissä paikallisesti
• Varmista, että tunneli on aktiivinen: devtunnel list näyttää Yhdistetty-tilan
• Tarkista päätepisteen määritys kohdassa a365.config.json ja varmista, että Dev Tunnelin URL-osoite on määritetty viestinnän päätepisteeksi
• Tarkista yhteysvirheiden varalta Dev Tunnel -lokit terminaalissa, jossa devtunnel host on käynnissä
• Varmista, että paikallinen portti on sama kuin tunneliportti (molempien on oletusarvoisesti oltava 3978)

Todennusvirheet Dev Tunnelissa

Oireet: 401- tai 403-virheitä testattaessa Dev Tunnelin kautta.

Ratkaisut:

• Varmista, että agentin toennus on määritetty (haltijatunnuksen todennus ei toimi Dev Tunnelsissa Microsoft 365 -integroinnissa).
• Tarkista agentin suunnitelman tunnistetiedot kohdassa a365.generated.config.json.
• Varmista, että agentilla on tarvittavat oikeudet testaamiisi toimintoihin.
• Varmista, että todennuksen tunnukset eivät ole vanhentuneet.

Tunnelin URL-osoite on muuttunut tai vanhentunut

Oireet: Aiemmin toimiva tunnelin URL-osoite ei enää reititä agentille.

Ratkaisut:

• Tarkista tunnelin tila käyttämällä devtunnel list-komentoa.
• Käynnistä tunneli uudelleen käyttämällä devtunnel host <tunnel-id>-komentoa.
• Päivitä viestinnän päätepiste, jos URL-osoite on muuttunut, käyttämällä a365 setup blueprint --endpoint-only-komentoa.