Agenten testen met Dev Tunnels

Met Dev Tunnels kunt u uw Agent 365-agent testen met Microsoft 365-toepassingen (zoals Teams, Outlook of Word) terwijl uw agent lokaal draait op uw ontwikkelmachine. Deze aanpak vormt de brug tussen lokale ontwikkeling en tests in de praktijk, zodat u het gedrag van de agent kunt valideren in echte Microsoft 365-omgevingen voordat u ze in de cloud implementeert.

Vereisten

Zorg ervoor dat u voordat u Dev Tunnels gebruikt de Dev Tunnels-opdrachtregeltool installeert.

Dev Tunnel instellen

Configureer een dev-tunnel om uw lokale agent-eindpunt beschikbaar te maken voor Microsoft 365-services.

Een tunnel maken en starten

  1. Meld u aan bij Dev Tunnel:

    devtunnel user login

  2. Maak een persistente tunnel aan:

    devtunnel create --allow-anonymous

    Deze opdracht retourneert een tunnel-id. Bewaar deze id voor toekomstig gebruik.

  3. Configureer de tunnelpoort:

    Wijs de poort toe die uw agent-server gebruikt (meestal 3978):

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

  4. Start de tunnel:

    devtunnel host <tunnel-id>

    De opdracht geeft uw tunnel-URL weer (bijvoorbeeld https://abc123xyz.devtunnels.ms:3978). Kopieer deze URL voor de volgende stap.

Fooi

Gebruik devtunnel list om al uw tunnels te bekijken en devtunnel delete <tunnel-id> om tunnels te verwijderen die u niet meer nodig hebt.

Het berichten-eindpunt van de agent configureren

Registreer uw dev-tunnel-URL (bijvoorbeeld https://abc123xyz.devtunnels.ms:3978/api/messages) als het berichten-eindpunt van de agent, zodat Microsoft 365 weet waar de berichten naartoe moeten worden gestuurd. Vergeet niet het achtervoegsel /api/messages aan het eindpunt toe te voegen.

Raadpleeg Het berichten-eindpunt van de agent instellen

Testen met Microsoft 365

Test uw agent in Microsoft 365-toepassingen wanneer uw dev-tunnel actief is en het eindpunt geregistreerd is.

Testen in Microsoft Teams

  1. Start uw lokale agent volgens de instructies in Afhankelijkheden installeren en de agenttoepassingsserver starten.

  2. Controleer de tunnelverbinding:

    devtunnel list

    Controleer of uw tunnel actieve hostverbindingen toont. De kolom "Hostverbindingen" moet een getal groter dan 0 tonen.

  3. Communiceer met uw agent in Teams:

    • Open Microsoft Teams (webversie of bureaublad-app)
    • Zoek uw agent door in de zoekbalk van Teams de naam of het e-mailadres ervan op te geven
    • Start een gesprek met de agent
    • Stuur een bericht en bekijk de respons
    • Controleer uw lokale console op binnenkomende aanvragen en agentactiviteit

E-mailmeldingen testen

Als uw agent is geconfigureerd voor e-mailmeldingen:

  1. Stuur een e-mail naar het e-mailadres van uw agent
  2. CC uw agent in een e-mailthread
  3. Controleer uw lokale console op de webhook voor meldingen
  4. Controleer of uw agent de e-mail verwerkt en beantwoordt

Word-integratie testen

Voor agenten die reageren op Word-opmerkingen:

  1. Open een Word-document waar uw agent toegang toe heeft.
  2. Voeg een opmerking toe waarin uw agent wordt genoemd.
  3. Controleer uw lokale console op de melding.
  4. Controleer of de respons van uw agent in Word verschijnt.

Tunnelactiviteit monitoren

Dev Tunnels biedt verkeersinspectie om verbindingsproblemen te helpen oplossen en inzicht te krijgen in de stroom aanvragen:

devtunnel show <tunnel-id>

De opdracht geeft het volgende weer:

  • Actieve verbindingen en sessiedetails.
  • Aanvraag- en responsinformatie.
  • Verkeersvolumestatistieken.
  • Verbindingsfouten en -waarschuwingen.

U kunt de tunnelactiviteit ook in realtime monitoren door de uitvoer van de opdracht devtunnel host te bekijken.

Tunnelverbindingen in stand houden

Dev-tunnels vereisen dat het devtunnel host-proces blijft draaien. Als door inactiviteit, netwerkproblemen of de geactiveerde slaapstand van uw computer de tunnelverbinding wordt verbroken, moet u deze opnieuw starten.

De tunnelstatus controleren

Controleer of uw tunnel actief is:

devtunnel list

De uitvoer geeft het volgende weer:

  • Tunnel-id: De aanduiding van uw tunnel
  • Hostverbindingen: Aantal actieve verbindingen (moet één of meer zijn wanneer devtunnel host actief is)
  • Poorten: Geconfigureerde poorten
  • Vervaldatum: Vervaldatum van de tunnel

Als Hostverbindingen 0 aangeeft, bestaat de tunnel maar wordt deze momenteel niet gehost.

Herstart een tunnel waarmee de verbinding is verbroken

Als uw tunnelverbinding wegvalt, start deze dan opnieuw met dezelfde tunnel-id:

devtunnel host <tunnel-id>

De tunnel-URL blijft hetzelfde, waardoor u de configuratie van het eindpunt voor berichten van uw agent niet hoeft bij te werken.

Tunnels actief houden tijdens de ontwikkeling

Om stabiele verbindingen te behouden kunt u het volgende doen:

  • Houd het terminalvenster open - Sluit de terminal niet zolang devtunnel host wordt uitgevoerd.
  • Voorkom dat de computer in de slaapstand gaat - Stel uw systeem zo in dat het wakker blijft tijdens testsessies.
  • Let op verbindingsfouten - Monitor de terminaluitvoer van devtunnel host op meldingen over verbroken verbindingen.
  • Herstart na netwerkwijzigingen - Als u van netwerk wisselt of opnieuw verbinding maakt met een VPN, start de tunnel dan opnieuw.

Fooi

Als uw tunnel vaak wordt verbroken, controleer dan uw netwerkinstellingen en firewallregels om er zeker van te zijn dat ze de verbinding niet blokkeren.

Opschonen

Wanneer u klaar bent met testen met Dev Tunnels gaat u als volgt te werk:

De tunnel stoppen

Druk op Ctrl+C in de terminal waarin devtunnel host wordt uitgevoerd om de tunnel te stoppen.

Deze opdracht verwijdert de Dev Tunnel-URL van het eindpunt voor berichten van uw agent. Wanneer u de oplossing in productie implementeert, stelt u de URL van het in de cloud gehoste eindpunt in.

Notitie

De tunnel blijft beschikbaar voor toekomstig gebruik totdat u deze expliciet verwijdert met devtunnel delete <tunnel-id>.

Beperkingen

Houd rekening met de volgende beperkingen bij het testen met Dev Tunnels:

  • Alleen voor ontwikkeldoeleinden: Gebruik Dev Tunnels voor ontwikkeling en testen, niet voor productie.
  • Prestaties: Verwacht een hogere latentie vergeleken met cloud-gehoste agenten vanwege netwerkroutering.
  • Stabiliteit van verbindingen: Tunnelverbindingen kunnen incidenteel uitvallen en vereisen dan een handmatige herstart.
  • Beveiligingsoverwegingen: De --allow-anonymous-vlag is handig tijdens het testen, maar gebruik deze niet bij gevoelige gegevens.
  • Sessiebeheer: Mogelijk moet u zich periodiek opnieuw verifiëren, afhankelijk van de duur van uw sessie.

Volgende stappen

Na succesvolle Dev Tunnel-tests:

Probleemoplossing

Als u problemen ondervindt tijdens het testen via Dev Tunnels, kunt u eerst hier kijken voor oplossingen van veelvoorkomende tunnel-, connectiviteits- en eindpuntproblemen. Voor bredere probleemoplossing van Agent 365 (installatie, verificatie en berichten), zie Probleemoplossing.

Tunnelverbinding mislukt

Symptomen: Dev Tunnel start niet of de verbinding wordt direct verbroken.

Oplossingen:

  • Controleer of u bent ingelogd: devtunnel user login
  • Controleer of een ander proces dezelfde poort gebruikt
  • Zorg ervoor dat uw firewall Dev Tunnel-verbindingen toestaat
  • Verwijder de tunnel en maak deze opnieuw: gebruik devtunnel delete <tunnel-id> en maak vervolgens een nieuwe tunnel aan

Berichten bereiken de lokale agent niet

Symptomen: Microsoft 365 geeft aan dat het bericht is verzonden, maar uw lokale agent ontvangt het niet.

Oplossingen:

  • Controleer of uw agent lokaal actief is
  • Controleer of de tunnel actief is: devtunnel list moet "Verbonden" tonen
  • Controleer de eindpuntconfiguratie in a365.config.json en controleer of uw Dev Tunnel-URL is ingesteld als het berichten-eindpunt
  • Controleer de Dev Tunnel-logboeken in de terminal waarin devtunnel host wordt uitgevoerd, op verbindingsfouten
  • Zorg dat uw lokale poort overeenkomt met de tunnelpoort (beide moeten standaard 3978 zijn)

Verificatiefouten via Dev Tunnel

Symptomen: 401- of 403-fouten bij het testen via Dev Tunnel.

Oplossingen:

  • Controleer of de agent-verificatie is geconfigureerd (verificatie met bearer-tokens werkt niet met dev-tunnels voor Microsoft 365-integratie).
  • Controleer de referenties van de agentblauwdruk in a365.generated.config.json.
  • Controleer of uw agent de vereiste machtigingen heeft voor de bewerkingen die u test.
  • Zorg ervoor dat uw verificatietokens niet zijn verlopen.

Tunnel-URL gewijzigd of verlopen

Symptomen: De voorheen werkende tunnel-URL leidt niet langer naar uw agent.

Oplossingen:

  • Controleer de status van de tunnel met behulp van devtunnel list.
  • Start de tunnel opnieuw door gebruik te maken van devtunnel host <tunnel-id>.
  • Werk het berichten-eindpunt bij als de URL is veranderd door gebruik te maken a365 setup blueprint --endpoint-only.
  • Last updated on