监视、更新和停用插件或代理

使用监控、反馈和支持证据来决定是修复、更新、移交还是停用插件或代理。 在发布之前测试更改,并与目标用户一起验证结果。

生成器维护和测试解决方案。 Microsoft 365 管理员在需要时完成组织推出和访问操作。 服务所有者维护其使用的连接器、远程 MCP 服务器、标识和外部服务。 这些职责不会自动同时转移。

选择任务

将该部分用于需要执行的操作。 监视、支持、移交和停用不需要遵循更新工作流。

要执行的操作 开始于
查看采用、反馈或任务结果 监视使用情况和任务结果
调查用户问题 支持用户并调查问题
更改并发布解决方案 更新插件或代理
转移维护职责 移交所有权和支持
结束分发或访问 停用插件或代理

开始之前

识别:

  • 当前插件或代理标识和版本。
  • 受影响的用户和 Microsoft 365 体验。
  • 负责任务以及涉及的任何连接或服务的所有者。

对于独立代理,请使用其创作产品支持的监控和发布过程。 不要假定插件包过程适用于它。

监视使用情况和任务结果

选择报告周期、版本、受众和代表任务。 对拥有活动的产品使用监视体验。

监视的内容 从哪里开始 需要记住的范围
代理生成器中内置的代理 在代理生成器中监视代理 代理的 “监视器 ”选项卡涵盖其使用情况和反馈。 反馈可见性具有单独的先决条件。
使用标准工具的 Copilot Studio 代理 在 Copilot Studio 中监视代理性能 使用该代理支持的分析;不要假设在代理生成器或其他构建路径中存在相同的报告。
插件访问、用户任务和故障 监视插件 检查程序包可用性、代表性任务结果、用户反馈和支持案例。
Microsoft 365 使用情况和审核活动 选择要检查的内容 对每个报表涵盖的活动使用。 审核事件不会确定任务是否成功或响应正确。
连接器或远程 MCP 服务 调查故障 和服务的监视指南 与服务所有者一起检查连接状态、源权限、终结点运行状况、日志和错误。 包可用性不能证明运行时运行状况。

不要假定遥测或报告覆盖范围跨插件和代理生成路径共享。 包含的代理报告涵盖该代理,不一定是插件中的所有功能。

记录采用率、任务成功、响应质量、登录或工具故障方面的变化,并在现有证据支持这些结论的情况下提供支持量。 比较代表性任务和用户反馈以及使用计数。

支持用户并调查问题

对于每个问题,捕获受影响的版本、产品、受众、预期结果、观察到的结果和相关错误详细信息。 分配所有者和下一步操作。

  • 请求管理员调查可用性、安装、策略或待处理的访问请求。
  • 要求构建者或代理所有者调查说明、知识、工具选择或回归。
  • 要求标识、连接或服务所有者调查身份验证、许可、源访问和运行时故障。

对于 API 或 MCP 操作登录失败,请使用 插件身份验证疑难解答。 对于任务和依赖项检查,请使用 “调查故障”。

与受影响的用户确认修复并记录结果。 更正的配置或成功的工具调用本身并不能证明用户的完整任务现在有效。

更新插件或代理

当您需要更改解决方案时,请按照此工作流操作。 使用组合插件的包步骤。 将创作产品的发布过程用于独立代理。

更新之前

拥有:

  • 监视证据、用户反馈、支持案例或计划的改进。
  • 代表性任务和验收标准。
  • 访问源和受影响的功能。
  • 发布记录,包括当前版本、受众和分发路由。
  • 任何连接、标识或服务更改的所有者。

建立基线

  1. 说明要解决的问题或改进。
  2. 确定受影响的包或代理版本、用户、体验、功能和依赖项。
  3. 定义代表性任务和可衡量的验收标准。
  4. 针对当前版本运行任务并记录结果。
  5. 如果您的组织管理插件,请在代理工具>>插件中记录其当前状态、用户可用性和安装状态。 对于代理的适用控件,请使用 代理>所有代理>注册表。
  6. 保留比较当前行为和更新行为所需的证据。

对于包含代理的插件,当响应质量、说明、知识或工具使用是更改的一部分时,请使用 代理评估概述 来设计评估。 评估可以提供预发布证据,并帮助调查部署后质量问题,包括由使用信号、用户反馈或代理和依赖项更改引发的问题。

并非每个插件都需要代理评估。 它不能取代功能测试、程序包验证或测试完整的用户体验。

对于已部署的声明式代理,请使用引导 wiqd agent eval 式工作流。 有关直接命令行或管道控制,请参阅 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®评估 CLI 概述。

应用并测试更改

当您需要更改功能、集成或源时,返回到 “生成”或“重复使用 ”。 当你需要准备和验证候选版本时,返回到 包 & 测试 。 将受影响的依赖项和受支持的体验保留在范围内。

  1. 更新源或受影响的功能。
  2. 在更改需要时更新单独运营的服务或配置。
  3. 测试每个更改的功能和受影响的依赖项。
  4. 再次运行基线任务和评估。
  5. 将结果与验收条件进行比较。
  6. 在创建发布包之前调查回归。

当更改影响连接器、远程 MCP 服务器、标识、权限或外部服务时,涉及该依赖项的所有者。 不要假定更改包会更新单独运营的服务。

创建和验证包

对于独立代理,请遵循其创作产品的版本控制、测试和发布说明。 以下包步骤适用于组合的插件。

  1. 分配新的包版本并检查发布方法的标识要求。
  2. 创建插件包。
  3. 验证并测试要发布的确切包 。
  4. 测试所需的登录、许可、连接和外部服务。
  5. 在你打算支持的每个 Microsoft 365 体验中测试该包。
  6. 记录已知限制、所需配置以及任何记录的恢复选项。

