测试生成的精确版本控制工件 创建插件包。 在 包 & 测试中,将组件证据连接到该 ZIP,通过支持的路由安装它,并在每个声明的 Microsoft 体验中验证交付的版本、访问权限和实际运行时行为。
最后提供以下证据:“我测试了这些组件,打包了这些确切的引用,安装了这个确切的版本,运行了这些方案,并保留了这些结果。”成功的架构检查、预配命令或合理的响应不会建立该链。
开始之前
拥有:
- 完成 组件和集成测试,包括已知测试数据和预期结果。
- 候选 ZIP、其包标识/版本及其包含的组件版本、终结点和连接引用。
- 开发租户、非生产数据、包组件支持的安装路线以及使用它的权限。
- 测试允许和受限用户的标识;可用性和阻止测试的授权管理员。
- 每个目标体验所需的许可证、登录、许可、连接和外部服务。
- 每个方案和标识的 测试记录 。
在测试之前,定义所需的包、安装、访问和运行时检查以及将建立每个结果的证据。 对运行时声明使用 特定于组件的证据标准 ,以及 “确认交付版本”中所述的安装证据。
在上传包、安装包、授予许可、共享包或更改管理设置之前获得批准。 这些过程会更改租户状态;使用受控测试标识和受众。
验证架构和组件引用
打开候选 ZIP 而不对其进行修改。 读取其根目录 manifest.json、 recording id、 version和 manifestVersion。 确认:
- 清单使用路由所需的 Microsoft 365 应用清单架构 。
- 包含的代理定义和操作清单使用其适用的架构。 API 插件清单描述代理操作,而不是外部注册表插件。
- 引用的技能文件夹、配套文件、图标和工具说明存在于其声明的包路径中。
- 版本、标识符、端点和连接引用与组件测试记录和预期环境匹配。
- 不包含任何凭据、机密、日志或不相关的测试文件。
对于 Work IQ Dev Tools,请使用记录的 CLI 先决条件,包括这些 Windows 示例的 Node.js 24.15+、npm 和 PowerShell 7+。 现有项目中的可选脱机源检查是:
wiqd plugin validate --mode source --env "<test-environment>"
验证: 通过并记录适用的源检查并跳过或未发现的功能。
源模式检查保存的声明式代理诊断和基本项目防护。 它不会完全验证应用架构、技能内容、根 agentConnectors[]或引用的 API/OpenAPI 内容。 仅技能或仅连接器项目不能有适用的代理检查。 显式使用source:默认模式是包验证,而不是脱机检查。
验证确切的包
显式选择一个 ZIP 文件,而不是依赖具有多个候选项的生成目录。 在 PowerShell 中,将示例路径替换为项目:
$packageFile = (Resolve-Path '.\appPackage\build\<candidate>.zip').Path
Get-FileHash -LiteralPath $packageFile -Algorithm SHA256
验证: 解析的文件是预期的候选项。 (可选)保留 本地计算的哈希 值以检测后续更改;本地哈希无法证明主机执行了哪些字节。
在经过身份验证的验证之前,请使用预期的 Microsoft 365 标识登录:
wiqd auth login --interactive wiqd doctor验证: 对预期租户的身份验证和就绪情况检查成功。
获得批准将此 ZIP 文件上传到平台验证服务后,运行:
wiqd plugin validate --mode package --package-file "$packageFile"验证: 此确切 ZIP 文件的调查结果满足所需的检查;保留返回的不可变 JSON 和 HTML 报告。
如果发布途径需要额外的商城政策和证据检查,请运行:
wiqd plugin validate --mode marketplace --package-file "$packageFile"验证: 所需的程序包、策略和证据检查通过,并且不会缺少任何必需证据。
package并marketplace使用生成的 ZIP 文件,上传该文件,然后可能需要登录。 他们不会自动生成或登录。 还接受不带源项目的 ZIP 文件。 市场模式增加了策略和证据检查。 其报表不是官方 Microsoft Store 或合作伙伴中心批准。 遵循当前 的 WIQD 验证协定,而不是过时 deep的 、 static或 manifest 模式名称。
读取调查结果、覆盖范围、跳过的检查和所需证据,而不仅仅是命令的退出结果。 对于受支持的 Agents Toolkit 程序包路由,请使用验证规则或atk validate --app-package-file-path <path>在验证应用中所述使用验证应用包。
如果 ZIP 文件中有任何更改,请创建一个新的候选项并重复验证。 即使 ZIP 文件未更改,远程服务更改也需要相关的运行时重新测试。
安装或旁加载包
使用接受本机 Microsoft 365 应用包并支持其组件的路由。 WIQD 预配安装和测试链接标识部署;打开它不会确定已安装最终验证的 ZIP。
个人精确 ZIP 安装
当支持该包和目标体验时,请按照 Cowork 个人旁加载过程进行 CLI 安装、身份验证和包安装。 传递在 验证确切包 中选择的确切文件,用作 $packageFile 的值 --file-path 和 Personal 作为作用域。
验证: 目标帐户的安装成功。 将返回的 TitleId 与 AppId 包标识/版本和安装程序输出一起保存。 在受支持的体验中,请确认已安装的插件公开了预期的组件和标识,并且所需的连接已完成。
如果策略禁用个人路由或候选路由不受支持,请使用已批准的兼容路由,而不是更改安全控制。
Cowork 包上传
对于受支持的 Cowork 包,请按照上传插件包及其共享指南进行操作。 选择精确验证的本机 Microsoft 365 ZIP 文件,并限制对测试标识或显式授权的测试受众的访问。 按照将插件与 Cowork 配合使用来启用插件并在新对话中完成所需的连接。
验证: 所选文件和显示的插件标识与候选记录匹配。 针对预期标识安装插件,显示预期技能和连接器状态,并且受保护的操作使用预期的连接帐户。
可以自动转换外语格式上传。 此类转换并不能证明原始 Microsoft 365 ZIP 经过了未更改的测试。 如果路由转换了工件和验证证据,请重新建立工件和验证证据。
确认已交付版本
保留安装记录,该记录将确切的所选 ZIP 及其清单 id 链接 version 到成功安装、预期帐户和返回的安装标识。 对于记录的个人旁加载路由,保留命令及其解析的文件路径、候选的清单元数据以及包含 TitleId 和 AppId的安装程序输出。 对于受支持的本机 Cowork 上传,请保留所选文件和成功上传/安装记录以及显示的插件标识和测试帐户。
使用该链作为被测试候选产品的安装证据。 将主机或管理路由公开的任何版本元数据与候选版本相关联,并在测试前调查不匹配情况。 将安装证据与调用分开记录。
引用的个人安装步骤未记录通用已安装版本查询或服务器端包哈希。 此过程两者都不需要:安装记录确定提交并成功安装了哪个候选文件,而不是对主机执行的字节进行独立验证。 如果发布条件需要独立的主机端版本或字节验证,请获取该证据;它的缺失仍然是 未经证实 的,并阻止了该发布声明。 预配链接、插件名称、成功响应或本地哈希本身不会建立安装链。
对于管理员管理的候选对象,请遵循当前 注册表上传和安装过程,确定测试用户的范围,并保留接受的工件和安装记录。 如果路由接受不同的工件类型或无法建立与已验证 ZIP 的关系,请将工件绑定检查视为未验证,而不是等效。
测试打包的插件
使用已安装的候选部署(而不是早期开发部署)重复 完整的集成方案 :
在每个声明的体验中开始新对话。 使用与组件测试相同的标识角色、已知记录、输入和预期结果。
验证: 选择预期安装的组件。
收集 组件特定的证据。 对于远程调用,请将经过身份验证的服务日志与请求、输入和返回的数据相关联。
验证: 主机证据在适用的情况下标识所选或加载的技能。 所需的工具调用具有相关的调用证据,它们返回的数据有助于响应。
检查输出文件和引文。 重复适用的 故障和边界情况。
验证: 正确性、访问边界、批准和失败行为符合预定义的标准。
对于发行说明技能,请重用 Added CSV export; Fixed duplicate rows; Updated help text. 检查功能、修复、其他和承诺的文件。 对于 MCP 查找,请将已知问题的确切标题、状态和 URL 与服务日志进行比较。 使用 特定于组件的证据工具;代理诊断路由本身无法确定独立安装的插件是否已运行。
将正确性和调用结果分开。 缺失的所需检查证据仍未得到验证。 将不可用的其他诊断记录为限制,而不是验证的执行详细信息或自动失败。 在 对话助手和 Cowork 中分别重复进行发现、连接、选择和运行时测试,同时声明这两项测试。
测试身份验证和访问
让授权管理员通过“ 为用户设置插件可用性 ”和“管理 插件、技能和 MCP 服务器”来准备受控测试设置。 记录原始设置并在批准测试后恢复它们。 使用相同的无害查找或插件支持的等效场景。 对于不适用的检查,例如仅技能方案中的服务同意,请记录原因,而不是添加功能。
| 测试 | 设置和操作 | 预期结果 |
|---|---|---|
| 允许的用户 | 在批准的受众中包含测试标识。 以该用户身份登录并完成所需的许可/连接。 | 受支持的方案在该用户的源权限内成功;调用证据标识预期的功能。 |
| 受限用户 | 将可用性限制为批准的受众,然后使用该受众之外的帐户进行测试。 | 用户无法使用该插件。 在 Copilot 频道中,列表可以保持可发现状态为已阻止;符合条件的用户可以请求访问权限。 仅凭可见性并不是失败。 |
| 拒绝同意 | 使用没有现有授权的测试标识/连接。 拒绝操作所需的同意并重试受保护的查找。 | 该操作未获得请求的受保护访问权限。 记录登录/同意错误,并确保没有受保护的结果显示为成功。 不相关的允许功能仍然有效。 |
| 阻止和取消阻止 | 让管理员关注 阻止候选人的 插件或技能 。 使用之前允许的用户重复请求,然后让管理员为插件选择 “取消阻止 ”,然后再次重复该请求。 | 被阻止时,无法使用插件和依赖代理。 关联的 MCP 服务器/连接器仍然可用于其他插件。 解封后,之前允许的用户可以再次使用该插件,但须遵守原来的可用性、权限和连接要求。 |
发布者类别限制 是单独的控件。 如果测试一个,请记录类别及其策略结果;不要仅仅为了测试一个候选人而更改组织范围的设置。 测试登录续订/重新连接、源权限和缺少的连接(如果适用)。
对于 Microsoft Entra 授权代码身份验证,拒绝同意将返回授权错误;请使用实际提供程序错误,而不是期望每台主机中都出现相同的措辞。
测试支持的体验
记录每个体验、标识角色和场景的结果,包括安装和交付版本证据。 Cowork 中的通行证不会在 对话助手或其他主机中建立通行证。 对每个都使用支持的路由;未解决的安装或版本证据阻止针对该体验进行授权声明。
记录代理质量结果
如果包含代理,并且您的发布标准需要质量评估,请评估相应的部署版本,并将其结果链接到候选记录。 从 代理评估概述开始。 质量评分不能取代程序包、安装版本、访问或调用证据。
对候选项重复回归检验
针对已安装的候选对象重新运行记录的基线方案、访问测试、故障案例以及任何所需的代理评估。 添加特定于变更的案例而不删除基线。 保留两组 测试记录,比较结果,并在批准前解决回归或所需的 未验证检查 。
对于基线准备和更新生命周期(包括发布、推出、替换和回退决策),请遵循 监视、更新和停用插件或代理。 不要假定自动升级、保留分配或特定的重新同意触发器。 推出后,重复传递版本和运行时验证。
确定发布就绪情况
使用包标识和版本、确切的 ZIP 文件和可选哈希、组件版本和终结点、环境、测试标识角色、方案、预期和实际结果、净化的调用证据、状态和所有者完成共享 测试记录 。 附加验证报告以及安装和版本证据。
分配一个结果:
- 就绪 - 确切的候选人通过了所有必需的检查,证据完整,没有未解决的发布障碍。
- 已阻止 - 所需的检查失败或仍未验证,包括项目绑定、传递的版本、访问或调用。
- 准备就绪但有限制 - 已通过所需检查;其余非阻塞限制已记录、接受并适合披露。
应用测试前定义的必需检查和证据标准。 公认的诊断限制不能将缺失的必需证据变成通过;当所需的检查已经有足够的证据时,额外的诊断不是强制性的。 对于每个阻塞程序,记录所有者和解决方案。 在工件更改时创建新的候选项,重新安装它,然后重复受影响的测试和回归测试。
相关内容
后续步骤
完成所需证据后,继续 发布 & 分发: