Viktiga begrepp 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
Direct Line API 3.0-begäranden kan autentiseras antingen med hjälp av en hemlighet som du får 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 roboten 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 roboten 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.DirectLineNuGet-paketet.sOm du vill använda Node.js-klientbiblioteket installerar
botframework-directlinejsdu biblioteket med hjälp av NPM (eller laddar ned källan).
Webbchattkontroll
Bot Framework tillhandahåller en kontroll som gör att du kan bädda in en direktlinjedriven robot i klientprogrammet. Mer information finns i Microsoft Bot Framework WebChat-kontrollen.