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

重要

MCP 和 API 插件在 声明性代理中提供操作。 它们不是独立的可安装插件包:只有包含的代理才能访问它们的功能和工具。 有关包和操作清单关系的信息,请参阅 插件和声明性代理操作。

提示

受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。

API 插件允许 声明性代理调用 REST API。 使用 Microsoft 365 代理工具包 生成代理项目、API 插件清单和 REST API 实现作为起点。

创建代理和 API

注意

本文中的屏幕截图和用户界面引用使用 Microsoft 365 Agents Toolkit 的发行版。 预发布版本可能与显示的用户界面不同。

  1. 打开 Visual Studio Code。 如果尚未安装 Agents Toolkit,请参阅 安装 Agents Toolkit 了解安装说明。

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

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

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

  4. 选择 声明式代理。

  5. 选择 “添加操作”,然后选择“ 使用新 API 开始”。

  6. 选择 OAuth 作为 身份验证类型。

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

  8. 为代理项目选择一个位置。

  9. 输入 Repairs Agent 作为代理项目的名称。

完成这些步骤后,Agents Toolkit 将生成代理和 API 项目文件,包括 API 插件清单,并在新的 Visual Studio Code 窗口中打开该项目。 有关详细信息,请参阅生成项目根目录中的 README.md 文件。

运行 API 并旁加载代理

  1. 在加载了代理项目的 Visual Studio Code 窗口中,选择左侧“活动栏”中的 Microsoft 365 Agents Toolkit 图标。

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

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

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

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

Agents Toolkit 生成项目,创建包含代理及其 API 插件配置的应用包,并为用户帐户旁加载代理。 它还会在本地启动 API。 新的浏览器窗口将打开,进入 Microsoft Teams 应用。

测试代理的 API 操作

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

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

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

此时,REST API 正在开发计算机上本地运行,无需身份验证。 若要添加身份验证,请将 API 部署到 Azure。

部署到 Azure 并启用身份验证

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

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

  3. 当要求提供资源组名称时,请接受默认值或根据需要更改它,然后按 Enter。

  4. 为资源组选择位置。

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

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

完成这些步骤后,即可将 REST API 部署为具有身份验证的 Azure 函数。 代理通过其 API 插件配置调用托管的 API。

使用经过身份验证的 API 测试代理

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

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

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