通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Direct Line API 3.0 中的重要概念

  • 项目

可使用 Direct Line API 在机器人和自己的客户端应用程序之间实现通信。 本文介绍 Direct Line API 3.0 中的重要概念，同时介绍了相关的开发人员资源。 可以使用 SDK、REST API 或 Web Chat 来构建客户端。

身份验证

可通过以下方式对 Direct Line API 3.0 请求进行身份验证：使用从 Azure 门户的 Direct Line 通道配置页中获取的机密，或使用在运行时获得的令牌。 有关详细信息，请参阅身份验证。

开始聊天

Direct Line 会话由客户端显式打开，只要机器人和客户端参与并拥有有效凭据，就可以运行。 有关详细信息，请参阅开始聊天。

发送消息

使用 Direct Line API 3.0，客户端可通过发出 HTTP POST 请求向机器人发送消息。 客户端可为每个请求发送一条消息。 有关详细信息，请参阅向机器人发送活动。

接收消息

使用 Direct Line API 3.0，客户端可通过 WebSocket 流或通过发出 HTTP GET 请求来接收机器人发出的消息。 使用其中任一技术，客户端都可一次接收多条来自机器人的消息，作为 ActivitySet 的一部分。 有关详细信息，请参阅从机器人接收活动。

开发人员资源

客户端库

Bot Framework 提供了客户端库，帮助用户通过 C# 和 Node.js 访问 Direct Line API 3.0。

  • 要在 Visual Studio 项目中使用 .NET 客户端库，请安装 Microsoft.Bot.Connector.DirectLine NuGet 包。

  • 要使用 Node.js 客户端库，请使用 NPM 安装 botframework-directlinejs 库（或下载源）。

网上聊天控件

Bot Framework 提供了一个控件，用于将 Direct-Line 驱动的机器人嵌入到客户端应用程序中。 有关详细信息，请参阅 Microsoft Bot Framework 网上聊天控件。