使用适用于 智能 Microsoft 365 Copilot 副驾驶® 的新 API 生成 API 插件

重要

API 插件仅支持作为 声明性代理中的作。 智能 Microsoft 365 Copilot 副驾驶®中未启用它们。

API 插件将 REST API 连接到智能 Microsoft 365 Copilot 副驾驶®。 可以使用 Microsoft 365 代理工具包 (Teams 工具包) 的演变 ,以快速生成插件和相应的 REST API,以便将其用作插件开发的起点。

创建插件和 API

注意

Microsoft 365 Agents Toolkit 的屏幕截图和对用户界面的引用 (本文档中 Teams 工具包) 的演变是 使用最新版本 6.0 生成的。 代理工具包的预发行版本可能与本文档中的用户界面不同。

  1. 打开 Visual Studio Code。 如果尚未安装代理工具包,请参阅 安装代理工具包 以获取安装说明。

  2. 选择左侧活动栏中 的“Microsoft 365 代理工具包 ”图标。

  3. 在“代理工具包”任务窗格中 选择“创建新代理/应用 ”。

    代理工具包界面的屏幕截图

  4. 选择“ 声明性代理”。

  5. 选择“ 添加作”,然后选择“ 使用新 API 启动”。

  6. 对于“身份验证类型”,请选择“OAuth”。

  7. 选择首选编程语言:JavaScript 或 TypeScript。 本指南假定使用 TypeScript。

  8. 选择 API 插件项目的位置。

  9. 输入 Repairs Agent 作为插件项目的名称。

完成这些步骤后,Agents Toolkit 将生成插件所需的文件,并打开加载插件项目的新Visual Studio Code窗口。 有关项目的详细信息,请参阅生成的项目的根目录中的 README.md 文件。

运行插件

  1. 在加载插件项目的Visual Studio Code窗口中,选择左侧活动栏中的“Microsoft 365 代理工具包”图标。

  2. 在“ 帐户 ”窗格中,选择“ 登录到 Microsoft 365”。 (如果已登录,请继续执行下一步) 。

  3. 确认“ 已启用自定义应用上传”“已启用 Copilot 访问” 显示在 Microsoft 365 帐户下。 如果没有,请与组织管理员检查。有关详细信息,请参阅 Copilot 扩展性选项的要求

  4. 选择左侧活动栏中的 “运行和调试” 图标。

  5. 选择“ 在 Copilot (Edge) 中调试”或“ 在 Copilot (Chrome) 中调试 ”,然后按 F5 开始调试。

代理工具包生成项目,创建插件包,并为用户帐户旁加载它。 完成后,将打开一个新的浏览器窗口,显示Microsoft Teams 应用。

测试插件

  1. 在浏览器中Microsoft Teams 中,选择“ Copilot”。

  2. 在右侧的“代理”列表中选择“ 修复代理” “本地”。 如果列表不可用,请选择右上角的 Copilot 聊天和更多 图标。

  3. 向 Copilot 发送有关维修的消息。 例如,请尝试 Which repairs are assigned to Karin?

此时,插件在开发计算机上本地运行,无需身份验证。 若要添加身份验证,请将解决方案部署到 Azure。

部署到 Azure 并启用身份验证

  1. 选择左侧活动栏中 的“Microsoft 365 代理工具包 ”图标。

  2. 在“ 生命周期 ”窗格中,选择“ 预配”。

  3. 当系统询问资源组名称时,请接受默认值或根据需要进行更改,然后按 Enter

  4. 选择资源组的位置。

  5. 查看对话框中的消息。 如果一切正常,请选择“ 预配 ”以继续。

  6. 等待预配步骤完成,然后在“生命周期”窗格中选择“部署”。

完成这些步骤后,插件将部署为具有身份验证的 Azure 函数。

使用身份验证测试插件

  1. 在浏览器中Microsoft Teams 中,选择“ Copilot”。

  2. 在右侧 的“代理 ”列表中选择“修复代理”“代理” 。

  3. 向 Copilot 发送有关维修的消息。 例如,请尝试 Which repairs are assigned to Issac?