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

Direct Line API 1.1 中的重要概念

可使用 Direct Line API 在机器人和自己的客户端应用程序之间实现通信。

重要

本文介绍 Direct Line API 1.1 中的重要概念,并提供有关相关开发人员资源的信息。 如果要在客户端应用程序和机器人之间创建新的连接,请改用 Direct Line API 3.0

身份验证

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

开始聊天

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

发送消息

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

接收消息

使用 Direct Line API 1.1,客户端可以通过使用 HTTP GET 请求进行轮询来接收消息。 为响应每个请求,客户端可以在 MessageSet 中从机器人接收多个消息。 有关详细信息,请参阅从机器人接收消息

开发人员资源

客户端库

Bot Framework 提供了一个客户端库,以便于通过 C# 访问 Direct Line API 1.1。 若要在 Visual Studio 项目中使用客户端库,请安装 Microsoft.Bot.Connector.DirectLinev1.x NuGet 包

作为使用 C# 客户端库的替代方法,可以使用 Direct Line API 1.1 Swagger 文件以所选的语言生成自己的客户端库。