Nyckelbegrepp i Direct Line API 3.0
Du kan aktivera kommunikation mellan din robot och ditt eget klientprogram med hjälp av Direct Line-API:et. Den här artikeln beskriver viktiga begrepp i Direct Line API 3.0 och innehåller information om relevanta utvecklarresurser. Du kan skapa en klient med hjälp av SDK, REST API eller Webbchatt.
Autentisering
Direktrads-API 3.0-begäranden kan autentiseras antingen med hjälp av en hemlighet som du hämtar från direct line-kanalkonfigurationssidan i Azure Portal eller med hjälp av en token som du får vid körning. Mer information finns i Autentisering.
Starta en konversation
Direct Line-konversationer öppnas uttryckligen av klienter och kan köras så länge roboten och klienten deltar och har giltiga autentiseringsuppgifter. Mer information finns i Starta en konversation.
Skicka meddelanden
Med Direct Line API 3.0 kan en klient skicka meddelanden till din robot genom att utfärda HTTP POST
begäranden. En klient kan skicka ett enda meddelande per begäran. Mer information finns i Skicka en aktivitet till roboten.
Ta emot meddelanden
Med Direct Line API 3.0 kan en klient ta emot meddelanden från din robot antingen via WebSocket
dataström eller genom att utfärda HTTP GET
begäranden. Med någon av dessa tekniker kan en klient ta emot flera meddelanden från roboten åt gången som en del av en ActivitySet
. Mer information finns i Ta emot aktiviteter från roboten.
Resurser för utvecklare
Klientbibliotek
Bot Framework tillhandahåller klientbibliotek som underlättar åtkomsten till Direct Line API 3.0 via C# och Node.js.
Om du vill använda .NET-klientbiblioteket i ett Visual Studio-projekt installerar du
Microsoft.Bot.Connector.DirectLine
NuGet-paketet.sOm du vill använda Node.js-klientbiblioteket
botframework-directlinejs
installerar du biblioteket med NPM (eller laddar ned källan).
Webbchattkontroll
Bot Framework tillhandahåller en kontroll som gör att du kan bädda in en direktradsdriven robot i klientprogrammet. Mer information finns i Microsoft Bot Framework WebChat-kontrollen.