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

项目
04/13/2024

注意

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

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

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

什么是插件？

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

获取实时信息，例如产品发布的最新新闻报道。
检索基于知识的信息，例如 Figma 中的团队设计文件。
代表用户执行操作，例如创建 Contoso 票证。

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

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

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

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

先决条件

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

Teams 应用商店验证指南中概述的合规性、性能、安全性和用户体验标准。
创建或升级用于适用于 Microsoft 365 的 Copilot的消息扩展插件的指南。

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

重要

用于适用于 Microsoft 365 的 Microsoft Copilot的插件处于预览状态，仅适用于 Microsoft Teams 中的Microsoft 365 Chat。

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

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

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

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

打开 Visual Studio Code。
在左窗格中，选择“ Teams 工具包”。
选择“ 创建新应用”。
选择 “消息扩展”。
选择“自定义搜索结果”。
选择“ 开始使用机器人”。
选择编程语言。
选择“ 默认文件夹”。
输入应用的名称，然后选择 Enter。 Teams 工具包为应用搭建基架并创建消息扩展。

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

在左窗格中，选择“ Teams 工具包”。
在 “帐户”下，执行以下步骤：
1. 选择“ 登录到 Microsoft 365” 并输入 Microsoft 365 凭据。
2. 选择“ 登录到 Azure ”并输入 Azure 凭据。
在左窗格中，选择“ 运行和调试” (Ctrl+Shift+D) 。
选择 “在 Teams (Edge) 中调试”或“在 Teams (Chrome) 调试”。 Teams 工具包使用 Web 浏览器在 Teams 中启动应用。
选择“添加”。应用安装在 Teams 上。
转到聊天并选择 “操作和应用”。
在邮件扩展浮出菜单中，在搜索框中输入邮件扩展的名称。
选择邮件扩展并输入搜索查询。
从列表中选择一个产品。 Teams 在邮件撰写区域中将产品展开为自适应卡片。
选择“ 发送”。

在 M365 聊天中触发消息扩展

若要在 M365 聊天中将消息扩展作为插件触发，请执行以下步骤：

选择“应用”。
搜索 M365 聊天并打开 M365 聊天应用。
选择“ 插件”。
在插件列表中，打开消息扩展的开关。
在邮件撰写区域中，向 M365 聊天发送消息，以在 Teams 和 Copilot 中搜索 npm 包信息。例如，在 npm-searchlocal 中查找 teamsfx-react 上的 npm 包信息。

注意

此提示可能并不总是使 M365 聊天包含来自消息扩展的响应。如果发生这种情况，请尝试一些其他提示，或通过降低 M365 聊天响应并留下消息来向我们提供反馈。

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

在计算机上，选择 Windows + X 密钥。
选择“ 系统”。
在“ 关于>设备规范”下，选择“ 高级系统设置”。
在“系统属性”下，选择“环境变量”。
在 “用户变量”下，选择“ 新建”。此时会打开 “新建用户变量 ”对话框。
更新以下字段：
1. 变量名称：DEVELOP_COPILOT_PLUGIN
2. 变量值：true
选择“确定”。

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

转到 命令提示符。

输入以下命令：

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

在终端中输入 teamsfx new 。
选择 “消息扩展”。使用箭头键在选项之间切换。
选择“自定义搜索结果”。
选择“ 开始使用机器人”。
输入项目的位置，然后选择 Enter。
输入应用程序的名称，然后选择 Enter。

Teams 工具包在指定位置搭建基架并创建项目。
转到创建项目的文件夹路径，并输入以下命令，在 Azure 中预配应用：
```
 teamsfx provision --env dev
```
Teams 工具包 CLI 会打开浏览器窗口，并请求你登录到 Microsoft 帐户。
登录到你的 Microsoft 帐户。 Teams Toolkit CLI 在 Azure 上执行验证并预配应用。
从列表中选择一个订阅。
从列表中选择一个资源组。
如果收到一条消息，该消息可能会 根据使用情况产生成本。是否要使用上面列出的帐户在开发环境中预配资源？，请输入 Y。

Teams 工具包验证应用清单并在 Azure 上预配应用。
在命令提示符窗口中，输入以下命令以在 Teams 中预览应用：
```
 teamsfx preview --env dev
```
此时会打开一个新的浏览器窗口，其中包含 Teams Web 客户端。可以将应用添加到 Teams。
选择“添加”。消息扩展将添加到 Teams。
转到聊天并选择 “操作和应用”。
在邮件扩展浮出菜单中，在搜索框中输入邮件扩展的名称。
选择邮件扩展并输入搜索查询。

在 M365 聊天中触发消息扩展

若要通过 M365 聊天触发消息扩展，请执行以下步骤：

选择“应用”。
搜索 M365 聊天并打开 M365 聊天应用。
选择“ 插件”。
在插件列表中，打开应用的开关。
在邮件撰写区域中，向 M365 聊天发送消息，以在 Teams 和 Copilot 中搜索 npm 包信息。例如，在 npm-searchlocal 中查找 teamsfx-react 上的 npm 包信息。