Основные понятия Direct Line API 3.0

Статья
03/08/2023

C помощью API для Direct Line вы можете реализовать обмен данными между ботом и своим клиентским приложением. В этой статье представлены основные понятия Direct Line API 3.0 и сведения о соответствующих ресурсах для разработчиков. Вы можете создать клиент, используя пакет SDK, REST API или Web Chat.

Аутентификация

Direct Line запросы API 3.0 можно пройти проверку подлинности с помощью секрета, полученного на странице конфигурации канала Direct Line в портал Azure, или с помощью маркера, полученного во время выполнения. Дополнительные сведения см. в разделе Authenticate to the Speech API (Аутентификация в API речи).

Начало общения

Общения Direct Line открываются клиентами явным образом и могут выполняться, пока бот и клиент участвуют в них и имеют действительные учетные данные. Дополнительные сведения см. в статье Начало общения.

Отправка сообщений

С помощью Direct Line API 3.0 клиент может отправлять боту сообщения, выполняя запросы HTTP POST. В каждом запросе клиент может отправить одно сообщение. Дополнительные сведения см. в руководстве по отправке действия боту.

Получение сообщений

Клиент может получать сообщения от бота с помощью Direct Line API 3.0 через поток WebSocket либо путем отправки запросов HTTP GET. Используя любой из этих методов, клиент может получать сразу несколько сообщений от бота как часть ActivitySet. Дополнительные сведения см. в статье Receive activities from the bot (Получение действий от бота).

Ресурсы для разработчиков

Клиентские библиотеки

Bot Framework предоставляет клиентские библиотеки, которые позволяют легко получить доступ к Direct Line API 3.0 с помощью C# и Node.js.

Чтобы использовать клиентскую библиотеку .NET в проекте Visual Studio, установите Microsoft.Bot.Connector.DirectLineпакет NuGet.s.
Чтобы использовать клиент Node.js, установите библиотеку botframework-directlinejs с помощью NPM (или скачайте источник).

Элемент управления веб-чата

Bot Framework предоставляет элемент управления, который позволяет внедрить бот, использующий Direct Line, в клиентское приложение. Дополнительные сведения см. в статье о Microsoft Bot Framework WebChat control (Элемент управления WebChat в Microsoft Bot Framework).