Kluczowe pojęcia dotyczące interfejsu API Direct Line w wersji 3.0
Komunikację między botem i własną aplikacją kliencją można włączyć przy użyciu interfejsu API Direct Line. W tym artykule przedstawiono kluczowe pojęcia dotyczące interfejsu API 3.0 Direct Line i przedstawiono informacje o odpowiednich zasobach dla deweloperów. Klienta można utworzyć przy użyciu zestawu SDK, interfejsu API REST lub czat internetowy.
Authentication
Direct Line żądania interfejsu API 3.0 można uwierzytelnić przy użyciu wpisu tajnego, który można uzyskać ze strony konfiguracji kanału Direct Line w Azure Portal lub przy użyciu tokenu uzyskiwanego w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Authentication (Uwierzytelnianie).
Rozpoczynanie konwersacji
Direct Line konwersacje są jawnie otwierane przez klientów i mogą być uruchamiane tak długo, jak bot i klient uczestniczą i mają prawidłowe poświadczenia. Aby uzyskać więcej informacji, zobacz Rozpoczynanie konwersacji.
Wysyłanie komunikatów
Korzystając z interfejsu API Direct Line 3.0, klient może wysyłać komunikaty do bota, wysyłając HTTP POST żądania. Klient może wysłać jeden komunikat na żądanie. Aby uzyskać więcej informacji, zobacz Wysyłanie działania do bota.
Odbieranie komunikatów
Korzystając z interfejsu API Direct Line 3.0, klient może odbierać komunikaty od bota za pośrednictwem WebSocket strumienia lub wysyłając HTTP GET żądania. Korzystając z jednej z tych technik, klient może odbierać wiele komunikatów od bota w ramach elementu ActivitySet. Aby uzyskać więcej informacji, zobacz Odbieranie działań z bota.
Zasoby dla deweloperów
Biblioteki klienta
Platforma Bot Framework udostępnia biblioteki klienckie, które ułatwiają dostęp do interfejsu API Direct Line 3.0 za pośrednictwem języka C# i Node.js.
Aby użyć biblioteki klienta platformy .NET w projekcie programu Visual Studio, zainstaluj
Microsoft.Bot.Connector.DirectLinepakiet NuGet.sAby użyć biblioteki klienta Node.js, zainstaluj bibliotekę
botframework-directlinejsprzy użyciu narzędzia NPM (lub pobierz źródło).
Kontrolka czatu internetowego
Platforma Bot Framework udostępnia kontrolkę, która umożliwia osadzanie bota obsługiwanego bezpośrednio w aplikacji klienckiej. Aby uzyskać więcej informacji, zobacz kontrolkę Microsoft Bot Framework WebChat.