将基于机器人的消息扩展扩展扩展为智能 Microsoft 365 Copilot 副驾驶®的代理

注意

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

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

什么是代理？

代理允许智能 Microsoft 365 Copilot 副驾驶®直接与第三方数据、应用和服务交互，增强其功能，并扩大其功能范围。 代理允许智能 Microsoft 365 Copilot 副驾驶®：

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

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

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

有关详细信息，请参阅 创建和升级代理的指南。

有资格获得代理支持的所有基于机器人的搜索消息扩展都必须满足 策略要求 ，并接受验证，以确保代理满足质量、安全性、隐私和有用性预期。 可以使用 Teams Toolkit for Visual Studio Code、Visual Studio、Teams Toolkit 命令行界面 (CLI) 或 Teams 开发人员门户创建基于机器人的搜索消息扩展，并将消息扩展扩展扩展为在 智能 Microsoft 365 Copilot 副驾驶® 中充当代理。

先决条件

在开始之前，请确保熟悉为智能 Microsoft 365 Copilot 副驾驶®生成消息扩展代理的以下标准和准则：

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

• 创建或升级用于智能 Microsoft 365 Copilot 副驾驶®的消息扩展代理的指南。

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

重要

智能 Microsoft 365 Copilot 副驾驶®代理处于预览状态，仅在Teams 中的 Microsoft 365 Copilot中工作。

让我们为 Teams 创建基于机器人的搜索消息扩展代理，并通过 Microsoft Teams 客户端的撰写消息区域智能 Microsoft 365 Copilot 副驾驶®和共享结果。

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. 选择“发送”。

在 智能 Microsoft 365 Copilot 副驾驶® 中触发消息扩展

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

1. 选择“应用”。

2. 搜索 Copilot 并打开智能 Microsoft 365 Copilot 副驾驶®。

3. 从右上角选择 “面板 ”。

4. 从右窗格中选择所需的代理。

   

5. 在邮件撰写区域中，向智能 Microsoft 365 Copilot 副驾驶®发送消息，以搜索 Teams 和智能 Microsoft 365 Copilot 副驾驶®的最新更新。

   

注意

此提示可能并不总是确保智能 Microsoft 365 Copilot 副驾驶®消息扩展的响应。 如果发生这种情况，请尝试不同的提示或提供反馈，方法是降低智能 Microsoft 365 Copilot 副驾驶®响应的投票并留下消息。

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. 选择“发送”。 自适应卡片将发送到聊天。

    

在 智能 Microsoft 365 Copilot 副驾驶® 中触发消息扩展

若要在 智能 Microsoft 365 Copilot 副驾驶® 中将消息扩展作为代理触发，请执行以下步骤：

1. 转到 Visual Studio。

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

   

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

4. 搜索 Copilot 并打开智能 Microsoft 365 Copilot 副驾驶®。

5. 从右上角选择 “面板 ”。

6. 从右窗格中选择所需的代理。

   

7. 在邮件撰写区域中，向智能 Microsoft 365 Copilot 副驾驶®发送消息，以搜索 Teams 和智能 Microsoft 365 Copilot 副驾驶®的最新更新。

   

注意

此提示可能并不总是确保智能 Microsoft 365 Copilot 副驾驶®消息扩展的响应。 如果发生这种情况，请尝试不同的提示或提供反馈，方法是降低智能 Microsoft 365 Copilot 副驾驶®响应的投票并留下消息。

工具包 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/teamsapp-cli
   

3. 在终端中输入 teamsapp new 。

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

   

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

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

   

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

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

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

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

    teamsapp provision --env dev
   

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

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

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

    

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

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

    

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

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

     teamsapp preview --env dev
    

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

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

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

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

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

在 智能 Microsoft 365 Copilot 副驾驶® 中触发消息扩展

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

1. 选择“应用”。

2. 搜索 Copilot 并打开智能 Microsoft 365 Copilot 副驾驶®。

3. 从右上角选择 “面板 ”。

4. 从右窗格中选择所需的代理。

   

5. 在邮件撰写区域中，向智能 Microsoft 365 Copilot 副驾驶®发送消息，以搜索 Teams 和智能 Microsoft 365 Copilot 副驾驶®的最新更新。

   

注意

此提示可能并不总是确保智能 Microsoft 365 Copilot 副驾驶®消息扩展的响应。 如果发生这种情况，请尝试不同的提示或提供反馈，方法是降低智能 Microsoft 365 Copilot 副驾驶®响应的投票并留下消息。

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 文件中下载到本地计算机。 可以将应用包上传到团队并测试消息扩展。

有关在 智能 Microsoft 365 Copilot 副驾驶® 中测试代理的详细信息，请参阅调试代理选择。

分步指南

按照分步指南为智能 Microsoft 365 Copilot 副驾驶®生成基于机器人的搜索消息扩展代理。

另请参阅

• 使用 API 生成消息扩展
• 定义消息扩展操作命令
• 扩展 Microsoft 365 Copilot
• 代理智能 Microsoft 365 Copilot 副驾驶®常见问题解答