使用監控、反饋和支持證據來決定是否修復、更新、移交或淘汰您的插件或代理。 在發行前測試變更,並與目標使用者確認結果。
建置者維護並測試解決方案。 Microsoft 365 系統管理員會視需要完成組織推出和存取動作。 服務擁有者會維護連接器、遠端 MCP 伺服器、身分識別,以及其所使用的外部服務。 這些責任不會自動一起轉移。
選擇工作
將章節用於您需要執行的工作。 監視、支援、移交和淘汰不需要您遵循更新工作流程。
| 需採取的步驟 | 開始使用 |
|---|---|
| 檢閱採用、意見反應或任務結果 | 監視使用量和任務結果 |
| 調查使用者問題 | 支援使用者並調查問題 |
| 變更並發行解決方案 | 更新您的外掛程式或代理程式 |
| 轉移維護責任 | 移交擁有權與支援 |
| 結束發佈或存取 | 淘汰外掛程式或代理程式 |
開始之前
識別:
- 目前的外掛程式或代理程式身分識別和版本。
- 受影響的使用者和 Microsoft 365 體驗。
- 負責工作和任何涉及的連線或服務的擁有者。
對於獨立代理程式,請使用其編寫產品所支援的監控和發行程序。 請勿假設外掛程式套件程序適用於它。
監視使用量和任務結果
選擇報告期間、版本、對象和代表性任務。 使用擁有活動之產品的監控體驗。
| 您正在監控的項目 | 從哪裡開始 | 要記住的範圍 |
|---|---|---|
| Agent Builder 內建的代理程式 | 在 Agent Builder 中監視代理程式 | 代理程式的 [監視器] 索引標籤涵蓋其使用情況和意見反應。 意見反應可見度有個別的必要條件。 |
| 使用標準安全帶的 Copilot Studio 代理程式 | 在 Copilot Studio 中監視代理程式效能 | 使用該代理程式支援的分析;請勿假設 Agent Builder 或其他組建路徑中有相同的報表。 |
| 外掛程式存取、使用者工作和失敗 | 監控您的外掛程式 | 檢查套件可用性、代表性工作結果、使用者意見反應和支援案例。 |
| Microsoft 365 使用情況和稽核活動 | 選擇檢查項目 | 將每個報告用於它所涵蓋的活動。 稽核事件無法確定工作成功或回應正確。 |
| 連接器或遠端 MCP 服務 | 調查失敗 和服務的監視指引 | 與服務擁有者一起檢查連線狀態、來源權限、端點健全狀況、記錄和錯誤。 套件可用性無法證明執行階段健康情況。 |
請勿假設遙測或報告涵蓋範圍會跨外掛程式和代理程式組建路徑共用。 包含的代理報告涵蓋該代理,而不一定涵蓋外掛程式中的所有功能。
記錄採用率、工作成功、回應品質、登入或工具失敗方面的變更,並在可用證據支持這些結論時支援量。 比較代表性任務和用戶反饋以及使用計數。
支援使用者並調查問題
針對每個問題,擷取受影響的版本、產品、對象、預期結果、觀察到的結果,以及相關的錯誤詳細資料。 指派擁有者和下一個動作。
- 請系統管理員調查可用性、安裝、原則或擱置中的存取請求。
- 請建築商或代理商擁有者調查說明、知識、工具選擇或迴歸。
- 要求身分識別、連線或服務擁有者調查驗證、同意、來源存取和執行階段失敗。
針對 API 或 MCP 動作登入失敗,請使用 疑難排解外掛程式驗證。 如需工作和相依性檢查,請使用 [調查失敗]。
與受影響的使用者確認修正並記錄結果。 更正的設定或成功的工具呼叫本身並不會建立使用者的完整工作現在可運作。
更新您的外掛程式或代理程式
當您需要變更解決方案時,請遵循此工作流程。 使用撰寫的外掛程式的套件步驟。 使用獨立代理程式的編寫產品的發行程序。
更新之前
擁有:
- 監控證據、使用者意見反應、支援案例或計劃的改善。
- 代表性任務和驗收標準。
- 來源和受影響功能的存取權。
- 發佈記錄,包括目前版本、對象和發佈路徑。
- 任何連線、身分識別或服務變更的擁有者。
建立基準
- 說明您想要解決的問題或改進功能。
- 找出受影響的套件或代理程式版本、使用者、體驗、功能和相依性。
- 定義代表性任務和可衡量的驗收標準。
- 對目前版本執行任務並記錄結果。
- 如果您的組織管理該外掛程式,請在 [代理>工具>外掛程式] 中記錄其目前狀態、使用者可用性和安裝狀態。 如需代理程式的適用控制項,請使用代理程式>[所有代理程式登錄>]。
- 保留比較當前行為和更新行為所需的證據。
對於包含代理程式的外掛程式,請使用 代理程式評估概觀 來設計當回應品質、指示、知識或工具使用是變更的一部分時的評估。 評估可以提供發行前證據,並協助調查部署後品質問題,包括使用訊號、使用者意見反應或代理程式和相依性變更所引發的問題。
並非每個外掛程式都需要代理程式評估。 它不會取代功能測試、封裝驗證或測試完整的使用者體驗。
針對已部署的宣告式代理程式,請使用引導式 wiqd agent eval 工作流程。 如需直接命令列或管線控制,請參閱 Microsoft 365 Copilot 評估 CLI 概觀。
套用並測試變更
當您需要變更功能、整合或來源時,請返回 [組建] 或 [重複使用 ]。 當您需要準備和驗證候選版本時,請返回 套件 & 測試 。 將受影響的相依性和支援的體驗保留在範圍內。
- 更新來源或受影響的功能。
- 變更需要時,更新個別營運的服務或設定。
- 測試每個變更的功能與受影響的相依性。
- 再次執行基準工作和評估。
- 將結果與驗收準則進行比較。
- 在建立發行套件之前先調查迴歸。
當變更影響連接器、遠端 MCP 伺服器、身分識別、權限或外部服務時,會涉及該相依性的擁有者。 請勿以為變更套件會更新個別營運的服務。
建立並驗證套件
對於獨立代理程式,請遵循其編寫產品的版本設定、測試和發佈指示。 下列封裝步驟適用於撰寫的外掛程式。
- 指派新的套件版本,並檢查發佈方法的身分識別需求。
- 建立外掛程式套件。
- 驗證並測試您打算發行的確切套件 。
- 測試必要的登入、同意、連線和外部服務。
- 在您要支援的每個 Microsoft 365 體驗中測試套件。
- 記錄已知限制、必要設定,以及任何已記載的復原選項。
請勿發佈與您驗證的套件不同的套件。
發佈和推出更新
選擇產品和分銷路線的更新程序。 發佈路由區分共用、組織提交和 Marketplace 發佈。
| 配送路線 | 記錄指引或限制 | 行動人 |
|---|---|---|
| 透過 Cowork 共用的外掛程式 | 請遵循已共用外掛程式較新版本的 記載上傳和重新共用程式 。 此程序適用於 Cowork 共用,而非一般登錄取代。 | 外掛程式擁有者 |
| 透過 Work IQ 開發工具提交組織應用程式目錄 | 遵循 [ 將核准的更新提交到組織應用程式目錄]。 保留發行目標的現有身分識別和環境狀態、測試更新的版本、提交 wiqd plugin publish,並取得系統管理員核准。 |
外掛程式擁有者和系統管理員 |
| 手動登錄上傳或其他直接共用方法 | 在發行前確認產品特定的現有項目更新程序。 本文不會提供手動工具登錄套件取代步驟。 請勿以為新的上傳項目會取代現有項目或保留其可用性設定。 | 外掛程式擁有者和系統管理員 |
| Microsoft Marketplace | 請遵循已發佈供應項目所使用的供應項目類型的更新指導方針。 從從 將外掛程式發佈到 Microsoft Marketplace 連結的合作夥伴中心指導方針開始。 在將客戶導向更新之前,請先完成任何必要的審查和發佈。 | 如有需要,發行者和客戶系統管理員 |
對於 WIQD 更新,請保留建立的資源和發行識別碼。 重新佈建會使用現有的環境標識,並可以在目錄核准之前變更目前使用者使用的資源。 測試變更時要考慮到該效果。 根據 現有專案的 WIQD 指導方針,檢查專案的發佈生命週期;更新 CLI 不會更新專案檔案。
wiqd plugin publish 提交專案和環境,而不是透過 --package-file擷取的 ZIP。 透過提交保持已核准的來源與環境狀態固定,並驗證已提交的版本。 封裝驗證本身並不能證明發佈會提交這些確切的位元組。
對於具有已記錄更新程序的路由:
- 針對測試版本使用已確認的發佈或共用程序,並記錄其是否已提交、發佈、共用、拒絕或封鎖。
- 向系統管理員或推出擁有者提供確切的版本、目標使用者、必要的設定、已知限制和支援連絡方式。
- 僅完成適用的步驟, 使更新的外掛程式或代理程式可用。 核准、指派和安裝需求取決於方法和組織設定。
- 視需要更新個別控制的代理程式、連線、身分識別、遠端 MCP 伺服器或外部服務。
- 確認每個客群所使用的版本。
規劃不假設復原的復原
系統管理員可以在 Microsoft 365 系統管理中心封鎖和解除封鎖外掛程式。 使用外掛程式的 [解除封鎖 ] 動作來移除封鎖,然後驗證預期使用者的存取權。 其他可用性、安裝、權限和連線需求仍然適用。 解除封鎖不會還原較舊的套件版本或復原服務變更。
目前的指引並未記載一般外掛程式套件版本復原程序。 只有在產品記錄時,才使用產品特定的復原作業。
在發行之前,請記錄記錄的復原選項及其先決條件,或記錄程序差距和負責推出失敗的擁有者。
取代套件不會自動還原外部服務、連線、身分識別、資料或權限變更。 分別規劃這些相依性。
確認更新
- 在每個支援的體驗中,使用預期使用者測試代表性工作。
- 確認使用者已收到預期的版本。
- 確認登入、同意、連線、工具呼叫和外部服務都能正常運作。
- 在組織中管理外掛程式的位置,請檢查其狀態、使用者可用性和安裝狀態是否與代理工具>>外掛程式中的目標對象相符。 檢查是否有任何仍在使用的已取代版本。
- 重複用來核准變更的評估。
- 在推出之後檢閱使用訊號、意見反應、錯誤和支援案例。
- 如果更新未達到其驗收準則,請暫停推出、記錄失敗,並讓負責的擁有者參與。 只有在產品記錄復原作業時,才使用復原作業。
當目標對象具有正確的版本、其存取設定符合預期的推出、代表性工作符合其驗收標準,且每個未解決的問題都有擁有者和下一個動作時,更新即完成。
記錄更新
記錄:
- 先前和更新的套件或代理程式版本。
- 變更、原因、受影響的功能和相依性。
- 基準、評估、驗證和使用者測試結果。
- 發佈方法、對象、推出狀態和適用的登錄狀態。
- 設定或服務變更。
- 已知限制、記載的復原選項或程序差距,以及支援擁有者。
移交擁有權與支援
在目前的擁有者離開角色之前,請提供下一個擁有者:
- 來源、套件或代理程式身分識別、目前版本、發行記錄和發佈路由。
- 監視位置、代表性測試、已知問題和未解決的支援案例。
- 目標對象、管理連絡人、必要連線和外部服務擁有者。
- 記錄的更新、復原和淘汰程序,包括任何差距。
對於 Agent Builder 或 Copilot Studio 中內建的共用代理程式,請在適用該程序時使用 [將新擁有者指派給代理程式]。 Agent Builder 也支援 新增擁有者。 在進行變更之前,請檢閱對先前擁有者存取權的影響。
這些是代理所有權程序,而不是外部插件包的一般轉移程序。 請分別確認來源存取權、發佈存取權、連線、認證和服務責任。 讓下一個擁有者驗證他們可以監視、維護及支援解決方案。
淘汰外掛程式或代理程式
在不應再使用該解決方案時,將其淘汰。 決定是否要結束對所有客戶的發佈,或只移除組織內的存取權;那些範圍是不同的。
- 識別使用中的版本、使用者、發佈和共用位置,以及共用的相依性。
- 通知使用者和支援小組,包括任何更換者和淘汰日期。
- 停止透過支援的路由進行散發和存取,並在需要時移除系統管理員安裝。
- 讓服務擁有者移除特定於外掛程式的存取權和資源,同時保留其他解決方案使用的資源。
- 使用先前授權的使用者驗證結果,並記錄保留的資源、例外狀況和擁有者。
若要淘汰套件,請參閱淘汰 您的外掛程式。 對於獨立代理程式,請使用適用的產品程序,例如 刪除代理程式。 請勿假設移除代理程式或套件會撤銷所有連線、權限或外部服務。