Testa agenter med Dev Tunnels

Genom att använda Dev Tunnels kan du testa din Agent 365-agent med Microsoft 365-applikationer (så som Teams, Outlook eller Word) medan din agent körs lokalt på din utvecklingsdator. Detta tillvägagångssätt bygger en bro mellan lokal utveckling och testning i verkliga Microsoft 365-miljöer, så att du kan validera agentens beteende innan du distribuerar till molnet.

Krav

Innan du använder Dev Tunnels, se till att du installerar Dev Tunnels kommandoradsverktyg.

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: Ladda ner från aka.ms/devtunnels/download

Ställ in Dev Tunnel

Konfigurera en Dev-tunnel för att exponera din lokala agent-endpoint för Microsoft 365-tjänster.

Skapa och starta en tunnel

1. Logga in på Dev Tunnel:

   devtunnel user login
   

2. Skapa en permanent tunnel:

   devtunnel create --allow-anonymous
   

   Detta kommando returnerar ett tunnel-ID. Spara denna identifierare för framtida bruk.

3. Konfigurera tunnelporten:

   Ange porten din agentserver använder (vanligtvis 3978):

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

4. Starta tunneln:

   devtunnel host <tunnel-id>
   

   Kommandot visar din tunnel-URL (t.ex. https://abc123xyz.devtunnels.ms:3978). Kopiera denna URL för nästa steg.

Konfigurera slutpunkt för agentmeddelanden

Registrera din Dev Tunnel-URL (till exempel https://abc123xyz.devtunnels.ms:3978/api/messages) som agentmeddelandets slutpunkt så att Microsoft 365 vet vart meddelanden ska dirigeras. Glöm inte /api/messages-suffixet till slutpunkten.

Se Ställ in slutpunkt för agentmeddelanden

Testa med Microsoft 365

När din Dev Tunnel är aktiv och slutpunkt är registrerad kan du testa din agent i Microsoft 365-applikationer.

Testa i Microsoft Teams

1. Starta din lokala agent genom att följa instruktionerna i Installera beroenden och starta agentapplikationsservern.

2. Verifiera tunnelanslutning:

   devtunnel list
   

   Kontrollera att din tunnel visar aktiva värdanslutningar. Kolumnen "Värdanslutningar" ska visa ett tal större än 0.

3. Interagera med din agent i Teams:

   • Öppna Microsoft Teams (webbversionen eller skrivbordsappen)
   • I Teams-sökfältet, sök efter din agent genom att ange namn eller e-postadress
   • Starta en konversation med agenten
   • Skicka ett meddelande och observera svaret
   • Kontrollera din lokala konsol för inkommande förfrågningar och agentens aktivitet

Testa e-postaviseringar

Om din agent är konfigurerad för e-postaviseringar:

1. Skicka ett e-postmeddelande till din agents e-postadress
2. CC:a din agent i en e-posttråd
3. Övervaka din lokala konsol för aviseringswebhooken
4. Verifiera att din agent hanterar och svarar på mejlet

Testa Word-integration

För agenter som svarar på Word-kommentarer:

1. Öppna ett Word-dokument där din agent har åtkomst.
2. Lägg till en kommentar där du nämner din agent.
3. Kontrollera din lokala konsol för notifikation.
4. Verifiera att din agents svar syns i Word.

Övervaka tunnelaktivitet

Dev Tunnels tillhandahåller trafikövervakning för att hjälpa till att felsöka anslutningsproblem och förstå flödet av förfrågningar:

devtunnel show <tunnel-id>

Detta kommando visar:

• Aktiva anslutningar och sessionsdetaljer.
• Information om begäran och svar.
• Trafikvolymstatistik
• Fel och varningar vid anslutning.

Du kan också övervaka tunnelaktivitet i realtid genom att följa utdata från kommandot devtunnel host.

Underhåll tunnelanslutningar

Dev Tunnels kräver att devtunnel host-processen förblir igång. Om anslutningen bryts på grund av inaktivitet, nätverksproblem eller att datorn går i viloläge, behöver du starta om den.

Kontrollera tunnelns status

Kontrollera om din tunnel är aktiv:

devtunnel list

Utdata visar:

• Tunnel-ID: Din tunnelidentifierare
• Värdanslutningar: Antal aktiva anslutningar (bör vara en eller flera när devtunnel host är igång)
• Portar: Konfigurerade portar
• Utgångstid: Tunnelns utgångstid

Om Värdanslutningar visar 0 finns tunneln men har ingen värd just nu.

Starta om en frånkopplad tunnel

Om din tunnelanslutning bryts, starta om den med samma tunnel-ID:

devtunnel host <tunnel-id>

Tunnelns URL förblir densamma, så du behöver inte ändra konfigurationen för agentens meddelandeendpoint.

Håll tunnlarna aktiva under utveckling

För att upprätthålla stabila anslutningar:

• Håll terminalfönstret öppet – stäng inte terminalen som kör devtunnel host.
• Förhindra datorns viloläge – Konfigurera ditt system att hålla sig vaket under testsessioner.
• Var uppmärksam på anslutningsfel – övervaka devtunnel host-terminalens logg för meddelanden om bortkoppling.
• Starta om efter nätverksändringar – Om du byter nätverk eller återansluter till VPN, starta om tunneln.

Rensa

När du har testat klart med Dev Tunnels:

Stoppa tunneln

Tryck Ctrl+C i terminalen där devtunnel host körs för att stoppa tunneln.

Detta kommando tar bort Dev Tunnel-URL:en från din agents endpoint för meddelanden. När du distribuerar till produktion, ställ in den molnbaserade endpoint-URL:en.

Begränsningar

Tänk på dessa begränsningar när du testar med Dev Tunnels:

• Endast utveckling: Använd Dev Tunnels för utveckling och test, inte för produktion.
• Prestanda: Förvänta dig högre latens jämfört med molnbaserade agenter på grund av nätverksrouting.
• Anslutningsstabilitet: Tunnelanslutningar kan ibland tappa kontakten och kräva manuell omstart.
• Säkerhetsaspekter: --allow-anonymous-flaggan är användbar för tester, men bör inte användas med känslig data.
• Sessionshantering: Du kan behöva logga in igen regelbundet beroende på sessionens varaktighet.

Nästa steg

Efter ett lyckat Dev Tunnel-test:

• Distribuera din agent till molnet: Distribuera till Azure, Konfigurera agentens meddelande-endpoint i AWS eller Konfigurera agentens meddelande-endpoint i GCP.
• Konfigurera slutpunkter för agentmeddelanden: Slutpunkt för agentmeddelanden.
• Följ hela utvecklingslivscykeln: Agent 365 Development Lifecycle.

Felsökning

Om du stöter på problem när du testar genom Dev Tunnels, börja här för gemensamma tunnel-, anslutnings- och endpoint-lösningar. För bredare Agent 365-felsökning (installation, autentisering och meddelandehantering), se Felsökning.

Tunnelanslutningen misslyckas

Symtom: Dev Tunnel startar inte eller kopplas bort direkt.

Lösningar:

• Verifiera att du är inloggad: devtunnel user login
• Kontrollera om en annan process använder samma port
• Säkerställ att din brandvägg tillåter Dev Tunnel-anslutningar
• Ta bort och återskapa tunneln: devtunnel delete <tunnel-id> och skapa sedan en ny

Meddelandena når inte den lokala agenten

Symtom: Microsoft 365 indikerar att meddelandet skickades, men din lokala agent tar inte emot det.

Lösningar:

• Bekräfta att din agent körs lokalt
• Kontrollera att tunneln är aktiv: devtunnel list ska visa "Ansluten"
• Kontrollera slutpunktens konfiguration i a365.config.json och verifiera att din Dev Tunnel-URL är inställd som meddelandeslutpunkt
• Granska Dev Tunnel-loggar i terminalfönstret där devtunnel host körs och kontrollera efter anslutningsfel
• Se till att din lokala port matchar tunnelporten (båda ska vara 3978 som standard)

Autentiseringsfel via Dev Tunnel

Symtom: 401- eller 403-fel vid testning via Dev Tunnel.

Lösningar:

• Verifiera att agentisk autentisering är konfigurerad (bärartokenautentisering fungerar inte med Dev Tunnels för Microsoft 365-integration).
• Kontrollera agentens blueprint-uppgifter i a365.generated.config.json.
• Bekräfta att din agent har de nödvändiga behörigheterna för de operationer du testar.
• Se till att dina autentiseringstoken inte har gått ut.

Tunnel-URL har ändrats eller har gått ut

Symptom: Tidigare fungerande tunnel-URL leder inte längre till din agent.

Lösningar:

• Kontrollera tunnelstatus med hjälp av devtunnel list.
• Starta om tunneln med devtunnel host <tunnel-id>.
• Uppdatera meddelandeändpunkten om URL:en har ändrats med a365 setup blueprint --endpoint-only.