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

Bot Connector API 中的关键概念

  • 项目

Bot Framework 和 Azure AI 机器人服务可让机器人在 Teams、Facebook 等程序上与用户通信。 通道以两种形式提供：

  • 作为 Azure AI 机器人服务的一部分包含的服务。
  • 作为与 Bot Framework SDK 配合使用的适配器库。

本文重点介绍 Azure AI 机器人服务中包含的标准通道。

Bot Framework 通道

Bot Framework 通道使机器人能够与 Azure 门户中配置的通道交换消息。 它通过 HTTPS 使用行业标准 REST 和 JSON，并通过 JWT 持有者令牌进行身份验证。 有关如何使用 Bot Connector 服务的详细信息，请参阅身份验证以及本部分中的其余文章。

活动

该 Connector 服务通过传递 Activity 对象在机器人和通道（用户）之间交换信息。 最常见的活动类型是“消息”，但是还有其他活动类型可用于将各种类型的信息传达给机器人或通道 。 有关 Bot Connector 服务中“活动”的详细信息，请参阅活动概述。

身份验证

Bot Framework Service 使用 JWT 持有者令牌进行身份验证。 有关如何验证机器人发送到 Bot Framework 的出站请求，以及如何验证机器人从 Bot Framework 接收的入站请求的详细信息，请参阅身份验证。

客户端库

Bot Framework 提供了可用于在 C#、JavaScript、Python 和 Java 中生成机器人的客户端库。

注意

Bot Framework JavaScript、C# 和 Python SDK 将继续受支持，但 Java SDK 即将停用，最终长期支持将于 2023 年 11 月结束。

使用 Java SDK 构建的现有机器人将继续正常运行。

对于新的机器人生成，请考虑使用 Power Virtual Agents 并参阅选择合适的聊天机器人解决方案。

有关详细信息，请参阅机器人构建的未来。

除了简化对 Bot Framework REST API 的调用之外，每个 Bot Framework SDK 还可支持构建封装对话逻辑的对话，实现简单事项的内置提示（如是/否、字符串、数字和枚举）、对强大 AI 框架（例如 LUIS）的内置支持，等等。

注意

Azure QnA Maker 将于 2025 年 3 月 31 日停用。 从2022年10月1日开始，您将无法创建新的 QnA Maker 资源或知识库。 问答功能的较新版本现已作为 Azure AI 语言的一部分提供。

自定义问答是 Azure 语言认知服务的一项功能，是 QnA Maker 服务的更新版本。 有关 Bot Framework SDK 中的问答支持的详细信息，请参阅自然语言理解。

注意

语言理解 (LUIS) 将于 2025 年 10 月 1 日停用。 从 2023 年 4 月 1 日开始，将无法创建新的 LUIS 资源。 语言理解的较新版本现已作为 Azure AI 语言的一部分提供。

对话语言理解（CLU）是 Azure AI 语言的一项功能，是 LUIS 的更新版本。 有关 Bot Framework SDK 中的语言理解支持的详细信息，请参阅 自然语言理解。

注意

作为使用 SDK 的替代方法，可使用 Bot Connector Swagger 文件或 REST API 的代码指令以所选的语言生成自己的客户端库。

Bot State 服务

Microsoft Bot Framework State 服务已于 2018 年 3 月 30 日停用。 以前，在 Azure AI 机器人服务或 Bot Builder SDK 上构建的机器人可以默认连接到此服务。此服务由 Microsoft 托管，用于存储机器人状态数据。 机器人需要更新才能使用其自己的状态存储。

其他信息

通过查看本部分中的文章，从身份验证开始，了解有关使用该 Connector 服务生成机器人的详细信息。 如果遇到问题或对该 Connector 服务有任何建议，请参阅支持，了解可用资源列表。