提示
受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。
本指南将介绍如何使用 智能 智能 Microsoft 365 Copilot 副驾驶® 工具包添加用于将代理连接到服务器的 MCP 插件,将服务与智能 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 的声明性代理集成。 通过执行这些步骤,即可为业务用户启用对 MCP 公开服务的对话式 AI 支持访问。
本演练使用 MCP 插件创建声明性代理。 插件清单将代理连接到远程 MCP 服务器;它不打包或托管正在运行的服务器。
本演练介绍声明式代理操作路由。 若要改为在插件包级别连接服务器,请参阅 在应用清单中配置远程 MCP 服务器。 有关这两个清单模型的关系,请参阅 插件和声明式代理操作。 使用目标体验支持的路由。
本演练以 GitHub MCP 服务器 为例。 GitHub MCP 服务器是远程 MCP 服务器,由 GitHub 提供和维护,它公开用于处理存储库、问题、拉取请求和其他 GitHub 功能的工具。 此处使用它来构建可从自然语言提示搜索 GitHub 存储库和用户的代理。 可对自己的 MCP 服务器执行相同的步骤。
分四个步骤构建和测试该功能:创建用于身份验证的 OAuth 客户端、创建代理、预配和旁加载它以供开发,以及使用代理。
先决条件
开始之前,请确保满足以下先决条件:
- Copilot 可扩展性选项的要求中指定的要求
- Visual Studio Code
- Microsoft 365 Agents Toolkit 版本 6.12.0 或更高版本
若要完成本演练中的 GitHub 示例,还需要一个 GitHub 帐户。 从您自己的 MCP 服务器生成插件不需要 GitHub 帐户。
步骤 1:创建用于身份验证的 OAuth 客户端
GitHub MCP 服务器要求每个用户在返回数据之前登录,因此插件需要 OAuth 客户端。 在本指南中, 将 OAuth (与静态注册) 一起使用 。 创建代理并选择此身份验证类型时,Agents Toolkit 会立即提示输入这些值,因此请先创建客户端。 然后,每次代理调用 MCP 服务器时,Copilot 都会使用注册代表已登录用户获取访问令牌。
提示
如果 MCP 服务器支持 OAuth 2.0 动态客户端注册 (DCR) ,则可以跳过此部分。 创建代理时,选择 OAuth (和动态注册) 作为 身份验证类型。 MCP 服务器在运行时注册客户端,因此不需要客户端 ID 或密码。 Agents Toolkit 会为您将注册写入插件清单。
若要创建 OAuth 客户端:
https://github.com/settings/developers转到浏览器中的 。 选择 OAuth 应用>新建 OAuth 应用。
为应用添加名称和主页 URL,并设置为
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect授权回调 URL。 选择 “注册应用程序”。创建应用后,选择 “生成新的客户端密码”。 复制要在创建代理时输入的 密钥和客户端 ID 。
注意
这些步骤特定于 GitHub。 对于你自己的 MCP 服务器,请使用服务器使用的标识提供程序创建一个 OAuth 客户端,并将其设置为 https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect 重定向 (回调) URL。 创建代理并选择 具有静态注册) 的 OAuth (时,Agents Toolkit 会提示您输入客户端 ID、客户端密码和可选范围。 如果 MCP 服务器支持 (DCR) 动态客户端注册,则可以改为选择 具有动态注册) 的 OAuth (,MCP 服务器将在运行时注册客户端 - 无需手动创建客户端、客户端 ID 或机密。 如果 MCP 服务器使用单一登录 (SSO) 而不是 OAuth Microsoft Entra请选择“Entra SSO”,Agents Toolkit 将提示你改为输入 Microsoft Entra 应用客户端 ID。 在任何一种情况下,Agents Toolkit 都会为你更新插件清单。 有关每个选项的详细信息,请参阅 在代理中为 MCP 和 API 插件配置身份验证。
步骤 2:创建代理
若要创建代理,请执行以下操作:
打开 Visual Studio Code,然后在“活动栏”中选择 Microsoft 365 Agents Toolkit 图标。
在 Agents Toolkit 任务窗格中选择“ 创建新代理/应用 ”。
选择 声明式代理。
选择“ 添加操作”,然后选择“ 使用 MCP 服务器启动”。
输入 GitHub MCP 服务器 URL
https://api.githubcopilot.com/mcp/。
选择身份验证类型。 对于本练习,请选择 OAuth (with static registration) 。
出现提示时,请从注册的 OAuth 应用中输入 客户端 ID ,然后输入 客户端密码。
当系统提示输入范围时,按 Enter 继续。
为代理项目选择一个位置。
输入代理的名称。
完成这些步骤后,Agents Toolkit 将为代理生成所需的文件,并打开一个新的 Visual Studio Code 窗口,其中加载了代理项目。
Agents Toolkit 配置生成的插件清单 (动态工具发现) ai-plugin.json ,以便代理在运行时解析 MCP 服务器的工具(包括返回 UI 小组件 (MCP 应用) 的任何工具),并且您无需手动添加工具。 若要改为固定一组固定的特选工具,请参阅 使用 Agents Toolkit 配置固定工具。
步骤 3:预配和旁加载用于开发的代理
在开发租户中预配和旁加载代理:
在“代理工具包 帐户” 窗格中,选择“ 登录到 Microsoft 365”。 (如果已登录,请继续执行下一步) 。
确认 Microsoft 365 帐户下会显示“ 已启用自定义应用上传 ”和“ 已启用 Copilot 访问” 。 如果没有,请咨询组织管理员检查。有关详细信息,请参阅 Copilot 扩展性选项的要求。
在 “生命周期 ”窗格中,选择 “预配”。
阅读对话框中的消息,然后选择 “确认” 以继续。
等待工具包报告已完成预配。
注意
Work IQ 开发工具 — 对于声明式代理项目,请与 wiqd agent add action --mcp-server-url <https-endpoint> 服务器所需的身份验证选项一起使用。 用于 wiqd agent validate --mode source 脱机源检查。 在需要时预配所选环境以解析程序包标识,然后以相同的--env值运行wiqd agent package。 单独 wiqd plugin add connector 的命令将远程连接器添加到独立插件项目,而不是声明代理项目的操作。 有关当前选项,请参阅 WIQD 命令参考。
步骤 4:使用代理
若要使用代理:
在浏览器中,转到 https://m365.cloud.microsoft/chat。
在边栏的 代理 部分中,找到您的代理。 它列为你在 步骤 2:创建代理中提供的名称,并在
dev末尾附加。 选择代理。要求代理查找存储库或用户。 例如,
can you find a repo for kiota?.出现提示时,选择登录到 {agent-name}。 在弹出窗口中,使用您的 GitHub 帐户登录并授权代理。
当弹出窗口关闭时,代理会返回响应。
如果代理调用的工具 (MCP 应用) 返回 UI 小组件,请确认代理在响应中内联呈现该小组件。 有关详细信息,请参阅将 MCP 应用添加到智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的声明性代理。
后续步骤
测试代理及其 MCP 操作后,如果要在插件包中包含代理,请按照打包插件进行 操作 。