Test agenter med Dev Tunnels

Ved å bruke Dev Tunnels kan du teste Agent 365-agenten din med Microsoft 365-applikasjoner (som Teams, Outlook eller Word) mens agenten kjører lokalt på din utviklingsmaskin. Denne tilnærmingen knytter sammen lokal utvikling og testing i faktiske Microsoft 365-miljøer, slik at du kan validere agentens oppførsel før du distribuerer til skyen.

Forutsetning

Før du bruker Dev Tunnels, sørg for å installere Dev Tunnels kommandolinjeverktøy.

Sett opp Dev Tunnel

Konfigurer en Dev Tunnel for å eksponere ditt lokale agent-endepunkt til Microsoft 365-tjenester.

Opprett og start en tunnel

  1. Logg inn på Dev Tunnel:

    devtunnel user login

  2. Opprett en vedvarende tunnel:

    devtunnel create --allow-anonymous

    Denne kommandoen returnerer en tunnel-ID. Lagre denne identifikatoren for fremtidig bruk.

  3. Konfigurer tunnelporten:

    Angi porten agent-serveren din bruker (vanligvis 3978):

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

  4. Start tunnelen:

    devtunnel host <tunnel-id>

    Kommandoen viser tunnel-nettadressen din (f.eks. https://abc123xyz.devtunnels.ms:3978). Kopier denne nettadressen for bruk i neste trinn.

Tips

Bruk devtunnel list til å vise alle tunnelene dine og devtunnel delete <tunnel-id> til å fjerne tunneler du ikke lenger trenger.

Konfigurer agentmeldingsendepunkt

Registrer din Dev Tunnel-nettadresse (f.eks., https://abc123xyz.devtunnels.ms:3978/api/messages) som agentens meldingsendepunkt, slik at Microsoft 365 vet hvor meldingene skal rutes. Ikke glem /api/messages suffikset til endepunktet.

Se Sett agent messaging endpoint

Test med Microsoft 365

Når Dev Tunnel er aktiv og endepunktet er registrert, kan du teste agenten din i Microsoft 365-applikasjoner.

Test i Microsoft Teams

  1. Start din lokale agent ved å bruke instruksjonene i Installasjonsavhengigheter og start agentapplikasjonsserveren.

  2. Verifiser tunnelforbindelsen:

    devtunnel list

    Sjekk at tunnelen din viser aktive vertstilkoblinger. Kolonnen "Vertforbindelser" skal vise et tall større enn 0.

  3. Samhandle med agenten din i Teams:

    • Åpne Microsoft Teams (webversjon eller skrivebordsapp)
    • I Teams-søkefeltet, søk etter agenten din med navn eller e-postadresse
    • Start en samtale med agenten
    • Send en melding og observer svaret
    • Sjekk din lokale konsoll for innkommende forespørsler og agentaktivitet

Test e-postvarslinger

Hvis agenten din er konfigurert for e-postvarsler:

  1. Send en e-post til agentens e-postadresse
  2. CC agenten din i en e-posttråd
  3. Overvåk din lokale konsoll for varslingswebhook
  4. Verifiser at agenten din behandler og svarer på e-posten

Test Word-integreringen

For agenter som svarer på Word-kommentarer:

  1. Åpne et Word-dokument som agenten din har tilgang til.
  2. Legg til en kommentar hvor du nevner agenten din.
  3. Sjekk din lokale konsoll for varslingen.
  4. Verifiser at agentens svar vises i Word.

Overvåk tunnelaktiviteten

Dev Tunnels tilbyr trafikkinspeksjon for å hjelpe med feilsøking av tilkoblingsproblemer og forstå forespørselsflyt:

devtunnel show <tunnel-id>

Denne kommandoen viser:

  • Aktive forbindelser og detaljer om økter
  • Forespørsels- og svarinformasjon
  • Trafikkvolumstatistikk
  • Tilkoblingsfeil og advarsler.

Du kan også overvåke tunnelaktivitet i sanntid ved å følge med på utdataene fra devtunnel hostkommandoen.

Vedlikehold av tunnelforbindelser

Dev Tunnels krever at prosessen devtunnel host fortsetter å kjøre. Hvis inaktivitet, nettverksproblemer eller at datamaskinen går i dvale fører til at tunneltilkoblingen brytes, må du starte tunnelen på nytt.

Sjekk tunnelstatus

Kontroller at tunnelen din er aktiv:

devtunnel list

Utdata viser:

  • Tunnel-ID: Din tunnelidentifikator
  • Vertsforbindelser: Antall aktive tilkoblinger (bør være én eller flere når devtunnel host kjører)
  • Porter: Konfigurerte porter
  • Utløp: Tunnelens utløpstid

Hvis Host Connections viser 0, eksisterer tunnelen, men er ikke vert for øyeblikket.

Start en frakoblet tunnel på nytt

Hvis du mister tunnelforbindelsen, start den på nytt ved å bruke samme tunnel-ID:

devtunnel host <tunnel-id>

Tunnelens nettadresse forblir den samme, så du trenger ikke å oppdatere konfigurasjonen av agentmeldingsendepunktet ditt.

Sørg for at tunnelene er aktive under utvikling

For å opprettholde stabile forbindelser:

  • Hold terminalvinduet åpent – Ikke lukk terminalen som kjørerdevtunnel host.
  • Hindre hvilemodus - Konfigurer systemet ditt til å holde seg våkent under testing.
  • Se etter tilkoblingsfeil - Overvåk devtunnel hostterminalutdataene for frakoblingsmeldinger.
  • Start på nytt etter nettverksendringer – Hvis du bytter nettverk eller kobler til VPN igjen, start tunnelen på nytt.

Tips

Hvis tunnelen din ofte kobler seg fra, sjekk nettverksinnstillingene og brannmurreglene for å sikre at de ikke blokkerer tilkoblingen.

Rydd

Når du er ferdig med testing med Dev Tunnels:

Stopp tunnelen

Trykk Ctrl+C i terminalen som kjører devtunnel host for å stoppe tunnelen.

Denne kommandoen fjerner Dev Tunnel-nettadressen fra agentens meldingsendepunkt. Når du distribuerer til produksjon, angi nettadressen til det skybaserte endepunktet.

Notat

Tunnelen forblir tilgjengelig for fremtidig bruk inntil du eksplisitt sletter den ved å bruke devtunnel delete <tunnel-id>.

Begrensninger

Ta hensyn til disse begrensningene når du tester med Dev Tunnels:

  • Kun utvikling: Bruk Dev Tunnels til utvikling og testing, ikke til produksjon.
  • Ytelse: Forvent høyere latens sammenlignet med skyhostede agenter på grunn av nettverksruting.
  • Tilkoblingsstabilitet: Tunnelforbindelser kan av og til falle ut og kreve manuell omstart.
  • Sikkerhetshensyn: Flagget --allow-anonymous er praktisk for testing, men bør ikke brukes med sensitive data.
  • Økthåndtering: Du må kanskje logge inn på nytt periodisk, avhengig av varigheten på økten.

Neste trinn

Etter vellykket Dev Tunnel-testing:

Feilsøking

Hvis du får problemer under testing med Dev Tunnels, start her for løsninger på vanlige tunnel-, tilkoblings- og endepunktproblemer. For bredere Agent 365-feilsøking (oppsett, autentisering og meldinger), se Feilsøking.

Tunnelforbindelsen svikter

Symptomer: Dev Tunnel starter ikke eller kobler seg umiddelbart fra.

Løsninger:

  • Verifiser at du er logget inn: devtunnel user login
  • Sjekk om en annen prosess bruker samme port
  • Sørg for at brannmuren din tillater Dev Tunnel-tilkoblinger
  • Slett og lag tunnelen på nytt: devtunnel delete <tunnel-id> så lag en ny

Meldinger når ikke frem til lokal agent

Symptomer: Microsoft 365 indikerer at meldingen ble sendt, men din lokale agent mottar den ikke.

Løsninger:

  • Bekreft at agenten din kjører lokalt
  • Verifiser at tunnelen er aktiv: devtunnel list skal vise "Connected"
  • Sjekk endepunktkonfigurasjonen i a365.config.json og verifiser at Dev Tunnel-nettadressen er satt som meldingsendepunkt
  • Gå gjennom Dev Tunnel-loggene i terminalen som kjører devtunnel host for tilkoblingsfeil
  • Sørg for at din lokale port matcher tunnelporten (begge skal være 3978 som standard)

Autentiseringsfeil via Dev Tunnel

Symptomer: 401- eller 403-feil ved testing gjennom Dev Tunnel.

Løsninger:

  • Sjekk at agent-autentisering er konfigurert (bærertokenautentisering fungerer ikke med Dev Tunnels for Microsoft 365-integrasjon).
  • Sjekk agentens blueprint-legitimasjon i a365.generated.config.json.
  • Bekreft at agenten din har de nødvendige tillatelsene for operasjonene du tester.
  • Sørg for at autentiseringstokenene dine ikke har utløpt.

Tunnel-nettadresse endret eller utløpt

Symptomer: Tidligere fungerende tunnel-nettadresse ruter ikke lenger til agenten din.

Løsninger:

  • Sjekk tunnelstatus ved å bruke devtunnel list.
  • Start tunnelen på nytt ved å bruke devtunnel host <tunnel-id>.
  • Oppdater meldingsendepunktet hvis nettadressen har endret seg ved å bruke a365 setup blueprint --endpoint-only.
  • Last updated on