创建要测试和发布的精确版本控制插件包。 此步骤是在插件的组件在预期的开发或测试环境中协同工作之后进行的。
重要
.zip文件不会自动成为受支持的插件包。 仅当支持插件的组件和要发布的 Microsoft 365 体验时,才使用打包路由。
本文介绍记录的 Copilot Cowork 插件工作流使用的 Microsoft 365 应用包。 一些工具会为你创建包;其他工作流允许你手动组装它。 使用所选产品的指南了解支持的组件、清单版本和发布路线。 共享包格式并不能保证每个产品都支持相同的功能。
远程 MCP 服务器、API 和其他连接的服务单独运行。 该包包括连接到它们所需的受支持声明或引用,而不是正在运行的服务。
开始之前
完成 集成测试。 确认:
- 您可以单独生成并一起测试组件。
- 你配置了依赖项、身份验证、权限、连接、终结点和外部服务。
- 你知道插件必须支持哪些 Microsoft 365 体验。
- 您记录了组件版本、已知限制和未解决的问题。
不要使用打包来解决未完成的组件或集成。 返回到生成或在所需组件不起作用时 重复使用 。
了解 Microsoft 365 应用包
包是一个 ZIP 文件, manifest.json 其根目录处有引用的图标。
Microsoft 365 应用清单架构定义其标识、元数据和功能声明。
| 程序包内容 | 用途 |
|---|---|
manifest.json |
标识应用、版本、开发人员、名称、说明、图标和支持的功能。 |
| 图标 | 应用清单引用的颜色和轮廓图像文件。 Cowork 工作流文档 color.png 和 outline.png. |
| 代理技能 | 包含后,技能文件夹包含 SKILL.md 且支持配套文件。 应用清单通过 agentSkills引用文件夹。 |
| 远程连接器配置 | 包含后, agentConnectors 应用清单中的条目将标识远程 MCP 终结点和适用的授权配置。 服务器本身未打包。 |
| 引用的组件文件 | 包括所选组件所需的文件,例如连接器配置引用工具描述文件时的工具描述文件,或受支持的代理包中的代理定义。 |
例如,Cowork 文档显示具有以下布局的包:
manifest.json
color.png
outline.png
skills/
contract-analysis/
SKILL.md
references/
clause-taxonomy.md
tools/
contoso-legal-tools.json
仅当插件包含技能时,技能文件夹才会出现。 仅当连接器配置引用时,才需要工具说明文件。 按照为 Copilot Cowork 生成插件了解当前文件、架构版本、图标和技能要求,而不是将示例视为每个产品的模板。
注意
插件清单架构 2.4 描述声明性代理的 API 或 MCP 操作组件,而不是外部 Microsoft 365 应用包。 这些操作仅对包含的代理可用。 对外部包使用应用清单架构。
选择受支持的打包路径
| 插件包路由 | 创建包 | 结果 |
|---|---|---|
| 针对受支持的方案,Work IQ Dev Tools 插件项目 (推荐的专业代码路由) | 按照所选环境的记录的源验证和预配步骤操作,然后运行 wiqd plugin package。 请参阅 使用 Work IQ Dev Tools 构建插件。 |
在共享或发布之前进行验证的版本控制应用包。 |
| 当所选工作流支持插件的组件和目标体验时,使用 Microsoft 365 Agents Toolkit 生成的插件包 | 选择 Zip Teams 应用包 或使用 teamsApp/zipAppPackage 生命周期操作。 请参阅 在 Agents Toolkit 中自定义应用清单。 |
由支持的工作流生成的插件包。 |
| 手动组装的 Cowork 插件包 | 按照为 Copilot Cowork 生成插件中的清单、技能、连接器、图标和 ZIP 布局说明进行操作。 | 用于记录的 Cowork 路线的 Microsoft 365 应用包。 |
如果没有打包路由支持插件的组件和目标体验,请停止。 选择支持的方法或修改插件。 请勿合并或重命名项目来创建不受支持的包。
对于直接在 Copilot 对话助手中使用的技能,请通过应用清单的agentSkills属性打包插件级技能。 这与声明性代理清单的 agent_skills 属性不同。 对话助手接受的独立SKILL.md或技能 ZIP 不是完整的插件应用程序包。 请参阅 在插件中打包技能。
若要自动执行 WIQD 源代码检查、候选打包和包优先验证,请参阅 使用 Work IQ Dev Tools 配置插件 CI/CD。
注意
WIQD 源验证不是对生成包的完整验证。 使用 “测试和验证插件”中的当前包验证过程,在打包后验证确切的 ZIP。
标识包及其依赖项
在组装发布工件之前,请选择预期的 发布和分发路线 。 对于每个路由,请确定:
- 标识: 应用 ID、包版本和组件标识符。
- 元数据: 名称、说明、开发者信息、图标以及适用的隐私和条款链接。
- 身份验证: 身份模型、支持的授权配置、权限和同意需求以及凭据引用。
- 连接: 终结点、连接引用和特定于环境的配置。
- 外部依赖项: 程序包外部所需的远程服务、数据源、所有者和设置。
仅将架构支持的声明和引用放在包中。 将操作详细信息保留在发布就绪记录中,不要包含凭据或机密。
| 分发路由 | 此包的确认内容 |
|---|---|
| 直接共享以进行测试 | 所选受众、测试环境、程序包标识和元数据,以及这些测试人员所需的身份验证、连接和外部服务。 |
| 组织分布 | 用于管理员审核的程序包标识和元数据,以及组织中所需的身份验证、连接、权限和外部服务设置。 |
| 公共分发 | 所选提交路由的包标识和元数据,以及身份验证、连接和客户组织和用户必须配置的外部依赖项。 |
共享或发布包不会完成安装、分配、同意或连接设置。 遵循所选路线的当前要求;本文不定义提交协定。
创建包
- 打开所选插件路由的打包过程。
- 选择预期环境和测试的确切组件版本。
- 运行记录的命令、UI 操作或自动化工作流。
- 记录工件名称、位置、版本、环境和工具版本。
检查生成的工件
检查:
- 插件标识和包版本正确。
- 该包包含预期的清单、元数据、配置和资产。
- 组件声明、文件、标识符、终结点和服务引用与你测试的版本匹配。
- 该包使用预期的环境配置。
- 身份验证、权限、同意和连接要求在没有凭据、令牌或机密的情况下声明。
- 该包不包含临时文件、日志、测试数据或不相关的项目。
记录发布准备情况
将发布就绪情况记录引入 测试和验证,并在发布前完成它。 记录:
- 包或工件标识和确切版本。
- 组件、远程服务和外部引用。
- 打包工具和预期发布方法。
- 经过测试的 Microsoft 365 体验和环境。
- 身份验证、权限、同意和连接要求。
- 验证证据和结果。
- 已知限制、不受支持的组合和接受的风险。
- 版本所有者和验证日期。