Udostępnij za pośrednictwem

Najważniejsze pojęcia w Direct Line API 3.0

  • Artykuł

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 direct line w wersji 3.0 i przedstawiono informacje o odpowiednich zasobach deweloperskich. Klienta można utworzyć przy użyciu zestawu SDK, interfejsu API REST lub czat internetowy.

Uwierzytelnianie

Żądania interfejsu API direct line 3.0 można uwierzytelniać przy użyciu wpisu tajnego uzyskiwanego ze strony konfiguracji kanału direct line w witrynie Azure Portal lub przy użyciu tokenu uzyskiwanego w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Authentication (Uwierzytelnianie).

Rozpoczynanie konwersacji

Konwersacje bezpośrednie 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

Za pomocą 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

Za pomocą interfejsu API direct line 3.0 klient może odbierać komunikaty z 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 z 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.DirectLine pakiet NuGet.s

  • Aby użyć biblioteki klienta Node.js, zainstaluj bibliotekę botframework-directlinejs przy użyciu narzędzia NPM (lub pobierz źródło).

Kontrolka czatu internetowego

Platforma Bot Framework zapewnia kontrolę, która umożliwia osadzanie bota opartego na wierszu bezpośrednim w aplikacji klienckiej. Aby uzyskać więcej informacji, zobacz kontrolkę WebChat platformy Microsoft Bot Framework.