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

C помощью API для Direct Line вы можете реализовать обмен данными между ботом и своим клиентским приложением.You can enable communication between your bot and your own client application by using the Direct Line API. В этой статье представлены основные понятия Direct Line API 3.0 и сведения о соответствующих ресурсах для разработчиков.This article introduces key concepts in Direct Line API 3.0 and provides information about relevant developer resources. Вы можете создать клиент, используя пакет SDK, REST API или Web Chat.You can build a client using the SDK, REST API, or Web Chat.

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

Аутентификация запросов Direct Line API 3.0 может осуществляться с использованием секрета, который можно получить на странице конфигурации канала Direct Line на портале Azure, или с помощью токена, который можно получить в среде выполнения.Direct Line API 3.0 requests can be authenticated either by using a secret that you obtain from the Direct Line channel configuration page in the Azure Portal or by using a token that you obtain at runtime. Дополнительные сведения см. в разделе Authenticate to the Speech API (Аутентификация в API речи).For more information, see Authentication.

Начало общенияStarting a conversation

Общения Direct Line открываются клиентами явным образом и могут выполняться, пока бот и клиент участвуют в них и имеют действительные учетные данные.Direct Line conversations are explicitly opened by clients and may run as long as the bot and client participate and have valid credentials. Дополнительные сведения см. в статье Начало общения.For more information, see Start a conversation.

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

С помощью Direct Line API 3.0 клиент может отправлять боту сообщения, выполняя запросы HTTP POST.Using Direct Line API 3.0, a client can send messages to your bot by issuing HTTP POST requests. В каждом запросе клиент может отправить одно сообщение.A client may send a single message per request. Дополнительные сведения см. в руководстве по отправке действия боту.For more information, see Send an activity to the bot.

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

Клиент может получать сообщения от бота с помощью Direct Line API 3.0 через поток WebSocket либо путем отправки запросов HTTP GET.Using Direct Line API 3.0, a client can receive messages from your bot either via WebSocket stream or by issuing HTTP GET requests. Используя любой из этих методов, клиент может получать сразу несколько сообщений от бота как часть ActivitySet.Using either of these techniques, a client may receive multiple messages from the bot at a time as part of an ActivitySet. Дополнительные сведения см. в статье Receive activities from the bot (Получение действий от бота).For more information, see Receive activities from the bot.

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

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

Bot Framework предоставляет клиентские библиотеки, которые позволяют легко получить доступ к Direct Line API 3.0 с помощью C# и Node.js.The Bot Framework provides client libraries that facilitate access to Direct Line API 3.0 via C# and Node.js.

  • Чтобы использовать клиентскую библиотеку .NET в проекте Visual Studio, установите Microsoft.Bot.Connector.DirectLine пакет NuGet.To use the .NET client library within a Visual Studio project, install the Microsoft.Bot.Connector.DirectLine NuGet package.

  • Чтобы использовать клиентскую библиотеку в проекте Node.js, установите библиотеку botframework-directlinejs с помощью NPM (или загрузите источник).To use the Node.js client library, install the botframework-directlinejs library using NPM (or download the source).

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

Bot Framework предоставляет элемент управления, который позволяет внедрить бот, использующий Direct Line, в клиентское приложение.The Bot Framework provides a control that enables you to embed a Direct-Line-powered bot into your client application. Дополнительные сведения см. в статье о Microsoft Bot Framework WebChat control (Элемент управления WebChat в Microsoft Bot Framework).For more information, see the Microsoft Bot Framework WebChat control.