将机器人添加到 Microsoft Teams 应用

重要

本文基于 v3 Bot Framework SDK。 如果要查找 SDK 的当前文档 4.6 或更高版本，请参阅 对话机器人 部分。

构建和连接智能机器人，通过聊天自然地与 Microsoft Teams 用户互动。 或者提供一个基于命令的简单机器人，用作更广泛的 Teams 应用体验的“命令行”界面。 可以创建仅限通知的机器人，此机器人可以在频道或直接消息中将与用户相关的信息直接推送到他们。 甚至可以引入现有的基于 Bot Framework 的机器人，并添加 Teams 特定的支持，让你的体验更加出色。

重要

机器人在 政府社区云 (GCC) 、GCC-High 和国防部 (DOD) 环境中提供。

需要了解的内容：机器人

机器人与你在对话中交互的任何其他团队成员一样出现，只不过它具有六边形头像图标，并且始终处于联机状态。

机器人的行为方式不同，具体取决于它所参与的对话类型。 Teams 中的机器人支持在应用清单中称为作用域的几种对话。

• teams 也称为频道对话。
• personal 机器人与单个用户之间的对话。
• groupChat 机器人与两个或更多用户之间的对话。

有关详细信息，请参阅 与 Microsoft Teams 机器人进行对话。

使用 Teams 应用，你可以使机器人成为体验的明星，或者只是一个帮助者。 机器人作为更广泛的应用包的一部分分发，其中可能包括其他功能，例如选项卡或消息扩展。

机器人 API

Teams 支持大多数 Microsoft Bot Framework。 (如果已有一个基于 Bot Framework 的机器人，则可以轻松地对其进行调整以在 Teams 中工作。) 建议使用 C# 或 Node.js 来利用我们的 SDK。 这些工具包拓展了基本机器人生成器 SDK 的类和方法：

• 使用专用卡类型，例如用于 Microsoft 365 组的连接器卡。
• 在活动上使用和设置 Teams 特定的频道数据。
• 处理消息扩展请求。

SDK 扩展安装依赖项，包括 Bot Builder SDK。

• .NET 如果要使用适用于 Bot Builder SDK for .NET 的 Microsoft Teams 扩展，请在 Visual Studio 项目中安装 Microsoft.Bot.Connector.Teams NuGet 包。 对于 Node.js 开发，自 v4.6 起，BotBuilder for Microsoft Teams 功能已合并到 Bot Framework SDK 中。

重要

可以在任何其他 Web 编程技术中开发 Teams 应用，并直接调用 Bot Framework REST API ，但必须自行执行所有令牌处理。

Teams 开发人员门户 可帮助你创建和配置应用清单，并且可以为你创建 Bot Framework 机器人。 它还包含 React 控件库和交互式卡片生成器。

传出 webhook

通过传出 Webhook，可以创建用于基本交互的简单机器人，例如启动工作流或可能需要的其他简单命令。 传出 Webhook 仅存在于创建它们的团队中，适用于特定于公司工作流的简单流程。 有关详细信息，请参阅传出的 Webhook。

生成优秀的 Teams 机器人

以下文章将指导你完成创建适用于 Teams 的优秀机器人的过程：

• 创建机器人：利用 Bot Framework 团队提供的出色工具、文档和社区。
• 与机器人对话：添加基本聊天流并利用特定于频道的功能。 如果在 .NET 或 Node.js 中进行开发，请使用适用于 Bot Builder SDK 的扩展来简化工作。
• 在机器人中使用卡片：设计用于通信和接受用户响应的卡片。
• 响应机器人事件
• 仅通知机器人：使用机器人为应用发送通知。
• 获取上下文：获取有关用户的信息。
• 机器人菜单：在机器人中使用菜单。
• 机器人和文件：从机器人发送和接收文件。
• 将选项卡与机器人配合使用：使选项卡和机器人协同工作。
• 测试机器人：添加机器人以进行个人或团队对话，以查看运行情况。

另请参阅

Bot Framework 示例。