将基于机器人的消息扩展作为适用于 Microsoft 365 的 Copilot 插件进行扩展

注意

• 确保适用于 Microsoft 365 的 Copilot 适用于你的组织。 有两种方法可以获取 Copilot 的开发人员环境：
  • 具有 Copilot (的沙盒Microsoft 365 租户，可通过 TAP 成员资格) 以有限预览版提供。
  • 符合条件的 Microsoft 365 或Office 365生产环境，具有适用于 Microsoft 365 许可证的 Copilot。
• 公共 开发人员预览版中提供了基于机器人的搜索消息扩展插件。
• 只有具有搜索命令的基于机器人的消息扩展才能扩展为 Copilot for Microsoft 365 的插件。

Microsoft Copilot适用于 Microsoft 365，由高级处理和业务流程引擎提供支持，Microsoft 365 应用、Microsoft Graph 和大型语言模型 (LLM) 集成，以将字词转换为强大的生产力工具。 尽管 Copilot for Microsoft 365 可以利用 Microsoft 365 生态系统中的应用和数据，但许多用户依赖各种外部工具和服务进行工作管理和协作。 通过在 Copilot for Microsoft 365 中将消息扩展扩展为插件，可以让用户与第三方工具和服务交互，从而使他们能够使用 Copilot for Microsoft 365 实现更多目标。 可以通过开发插件或连接到外部数据源来实现此扩展。

观看视频，了解有关使用 Teams 消息扩展 Copilot for Microsoft 365 的详细信息：

什么是插件？

插件允许 Copilot for Microsoft 365 直接与第三方数据、应用和服务交互，增强其功能，并扩大其功能范围。 插件允许 copilot for Microsoft 365：

• 获取实时信息，例如产品发布的最新新闻报道。
• 检索基于知识的信息，例如 Figma 中的团队设计文件。

说明增强了消息扩展插件的可用性和有效性。 以下说明对应用的功能提供了清晰而简洁的摘要：

• 应用说明：应用说明有助于改进 Teams 应用商店中的应用可发现性。
• 命令说明：命令说明将用户意向和话语映射到插件中的搜索命令，并且必须基于对用户意向和关键字的分析进行构建。
• 参数说明：参数说明以自然语言和输出格式解释系统的要求。
• 语义说明：语义说明有助于 Copilot for Microsoft 365 生成内容，通过提供插件的功能和方案的概念性理解，帮助实现用户目标并将用户的意图与插件的功能相匹配。

有关详细信息，请参阅 定义说明。

所有基于机器人的搜索消息扩展都有资格获得插件支持，但需经过验证，以确保插件满足质量、安全性、隐私和有用性预期。 可以使用 Teams Toolkit for Visual Studio Code、Visual Studio、Teams Toolkit 命令行界面 (CLI) 或 Teams 开发人员门户创建基于机器人的搜索消息扩展，并将消息扩展扩展为 Copilot for Microsoft 365 中的插件。

先决条件

在开始之前，请确保熟悉以下标准和准则，以生成适用于 copilot for Microsoft 365 的消息扩展插件：

• Teams 应用商店验证指南中概述的合规性、性能、安全性和用户体验标准。

• 创建或升级 copilot for Microsoft 365 的消息扩展插件的指南。

创建基于机器人的消息扩展

重要

Microsoft 365 的Microsoft Copilot插件处于预览状态，仅在 Microsoft Teams 中的Microsoft 365 Chat中工作。

让我们创建一个基于机器人的搜索消息扩展，该扩展可以在 Teams 和 Copilot 中搜索 npm 注册表，并通过 Microsoft Teams 客户端的撰写消息区域共享结果。

Visual Studio Code

在开始之前，请确保安装以下工具来生成和部署消息扩展：

• 安装最新的 Teams 工具包预发行版。
• 确保已启用 “开发 Copilot 插件” 功能标志。 若要启用功能标志，请执行以下步骤：
  1. 打开 Visual Studio Code。
  2. 转到 “管理>设置”。
  3. 在“搜索设置”搜索框中输入 Teams 工具包。
  4. 在 “扩展”下，选中“ Fx-extension：开发 Copilot 插件 ”复选框。

若要使用 Visual Studio Code 创建基于机器人的搜索消息扩展插件，请执行以下步骤：

1. 打开 Visual Studio Code。

2. 在左窗格中，选择“ Teams 工具包”。

3. 选择“ 创建新应用”。