不要发布与验证的包不同的包。

发布和推出更新

选择您的产品和分销路线的更新程序。 发布路由区分共享、组织提交和商城发布。

分发路由 记录的指南或限制 谁在行动
通过 Cowork 共享的插件 按照记录的 上传和重新共享过程 获取已共享插件的较新版本。 此过程适用于 Cowork 共享,不适用于常规注册表替换。 插件所有者
通过 Work IQ Dev Tools 提交组织应用目录 按照 将已批准的更新提交到组织应用目录。 保留发布目标的现有标识和环境状态,测试更新的版本,提交并 wiqd plugin publish获得管理员批准。 插件所有者和管理员
手动上传注册表或其他直接共享方法 在发布前确认特定于产品的现有项更新过程。 本文不提供手动工具注册表包替换步骤。 不要假定新的上传会替换现有条目或保留其可用性设置。 插件所有者和管理员
Microsoft 卖场 遵循已发布产品/服务使用的产品/服务类型的更新指南。 从“将 插件发布到 Microsoft 市场”链接的合作伙伴中心指南开始。 在将客户引导至更新之前,请完成任何必需的审阅和发布。 发布者和客户管理员(如果需要)

对于 WIQD 更新,请保留已建立的资源和发布 ID。 重新预配使用现有环境标识,并且可以在目录批准之前更改当前用户使用的资源。 测试更改时要考虑到该效果。 根据 现有项目的 WIQD 指南检查项目的发布生命周期;更新 CLI 不会更新项目文件。

wiqd plugin publish 通过提交项目和环境,而不是捕获的 ZIP --package-file。 通过提交保持已批准的源和环境状态固定,并验证提交的版本。 仅通过程序包验证并不能证明发布提交了这些确切的字节。

对于具有记录更新过程的路由:

  1. 对测试版本使用确认的发布或共享过程,并记录它是提交、发布、共享、拒绝还是阻止。
  2. 向管理员或推出所有者提供确切的版本、目标用户、所需配置、已知限制和支持联系人。
  3. 仅完成适用的步骤, 使更新的插件或代理可用。 审批、分配和安装要求取决于方法和组织设置。
  4. 根据需要更新单独控制的代理、连接、标识、远程 MCP 服务器或外部服务。
  5. 确认哪个版本覆盖了每个受众。

在不假定回滚的情况下规划恢复

管理员可以在 Microsoft 365 管理中心中阻止和取消阻止插件。 使用插件的 “取消阻止 ”操作移除阻止,然后验证预期用户的访问权限。 其他可用性、安装、权限和连接要求仍然适用。 取消阻止不会还原早期的程序包版本或撤消服务更改。

当前指南未记录常规插件包版本回滚过程。 仅当产品记录特定于产品的回滚操作时,才使用该操作。

在发布之前,记录记录的恢复选项及其先决条件,或记录过程差距和对推出失败负责的所有者。

替换包不会自动还原外部服务、连接、标识、数据或权限更改。 单独规划这些依赖项。

验证更新

  1. 在每个受支持体验中,与目标用户一起测试代表性任务。
  2. 确认用户收到预期的版本。
  3. 确认登录、许可、连接、工具调用和外部服务正常工作。
  4. 在您的组织中管理插件的位置,检查其状态、用户可用性和安装状态是否与代理>工具>插件中的目标受众匹配。 检查是否仍在使用任何替代版本。
  5. 重复用于批准更改的评估。
  6. 推出后查看使用信号、反馈、错误和支持案例。
  7. 如果更新未达到其验收标准,请暂停推出、记录失败并让负责的所有者参与进来。 仅当产品记录恢复操作时才使用恢复操作。

当目标受众具有正确的版本、其访问设置与预期推出匹配、代表性任务符合其验收条件,并且每个未解决的问题都有所有者和后续操作时,更新完成。

记录更新

记录:

  • 以前和更新的包或代理版本。
  • 更改、原因、受影响的功能和依赖关系。
  • 基线、评估、验证和用户测试结果。
  • 发布方法、受众、推出状态和适用的注册表状态。
  • 配置或服务更改。
  • 已知限制、记录的恢复选项或过程差距以及支持所有者。

移交所有权和支持

在当前所有者离开角色之前,为下一个所有者提供:

  • 源、包或代理标识、当前版本、发布记录和发布路由。
  • 监视位置、代表性测试、已知问题和未解决的支持案例。
  • 目标受众、管理联系人、所需连接和外部服务所有者。
  • 记录的更新、恢复和停用过程,包括任何间隙。

对于智能体生成器或 Copilot Studio 中内置的共享代理,请在该过程适用时使用“将新所有者分配给代理”。 代理生成器还支持 添加所有者。 在进行更改之前,请查看对前所有者访问权限的影响。

这些是代理所有权过程,而不是外部插件包的常规转移过程。 分别确认源访问、发布访问、连接、凭据和服务职责。 让下一个所有者验证他们是否可以监视、维护和支持解决方案。

停用插件或代理

在不应再使用时停用该解决方案。 决定是结束对所有客户的分发,还是仅删除组织中的访问权限;这些作用域是不同的。

  1. 确定活动版本、用户、发布和共享位置以及共享依赖项。
  2. 通知用户和支持团队,包括任何替换和停用日期。
  3. 停止通过支持的路由进行分发和访问,并在需要时删除管理员安装。
  4. 让服务所有者删除特定于插件的访问权限和资源,同时保留其他解决方案使用的资源。
  5. 与之前授权的用户验证结果,并记录保留的资源、异常和所有者。

若要停用包,请参阅 停用插件。 对于独立代理,请使用适用的产品过程,例如删除代理。 不要认为删除代理或包会撤销所有连接、权限或外部服务。