测试插件包包含或引用的内容:技能、远程 MCP 连接器和声明性代理(如果包含)。 此 包 & 测试 任务在创建发布工件之前建立组件行为和集成。 测试 和验证插件中将进行最终的包验证、安装和发布体验检查。 为您的组件选择测试,保留 测试记录,然后完成包装 前。
选择测试
验证集成方案中的组件
| 在插件中 | 测试方式 | 部分 |
|---|---|---|
| 插件级技能,无论是否有代理 | Cowork 开发会话;支持的对话助手技能选择 | 测试技能 |
| 指向远程 MCP 服务器的插件连接器 | 检查器,然后通过 Cowork 中的插件执行相同的任务 | 测试远程 MCP 连接器 |
| 声明性代理(如果包含) | Work IQ Dev Tools 提问命令和 DevUI | 测试包含的声明性代理 |
| 解决方案使用的依赖项 | 连接器诊断,然后重复集成任务 | 测试依赖项 |
了解你正在测试的连接器
-
插件连接器: 应用清单
agentConnectors[]条目。 本文测试远程 MCP 类型:包引用服务器;它不包含正在运行的服务。 - Copilot 连接器 (同步) : 将知识引入 Microsoft Graph。 测试其作为依赖项的引入和后续检索。
- Copilot 连接器 (联合) : 检索已连接标识下的实时数据。 测试实时访问与引入。
- Power Platform 连接器:Copilot Studio 工具。 测试它并不能确定其代理是注册表插件。
插件创作参考还记录了现有 OpenAPI 自定义连接器引用的显式路由。 如果适用,请使用该路线的要求;本文中的 MCP 过程不测试该连接器类型。
如何判断结果
单独检查每个组件,然后运行一起使用这些组件的任务。 成功的直接服务调用建立服务器行为。 集成任务建立返回数据的选择、输入、身份验证和使用。
在测试之前,请为每个组件和目标体验定义所需的检查和可接受的证据。 包括组件选择、正确结果和访问边界。 使用适合索赔的证据:
| 组件或声明 | 要保留的证据 |
|---|---|
| 技能选择和行为 | 主机识别所选或加载技能的证据,以及所需的输出和文件。 在 Cowork 的侧面板中,技能标识已加载的技能。 显式选择不会建立自动调用。 |
| 远程 MCP 调用 | 经过身份验证的服务日志与主机请求相关联,标识操作、输入和结果。 直接检查器调用不会通过插件建立调用。 |
| 包含的代理 | 部署了代理标识、请求和响应,以及可用的功能选择、检索和引文诊断。 仅靠代理诊断并不能调用每个包含的技能或脚本。 |
| 技能脚本执行 | 泄露时的执行诊断。 所需的输出文件建立输出结果,而不是特定脚本运行的证明。 如果执行该脚本是发布要求,请获取证明该要求的证据。 |
- 将 响应的正确性 与 援引证据分开判断。 代理可以在不加载您的技能的情况下生成合理的发行说明。
- 缺少所需检查的证据仍未得到验证,并阻碍准备工作。 不要因为无法进行诊断而削弱所需的检查。
- 如果主机未公开其他诊断详细信息,请记录该限制,而不声明详细信息已验证。 当证据已经满足所需的检查时,不可用的诊断不是单独的障碍。
- 将无提示回退或不完整结果视为失败。
- 将经过消毒的证据保存在批准的存储中,而不是凭据。 代理快照可能包含敏感内容。
先决条件和已知测试数据
使用现有插件项目、开发租户、已知测试标识和非生产数据。 选择要支持的环境和 Microsoft 体验。 在测试前授权所需的登录、许可、连接和外部服务。
对于以下命令,请安装 Work IQ Dev Tools: Node.js CLI 需要 24.15+ 和 npm,Windows 上还需要 PowerShell 7+。
准备:
- 已知记录: 测试存储库中的问题 123,以及从源记录的确切标题、状态和 URL。
-
技能输入:
Added CSV export; Fixed duplicate rows; Updated help text.对于发行说明技能,分别需要功能、修复和其他,以及任何承诺的文件或脚本生成的内容。
替换示例名称、ID 和占位符。 在租户命令之前登录并检查就绪情况:
wiqd auth login --interactive
wiqd doctor
验证: 目标租户的登录和就绪情况检查成功。
对于可选助手提示,请安装 GitHub Copilot CLI。 如果尚未安装其 WIQD 指南插件,请运行以下命令,然后在现有插件项目中启动新会话:
copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot
验证: 清单显示已安装、启用的 WIQD 指南。 现有安装应遵循安装指南,而不是添加重复安装。 本指南插件不安装 WIQD CLI。 将助手提示粘贴到编码助手会话中;部署的代理请求改为使用-q“测试包含的声明性代理”中的选项。
测试技能
插件组件: 通过 app-manifest agentSkills注册的插件级技能。
这证明了什么: 预期技能在开发部署中加载并产生预期输出。
包装后仍有待证明: 确切的工件通过您的分发路线进行验证、安装,并在每个声明的体验中运行。
要保留的证据: 部署/版本、加载的技能、输入、输出文件和可用的远程调用日志。
使用 Copilot Cowork 进行开发部署。 如果有实际打印的安装/测试链接,请重复使用。
如果需要预配,请先检查
m365agents.yml其配置environmentFolderPath下的所选环境文件。 确认租户并有效AGENT_SCOPE;标准基架用于local个人范围和dev共享范围,但仅名称并不能证明。 批准建议的更改,然后运行:wiqd plugin provision --env "<test-environment>"验证: 预配成功并返回部署的安装/测试链接。
打开返回的链接,并使用测试标识完成安装和所需连接。 启动 Cowork 会话并使用已知输入请求发行说明。
验证: 技能显示在会话侧面板的 “技能” 下。
检查响应和“输出”、“预览”或>“下载”下的任何文件。
验证: 所有更改都会显示在预期类别中,并且承诺的文件与要求匹配。
使用此部署和已知输入,在每个受支持的体验中运行 发现和调用测试 。
验证: 发现、选择和失败行为满足该技能对该体验的要求。
个人上传的技能测试与插件不同的 agentSkills注册;代理附加技能改为在声明性代理清单中使用 agent_skills 。 已加载技能证据不会建立按脚本执行。
在 记录的生命周期中,预配在其选定范围内创建或更新租户部署,并写入环境绑定。 重复使用现有资源标识可能会影响当前用户;授权这些更改。 预配不运行单独的发布或共享命令。 安装链接不能证明注册表发布、受众可用性或已安装最终 ZIP。 继续分别通过发布 & 分发 和 提供 & 管理,包括适用的审批、安装、同意和连接。
更喜欢使用 GitHub Copilot CLI?
Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.
测试远程 MCP 连接器
插件组件:agentConnectors[] 指向远程 MCP 服务的条目。
这证明了什么: 服务器行为,然后通过开发插件进行身份验证使用。
包装后仍有待证明: 连接器声明、连接设置和运行时调用都从确切的已安装工件工作。
要保留的证据: 终结点/版本、工具架构、输入/结果、标识和相关主机/服务器记录。
将 MCP 检查器 与 Node.js 22.19.0+、受信任的可流式处理 HTTP 终结点、其身份验证详细信息和安全只读操作一起使用。
启动检查器,替换示例 URL:
$serverUrl = 'https://your-server.example/mcp' npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http验证: 身份验证完成,并显示预期的服务器标识和功能。
列出工具,选择查找操作,输入已知记录的架构定义字段,然后执行它。
验证: 架构和返回的标题、状态和 URL 与预期相匹配。
使用不存在的记录和受限标识重复此操作。
验证: 缺少记录行为是可操作的,未经授权的内容仍然无法访问。
打开开发插件的 Cowork 安装和测试链接,使用“如果需要,测试技能”中的预配步骤;仅限连接器的项目不需要技能。 完成连接设置并请求相同的记录。 如果技能应使用连接器,请通过该请求调用它。
验证: 经过身份验证的服务日志显示预期的操作和输入,并且返回的值与会话结果匹配。
仅针对处置记录(包括取消)测试任何已批准的写入操作。
验证: 已批准的更改与请求匹配,取消则源数据保持不变。
将组件配置中的终结点和身份验证引用与实际运行的内容进行比较。 遵循 连接器要求,包括适用的工具描述要求;仅靠服务器成功并不能确定主机连接就绪性。
对于本地服务,请使用其项目的命令启动它。 批准公开后,请按照创建 持久性开发隧道操作。 对于此插件连接器,请设置为 remoteMcpServer.mcpServerUrl 具有实际 MCP 路径的公共 HTTPS 终结点;通过项目的工作流更新其开发部署并重新测试。 保留应用程序身份验证,并在测试完成后停止隧道。
验证: 服务日志显示在预期终结点处经过身份验证的主机请求。
更喜欢使用 GitHub Copilot CLI?
Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.
测试包含的声明性代理
插件组件: 包含在插件项目中的可选声明性代理。
这证明了什么:代理响应和可用的选择插件、检索和引文诊断。
包装后仍有待证明: 打包的代理引用和完整的已安装插件方案适用于声明的体验。
要保留的证据: 代理/版本、请求/对话 ID、所选功能、输入和实际输出。
遵循 支持的插件项目结构。 对与该组件对应的已部署代理使用 Work IQ Dev Tools 和 DevUI 。
列出代理并运行查找:
wiqd agent list wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."验证: 所选代理和返回的值与组件和源记录匹配。
启用记录的 DevUI 预览标志,然后重复:
wiqd config flags set devui true wiqd devui start --agent "<agent-name>" wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."检查所选插件、检索、引文和原始结果。
验证:可用的诊断可确定预期功能和预期返回的数据。
如果代理具有附加技能,请检查其输出:
wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."验证: 更改和承诺的文件满足技能要求。
停止诊断服务器:
wiqd devui stop验证: 命令报告已停止或未运行。
DevUI 发布的诊断不建立按技能或按脚本调用。 单独记录输出正确性。 针对代理定义的行为测试特定于代理的指令、建议的提示和范围外请求。
更喜欢使用 GitHub Copilot CLI?
Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.
请参阅 记录的 DevUI 代理工作流。
测试依赖项
测试组件所依赖的服务和知识,然后重复集成插件任务。 这些依赖项检查不是额外的插件组件注册。
已同步的 Copilot 连接器
依赖项: 包含的代理使用的索引知识。
这证明了什么: 引入、新鲜度、权限和后续检索。
包装后仍有待证明: 安装的插件使用预期的连接并记录。
要保留的证据: 连接 ID、爬网输出、索引计数、引文和源值。
对于 GitHub 问题模板,请按照构建 第一个同步连接器以 进行先决条件、存储库配置、同意、爬网和索引检查。 对于其他实现,请使用其记录的爬网和诊断过程。
确认为包含的代理配置的连接 ID 与测试的连接匹配,并且已知记录已编制索引。
验证:连接诊断可识别预期的源和预期的索引项。
查询配置了该连接的代理,然后更新可处置问题,重新运行连接器,然后再次查询。 通过其协调路径和应用项权限的受限访问测试删除。
验证: 值、引文、更新、删除处理和访问匹配要求。
联合 Copilot 连接器
依赖项: 支持的方案中使用的 可用联合连接 。
这证明了什么: 实时检索。
包装后仍有待证明: 完整的已安装插件方案使用其预期的数据访问路径。
要保留的证据: 标识、源记录、响应/引文和可用服务日志。
在 Copilot 对话助手中,选择 ...>设置>源,查找源,选择“连接”,然后进行身份验证。
验证: 针对预期标识的连接成功。
按源名称或 ID 查询已知记录。 更新一次性记录并重复。 此外,测试受限标识。
验证: 实时更改显示,并且源权限仍然强制执行。
测试完整的用户方案
在启用所有必需组件的情况下,通过预期体验运行相同的已知任务。 例如,仅当组合工作流是解决方案的一部分时,才要求技能检索已知问题并生成发行说明。
使用预期的测试标识和输入开始新对话。
验证: 预期技能或代理处理请求。
收集 组件特定的证据。 对于远程呼叫,请将可用的主机诊断与经过身份验证的服务日志相关联。
验证: 已选择预期的组件。 在需要工具的地方,它会接收正确的输入和标识,并使用其实际输出。
将响应和文件与预期结果进行比较。
验证: 内容、引文和承诺的输出符合要求。
测试失败和边界
在缺少或模棱两可的输入、过期的身份验证、拒绝同意、受限数据、不可用的依赖项、空或格式错误、脚本故障、超时、限制和重试的情况下重复。 确认安全、可操作的失败行为和必要的确认。 在运行测试之前记录每个预期结果。
记录集成结果
每个方案和标识使用一条记录。 将其带入 包测试;在包装后填充包字段。
| 域 | Keep |
|---|---|
| Components | 版本、文件、终结点、连接引用和源版本 |
| 包 | 标识、版本、ZIP 路径和可选的 SHA256 哈希;打包前挂起 |
| 上下文 | 环境、体验/发布状态、功能标志、测试标识角色和日期 |
| 方案 | 必需的检查、可接受的证据、可重复的输入以及预期结果与实际结果 |
| 证据 | 清理后的调用日志、请求 ID、输出和报告位置 |
| 决策 | 通过、失败或未验证;所需证据差距、诊断限制、所有者和后续操作 |
包装之前
- 调用: 确认预期的功能选择和预期的输入/输出。
- 访问: 完成授权/受限访问、同意和确认检查。
- 结果和失败: 完成适用的 故障测试。
- 预期体验: 针对每个受支持的发布体验分别记录开发结果;计划最终已安装工件检查。
- 切换记录: 在打包之前保存 测试记录 并解决实现障碍。
- 包参考: 确认测试的组件版本、文件、标识符、连接引用和终结点是包将引用的版本。
相关内容
- 使用 Power Platform 连接器或 MCP 工具对代理进行 Copilot Studio 测试和活动图诊断。
- 代理生成器测试 和 附加技能测试。 这些创作测试不会建立受支持的注册表打包路由。