4. 选择 “消息扩展”。

5. 选择“ 自定义搜索结果”。

6. 选择“ 开始使用机器人”。

   

7. 选择编程语言。

8. 选择“ 默认文件夹”。

9. 输入应用的名称，然后选择 Enter。 Teams 工具包为应用搭建基架并创建消息扩展。

若要在 Teams 中运行邮件扩展，请执行以下步骤：

1. 在左窗格中，选择“ Teams 工具包”。

2. 在 “帐户”下，执行以下步骤：

   1. 选择“ 登录到 Microsoft 365” ，然后输入Microsoft 365 凭据。

   2. 选择“ 登录到 Azure ”并输入 Azure 凭据。

      

3. 在左窗格中，选择“ 运行和调试” (Ctrl+Shift+D) 。

4. 选择 “在 Teams (Edge) 中调试”或“在 Teams (Chrome) 调试”。 Teams 工具包使用 Web 浏览器在 Teams 中启动应用。

5. 选择“添加”。 应用安装在 Teams 上。

6. 转到聊天并选择 “操作和应用”。

7. 在邮件扩展浮出菜单中，在搜索框中输入邮件扩展的名称。

8. 选择邮件扩展并输入搜索查询。

9. 从列表中选择一个产品。 Teams 在邮件撰写区域中将产品展开为自适应卡片。

10. 选择“发送”。

在 Copilot for Microsoft 365 中触发消息扩展

若要在 Teams 中的 Copilot for Microsoft 365 中将消息扩展作为插件触发，请执行以下步骤：

1. 选择“应用”。

2. 搜索 Copilot 并打开 Copilot for Microsoft 365 应用。

3. 选择“ 插件”。

4. 在插件列表中，打开消息扩展的开关。

   

5. 在邮件撰写区域中，向 Copilot 发送Microsoft 365 的消息，以在 Teams 和 Copilot 中搜索 npm 包信息。 例如，在 npm-searchlocal 中查找 teamsfx-react 上的 npm 包信息。

   

注意

此提示可能并不总是使 copilot for Microsoft 365 包含来自消息扩展的响应。 如果发生这种情况，请尝试一些其他提示或向我们留下反馈，方法是对 Copilot Microsoft 365 响应进行投票并留言。

Visual Studio

在开始之前，请确保安装以下工具来生成和部署消息扩展：

• 安装 Visual Studio Enterprise 2022 预览版 17.9.0 预览版 1.0 或更高版本，并在 ASP.NET 和 Web 开发工作负载下安装 Microsoft Teams 开发工具。
• 确保已启用 Copilot 功能标志。 若要启用功能标志，请执行以下步骤：
  1. 打开 Visual Studio。
  2. 转到 “工具>选项”。
  3. 在“搜索设置”搜索框中输入 Teams 工具包。
  4. 在 “预览功能 ”部分中，选中“ Teams 工具包：开发 Copilot 插件 ”复选框。
• 确保已启用多项目启动配置文件。 若要启用配置文件，请执行以下步骤：
  1. 打开 Visual Studio。
  2. 转到 “工具>选项”。
  3. 在 “预览功能 ”部分中，选中“ 启用多项目启动配置文件” 复选框。

若要使用 Visual Studio 创建基于机器人的搜索消息扩展插件，请执行以下步骤：

1. 打开 Visual Studio。

2. 转到 “文件>新建>项目...” 或 “创建新项目”。

3. 搜索 Teams 并选择 “Microsoft Teams 应用”。

4. 输入项目详细信息。 确保未选中“ 将解决方案和项目放在同一目录中 ”复选框。

5. 选择“创建”。

6. 选择“ 自定义搜索结果”。

   

7. 选择“创建”。 项目已搭建基架。

8. 在调试下拉菜单中，选择“ 开发隧道>”“创建隧道”。

   
   

   1. 选择要创建隧道的帐户。 Azure、 Microsoft 帐户 (MSA) 和 GitHub 是支持的帐户类型。
   2. 名称：输入隧道的名称。
   3. 隧道类型：选择 “持久 ”或“ 临时”。
   4. 访问：选择“ 公共”。
   5. 选择“确定”。 Visual Studio 显示一条确认消息，指示已创建隧道。

   创建的隧道列在 开发隧道 > 下， (隧道) 的名称 。

9. 转到解决方案资源管理器并选择项目。

