您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的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 文件以所选的语言生成自己的客户端库。