Felsöka en robot från valfri kanal med hjälp av en tunnel
GÄLLER FÖR: SDK v4
Medan roboten är under utveckling kan du använda en IDE och Bot Framework-emulatorn för att chatta med din robot lokalt och inspektera de meddelanden som roboten skickar och tar emot. Om roboten är i produktion kan du felsöka roboten från valfri kanal med hjälp av en tunnel. Den sömlösa anslutningen av din robot till flera kanaler är en viktig funktion som är tillgänglig i Bot Framework.
Den här artikeln beskriver hur du felsöker din robot lokalt med hjälp av en tunnel och en C# EchoBot i en kanal som är ansluten till din robot. I den här artikeln används Microsoft Teams som en exempelkanal.
Förutsättningar
- En prenumeration till Microsoft Azure.
- Installera en tunnelprogramvara, till exempel Dev Tunnels.
- En C# Echo-robot, konfigurerad som en app för flera klientorganisationer och ansluten till valfri kanal.
Konfigurera en tunnel
Dev Tunnels är ett plattformsoberoende program som kan skapa en url för tunneltrafik eller vidarebefordran så att internetbegäranden når din lokala dator. Använd devtunnel för att vidarebefordra meddelanden från externa kanaler på webben direkt till din lokala dator för att tillåta felsökning, i motsats till standardslutpunkten för meddelanden som konfigurerats i Azure Portal.
Öppna en terminal med åtkomst till
devtunnelCLI.Kör devtunnel med följande kommando för att skapa en ny tunnel.
devtunnel host -a -p 3978Kommentar
Den angivna porten är den port som roboten körs på. Du kan använda valfri localhost-port som du vill.
När devtunnel startar kopierar och sparar du url:en för offentlig vidarebefordran för senare.
Konfigurera i Azure Portal
När devtunnel körs loggar du in på din Azure Portal och visar dina robotinställningar för att utföra vissa konfigurationer.
Välj robotresursen som är ansluten till din lokala robot.
Leta upp inställningar/konfiguration. Kopiera och klistra in devtunnel-vidarebefordrans-URL:en i fältet Meddelandeslutpunkt . Se till att du underhåller "/api/messages" i slutet av URL:en.
Välj Använd.
Test
Nu skickas inkommande meddelanden från till din robot från externa kanaler till din lokala robot. Exempelroboten som vi använder för att visa att detta redan har konfigurerats live för Microsoft Teams. Läs Ansluta en robot till Microsoft Teams om att ansluta en lokal robot till Microsoft Teams-kanalen .
Lokalt kan du ange brytpunkter i Visual Studio. När du expanderar textegenskapen från det inkommande aktivitetsobjektet ser du att meddelandet du skickade roboten från teamen fångas upp lokalt så att du kan felsöka.
Härifrån kan du felsöka normalt och köra koden steg för steg. Använd detta för att felsöka din robot från valfri kanal.