10. 右键单击项目菜单，然后选择 “Teams 工具包>准备 Teams 应用依赖项”。

    

    如果出现提示，请使用 Microsoft 365 帐户登录。

11. 在调试下拉菜单中， 选择“Microsoft Teams (浏览器) 。 Visual Studio 启动 Teams Web 客户端。

12. 选择“添加”。 消息扩展将添加到 Teams。

    

13. 转到聊天并选择 “操作和应用”。

14. 在邮件扩展浮出菜单中，在搜索框中输入邮件扩展的名称。

15. 选择邮件扩展并输入搜索查询。

    

16. 从列表中选择一个产品。 Teams 将产品展开到邮件撰写区域中的自适应卡片中。

17. 选择“发送”。 自适应卡片将发送到聊天。

    

在 Copilot for Microsoft 365 中触发消息扩展

若要在 Copilot for Microsoft 365 中将消息扩展作为插件触发，请执行以下步骤：

1. 转到 Visual Studio。

2. 在调试下拉列表中，选择“ Copilot (浏览器) 。 Visual Studio 启动 Teams Web 客户端。

   

3. 转到 Teams Web 客户端>应用。

4. 搜索 copilot for Microsoft 365 ，并打开 Copilot for Microsoft 365 应用。

5. 选择“ 插件”。

6. 在插件列表中，打开应用的开关。

   

7. 在邮件撰写区域中，向 Copilot 发送Microsoft 365 的消息，以在 Teams 和 Copilot 中搜索 npm 包信息。 例如，在 npmsearchlocal 中查找 teamsfx-react 上的 npm 包信息。

   

注意

此提示可能并不总是使 copilot for Microsoft 365 包含来自消息扩展的响应。 如果发生这种情况，请尝试一些其他提示或向我们留下反馈，方法是对 Copilot Microsoft 365 响应进行投票并留言。

工具包 CLI

在开始之前，请确保将环境变量 DEVELOP_COPILOT_PLUGIN 设置为 true。 若要设置环境变量，请执行以下步骤：

1. 在计算机上，选择 Windows + X 密钥。

2. 选择“ 系统”。

3. 在“ 关于>设备规范”下，选择“ 高级系统设置”。

4. 在“系统属性”下，选择“环境变量”。

5. 在 “用户变量”下，选择“ 新建”。此时会打开 “新建用户变量 ”对话框。

6. 更新以下字段：

   1. 变量名称：DEVELOP_COPILOT_PLUGIN
   2. 变量值：true

7. 选择“确定”。

   

若要使用 Teams 工具包 CLI 创建基于机器人的搜索消息扩展插件，请执行以下步骤：

1. 转到 命令提示符。

2. 输入以下命令：

   npm install -g @microsoft/teamsfx-cli@beta
   

3. 在终端中输入 teamsfx new 。

4. 选择 “消息扩展”。 使用箭头键在选项之间切换。

   

5. 选择“ 自定义搜索结果”。

6. 选择“ 开始使用机器人”。

   

7. 输入项目的位置，然后选择 Enter。

8. 输入应用程序的名称，然后选择 Enter。

   Teams 工具包在指定位置搭建基架并创建项目。

9. 转到创建项目的文件夹路径，并输入以下命令，在 Azure 中预配应用：

    teamsfx provision --env dev
   

   Teams 工具包 CLI 会打开浏览器窗口，并请求你登录到 Microsoft 帐户。

10. 登录到你的 Microsoft 帐户。 Teams Toolkit CLI 在 Azure 上执行验证并预配应用。

11. 从列表中选择一个订阅。

    

12. 从列表中选择一个资源组。

13. 如果收到一条消息，该消息可能会 根据使用情况产生成本。是否要使用上面列出的帐户在开发环境中预配资源？，请输入 Y。

    

    Teams 工具包验证应用清单并在 Azure 上预配应用。

14. 在命令提示符窗口中，输入以下命令以在 Teams 中预览应用：

     teamsfx preview --env dev
    

    此时会打开一个新的浏览器窗口，其中包含 Teams Web 客户端。 可以将应用添加到 Teams。

15. 选择“添加”。 消息扩展将添加到 Teams。

16. 转到聊天并选择 “操作和应用”。

17. 在邮件扩展浮出菜单中，在搜索框中输入邮件扩展的名称。

18. 选择邮件扩展并输入搜索查询。

在 Copilot for Microsoft 365 中触发消息扩展

若要通过 Copilot for Microsoft 365 触发消息扩展，请执行以下步骤：

