一起测试插件组件

测试插件包包含或引用的内容:技能、远程 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 进行开发部署。 如果有实际打印的安装/测试链接,请重复使用。

  1. 如果需要预配,请先检查 m365agents.yml 其配置 environmentFolderPath 下的所选环境文件。 确认租户并有效 AGENT_SCOPE;标准基架用于 local 个人范围和 dev 共享范围,但仅名称并不能证明。 批准建议的更改,然后运行:

    wiqd plugin provision --env "<test-environment>"
    

    验证: 预配成功并返回部署的安装/测试链接。

  2. 打开返回的链接,并使用测试标识完成安装和所需连接。 启动 Cowork 会话并使用已知输入请求发行说明。

    验证: 技能显示在会话侧面板的 “技能” 下。

  3. 检查响应和“输出”、“预览”或>“下载”下的任何文件。

    验证: 所有更改都会显示在预期类别中,并且承诺的文件与要求匹配。

  4. 使用此部署和已知输入,在每个受支持的体验中运行 发现和调用测试 。

    验证: 发现、选择和失败行为满足该技能对该体验的要求。

个人上传的技能测试与插件不同的 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 终结点、其身份验证详细信息和安全只读操作一起使用。

  1. 启动检查器,替换示例 URL:

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    验证: 身份验证完成,并显示预期的服务器标识和功能。

  2. 列出工具,选择查找操作,输入已知记录的架构定义字段,然后执行它。

    验证: 架构和返回的标题、状态和 URL 与预期相匹配。

  3. 使用不存在的记录和受限标识重复此操作。

    验证: 缺少记录行为是可操作的,未经授权的内容仍然无法访问。

  4. 打开开发插件的 Cowork 安装和测试链接,使用“如果需要,测试技能”中的预配步骤;仅限连接器的项目不需要技能。 完成连接设置并请求相同的记录。 如果技能应使用连接器,请通过该请求调用它。

    验证: 经过身份验证的服务日志显示预期的操作和输入,并且返回的值与会话结果匹配。

  5. 仅针对处置记录(包括取消)测试任何已批准的写入操作。

    验证: 已批准的更改与请求匹配,取消则源数据保持不变。

将组件配置中的终结点和身份验证引用与实际运行的内容进行比较。 遵循 连接器要求,包括适用的工具描述要求;仅靠服务器成功并不能确定主机连接就绪性。

对于本地服务,请使用其项目的命令启动它。 批准公开后,请按照创建 持久性开发隧道操作。 对于此插件连接器,请设置为 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 。

  1. 列出代理并运行查找:

    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."
    

    验证: 所选代理和返回的值与组件和源记录匹配。

  2. 启用记录的 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."
    

    检查所选插件、检索、引文和原始结果。

    验证:可用的诊断可确定预期功能和预期返回的数据。

  3. 如果代理具有附加技能,请检查其输出:

    wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."
    

    验证: 更改和承诺的文件满足技能要求。

  4. 停止诊断服务器:

    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 问题模板,请按照构建 第一个同步连接器以 进行先决条件、存储库配置、同意、爬网和索引检查。 对于其他实现,请使用其记录的爬网和诊断过程。

  1. 确认为包含的代理配置的连接 ID 与测试的连接匹配,并且已知记录已编制索引。

    验证:连接诊断可识别预期的源和预期的索引项。

  2. 查询配置了该连接的代理,然后更新可处置问题,重新运行连接器,然后再次查询。 通过其协调路径和应用项权限的受限访问测试删除。

    验证: 值、引文、更新、删除处理和访问匹配要求。

联合 Copilot 连接器

依赖项: 支持的方案中使用的 可用联合连接 。

这证明了什么: 实时检索。

包装后仍有待证明: 完整的已安装插件方案使用其预期的数据访问路径。

要保留的证据: 标识、源记录、响应/引文和可用服务日志。

  1. 在 Copilot 对话助手中,选择 ...>设置>源,查找源,选择“连接”,然后进行身份验证。

    验证: 针对预期标识的连接成功。

  2. 按源名称或 ID 查询已知记录。 更新一次性记录并重复。 此外,测试受限标识。

    验证: 实时更改显示,并且源权限仍然强制执行。

测试完整的用户方案

在启用所有必需组件的情况下,通过预期体验运行相同的已知任务。 例如,仅当组合工作流是解决方案的一部分时,才要求技能检索已知问题并生成发行说明。

  1. 使用预期的测试标识和输入开始新对话。

    验证: 预期技能或代理处理请求。

  2. 收集 组件特定的证据。 对于远程呼叫,请将可用的主机诊断与经过身份验证的服务日志相关联。

    验证: 已选择预期的组件。 在需要工具的地方,它会接收正确的输入和标识,并使用其实际输出。

  3. 将响应和文件与预期结果进行比较。

    验证: 内容、引文和承诺的输出符合要求。

测试失败和边界

在缺少或模棱两可的输入、过期的身份验证、拒绝同意、受限数据、不可用的依赖项、空或格式错误、脚本故障、超时、限制和重试的情况下重复。 确认安全、可操作的失败行为和必要的确认。 在运行测试之前记录每个预期结果。

记录集成结果

每个方案和标识使用一条记录。 将其带入 包测试;在包装后填充包字段。

域 Keep
Components 版本、文件、终结点、连接引用和源版本
包 标识、版本、ZIP 路径和可选的 SHA256 哈希;打包前挂起
上下文 环境、体验/发布状态、功能标志、测试标识角色和日期
方案 必需的检查、可接受的证据、可重复的输入以及预期结果与实际结果
证据 清理后的调用日志、请求 ID、输出和报告位置
决策 通过、失败或未验证;所需证据差距、诊断限制、所有者和后续操作

包装之前

  • 调用: 确认预期的功能选择和预期的输入/输出。
  • 访问: 完成授权/受限访问、同意和确认检查。
  • 结果和失败: 完成适用的 故障测试。
  • 预期体验: 针对每个受支持的发布体验分别记录开发结果;计划最终已安装工件检查。
  • 切换记录: 在打包之前保存 测试记录 并解决实现障碍。
  • 包参考: 确认测试的组件版本、文件、标识符、连接引用和终结点是包将引用的版本。

后续步骤

继续 包 & 测试: 创建插件包,然后使用相同的证据记录和确切的打包引用验证 和测试 包。