1. 选择“应用”。

2. 搜索 copilot for Microsoft 365 ，并打开 Copilot for Microsoft 365 应用。

3. 选择“ 插件”。

4. 在插件列表中，打开应用的开关。

   

5. 在邮件撰写区域中，向 Copilot 发送Microsoft 365 的消息，以在 Teams 和 Copilot 中搜索 npm 包信息。 例如，在 npm-searchlocal 中查找 teamsfx-react 上的 npm 包信息。

   

注意

此提示可能并不总是使 copilot for Microsoft 365 包含来自消息扩展的响应。 如果发生这种情况，请尝试一些其他提示或向我们留下反馈，方法是对 Copilot Microsoft 365 响应投下票，并留下带有 [MessageExtension] 标记的消息。

Teams 开发人员门户

若要使用适用于 Teams 的开发人员门户创建基于机器人的消息扩展，请执行以下步骤：

1. 转到 Teams 开发人员门户。

2. 转到 “应用”。

3. 选择“ + 新建应用”。

4. 在 “添加应用 ”页中，更新名称并选择“ 公共开发人员预览版” (devPreview) 。

   

5. 在 “配置”下，选择“ 应用功能”。

6. 选择 “消息传递扩展”。

7. 在 “消息扩展类型”下，选择“ 机器人”。

   1. 如果收到免责声明，该免责声明读取 API 消息扩展已被用户使用。是否将消息扩展类型更改为机器人？。 选择“ 是，更改”。

   

8. 如果有现有机器人，请选择“ 现有机器人 ”;如果有机器人 ID，请选择“ 输入机器人 ID”。

   1. 如果没有机器人 ID，可以选择“ 创建新机器人”，以创建新机器人，并输入已创建的新机器人的机器人 ID。

   

9. 选择“保存”。

10. 在 “命令”下，选择“ + 添加命令”。

    此时会显示“添加命令”页。

11. 在 “添加命令 ”页中，选择“ 搜索 ”作为命令的类型，并更新以下字段：

    • 命令 ID
    • 命令标题
    • 命令说明
    • 命令工作的上下文
    • 参数名称
    • 参数标题
    • 参数说明

12. 选择“保存”。 命令将添加到消息扩展。

13. 选择“保存”。

创建基于机器人的搜索消息扩展。

若要测试在 Teams 开发人员门户中创建的基于机器人的消息扩展，可以使用以下方法：

• 在 Teams 中预览：在开发人员门户中，打开邮件扩展，然后选择右上角的“ 在 Teams 中预览 ”。 你将重定向到 Teams，可在其中将应用添加到 Teams 以预览应用。

• 下载应用包：在消息扩展页上，从左窗格中选择 “应用包 ”，然后在窗口左上角选择“ 下载应用包”。 应用包在 .zip 文件中下载到本地计算机。 可以将应用包上传到团队并测试消息扩展。

有关在 Copilot for Microsoft 365 中测试插件的详细信息，请参阅 调试插件选择。

将消息扩展作为 Copilot 的插件启用会议

确保已创建基于机器人的消息扩展，并将其扩展为 Copilot for Microsoft 365 的插件。 在开始之前，我们建议你遵循 Copilot for Microsoft 365 扩展指南中列出的准则 来扩展适用于会议的 Copilot 插件。

若要为 Copilot for Teams 会议启用消息扩展插件，请执行以下步骤：

1. 转到 Teams 会议。

2. 选择“ 加入”。

3. 在会议窗口中，选择“ Copilot”。

4. 选择 “开始听录”。

   

5. 选择“口语”，然后选择“ 确认”。 此时会显示“适用于 Teams 的 Copilot”窗格。

   

6. 在“适用于 Teams 的 Copilot”窗格中的右下角，选择“ Copilot 插件”按钮。

   

7. 搜索插件并打开插件的开关。

8. 在撰写区域中，选择“ 更多提示 ”以发送静态提示，也可以键入自己的提示并选择“ 发送”。

   

会议 Copilot 可帮助会议变得更好、更高效。 你可以使会议更具交互性，从而为用户提供更流畅、更有趣的体验，从而为用户提供帮助。

分步指南

按照 分步指南 为 Copilot for Microsoft 365 生成基于机器人的搜索消息扩展插件。

另请参阅

• 使用 API 生成消息扩展
• 定义消息扩展操作命令
• 扩展适用于 Microsoft 365 的 Microsoft Copilot