測試建立 外掛程式套件所產生的確切版本化成品。 在 封裝 & 測試中,將元件辨識項連線到該 ZIP、透過支援的路由進行安裝,並在每個宣告的Microsoft體驗中驗證傳遞的版本、存取權和實際執行階段行為。
最後提供此證據:「我測試了這些元件、封裝了這些確切的參考、安裝了這個確切的版本、執行這些案例,並保留了這些結果。」成功的架構檢查、佈建命令或合理的回應不會建立該鏈。
開始之前
擁有:
- 完成 組件和集成測試,包括已知測試數據和預期結果。
- 候選 ZIP、其套件識別/版本,以及它所包含的元件版本、端點和連線參考。
- 開發租用戶、非生產資料、套件元件支援的安裝路由,以及使用它的權限。
- 測試允許和受限制使用者的身分識別;可用性和封鎖測試的授權系統管理員。
- 每個目標體驗所需的授權、登入、同意、連線和外部服務。
- 每個案例和身分識別的 測試記錄 。
在測試之前,定義所需的套件、安裝、存取和執行階段檢查,以及將建立每個結果的證據。 使用執行階段宣告的元件 特定辨識項準則 ,以及 確認已傳送版本中所述的安裝辨識項。
在上傳、安裝套件、授與同意、共用套件或變更系統管理設定之前,先取得核准。 這些程序會變更租用戶狀態;使用受控測試身分識別和對象。
驗證架構和元件參照
開啟候選字 ZIP,而不加修改。 讀取其根 manifest.json、 recording id、 version和 manifestVersion。 確認:
- 資訊清單會使用您的路由所需的 Microsoft 365 應用程式資訊清單架構 。
- 包含的代理程式定義和動作資訊清單會使用其適用的結構描述。 API 外掛程式資訊清單描述的是代理程式動作,而不是外部登錄外掛程式。
- 參照的技能資料夾、配套檔案、圖示和工具描述存在於其宣告的套件路徑中。
- 版本、識別碼、端點和連線參照符合元件測試記錄和預期環境。
- 不包含任何認證、祕密、記錄或不相關的測試檔案。
針對 Work IQ 開發工具,請使用記載的 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"驗證:必要套件、原則和證據檢查通過,且不會遺漏任何必要證據。
並packagemarketplace使用組建的 ZIP 檔案,上傳該檔案,並可能要求登入。 他們不會自動建立或登入。 他們也接受沒有來源專案的 ZIP 檔案。 Marketplace 模式會新增原則和證據檢查。 其報告不是 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 與服務記錄進行比較。 使用 特定於元件的證據工具;代理程式診斷路由本身無法建立獨立安裝的外掛程式已執行。
保持正確性和叫用結果分開。 所需檢查的缺失證據仍未 驗證。 將無法使用的其他診斷記錄為限制,而不是已驗證的執行詳細資料或自動失敗。 在 Chat 和 Cowork 中分別重複進行探索、連線、選取和執行階段測試,同時聲明兩者。
測試驗證與存取
讓授權系統管理員透過設定 使用者的外掛程式可用性 和管理 外掛程式、技能和 MCP 伺服器來準備受控測試設定。 記錄原始設置並在批准的測試後恢復它們。 使用與您的外掛程式支援的相同無害的查閱或等效案例。 對於不適用的檢查,例如僅限技能案例中的服務同意,請記錄原因,而不是新增功能。
| 測試 | 設定和動作 | 預期的結果 |
|---|---|---|
| 允許的使用者 | 在核准的客群中包含測試身分識別。 以該使用者身分登入,並完成必要的同意/連線。 | 支援的案例在該使用者的來源權限內成功;引動證據可識別預期的功能。 |
| 受限制的使用者 | 將可用性限制為核准的客群,然後使用該客群以外的帳戶進行測試。 | 使用者無法使用外掛程式。 在 Copilot 頻道中,清單可以保持可探索狀態為已封鎖;符合資格的使用者可以要求存取。 僅憑可見性並不是失敗。 |
| 拒絕同意 | 在沒有現有授權的情況下使用測試身分識別/連線。 拒絕作業所需的同意,然後重試受保護的查閱。 | 作業未取得要求的受保護存取權。 記錄登入/同意錯誤,並確保沒有受保護的結果顯示為成功。 不相關的允許功能仍然可以運作。 |
| 封鎖和解除封鎖 | 讓系統管理員追蹤 封鎖該候選人的 外掛程式或技能 。 使用先前允許的使用者重複要求,然後讓系統管理員選取 [ 解除封鎖 ] 的外掛程式,然後再次重複要求。 | 遭封鎖時,無法使用外掛程式和相依代理程式。 相關聯的 MCP 伺服器/連接器仍可供其他外掛程式使用。 解封後,先前允許的使用者可以再次使用外掛程式,但須符合原有的可用性、權限和連線要求。 |
發行者類別限制 是個別的控制項。 如果測試,請記錄類別及其原則結果;不要只為了測試一位候選字而變更全組織的設定。 如適用,請測試登入更新/重新連線、來源權限和遺失的連線。
針對 Microsoft Entra 授權碼驗證,拒絕的同意會傳回授權錯誤;請使用實際的提供者錯誤,而不是預期每個主機中都有相同的字詞。
測試支援的體驗
記錄每個體驗、身分識別角色和案例的結果,包括安裝和已交付版本證據。 Cowork 中的通行證不會在 Chat 或其他主持人中建立通行證。 為每個路由使用支援的路線;未解決的安裝或版本證據可防止對該體驗提出發行聲明。
記錄代理程式品質結果
如果包含代理程式,且您的發行準則需要品質評估,請評估對應的已部署版本,並將其結果連結至候選記錄。 從 代理程式評估概觀開始。 品質評分不會取代套件、已安裝版本、存取或叫用證據。
重複迴歸檢定候選項目
針對已安裝的候選項目重新執行記錄的基準案例、存取測試、失敗案例,以及任何必要的代理程式評估。 新增變更特定案例,而不移除基準。 保留兩組 測試記錄,比較結果,並在核准前解決迴歸或必要的 未驗證 檢查。
對於基準準備和更新生命週期,包括發佈、推出、取代和復原決策,請遵循 監控、更新和淘汰您的外掛程式或代理程式。 請勿假設自動升級、保留指派或特定的重新同意觸發。 推出後,重複傳遞版本和執行階段驗證。
決定發行整備
使用套件身分識別和版本、確切的 ZIP 檔案和選用雜湊、元件版本和端點、環境、測試身分識別角色、案例、預期和實際結果、已清理的叫用辨識項、狀態和擁有者來完成共用 測試記錄 。 附加驗證報告以及安裝和版本證據。
指派一個結果:
- 就緒 - 確切的候選項目已通過所有必要的檢查,有完整的證據,而且沒有解決的發行封鎖程式。
- 已封鎖 - 必要的檢查失敗或仍未驗證,包括成品繫結、傳遞版本、存取或叫用。
- 準備就緒但有限制 - 已通過必要的檢查;其餘的非封鎖限制已記錄、接受並適合披露。
應用測試前定義的所需檢查和證據標準。 接受的診斷限制無法將遺失的必要證據轉換為及格;當必要的檢查已有足夠的證據時,不需要進行其他診斷。 針對每個封鎖程式,記錄擁有者和解決方案。 當成品變更時,請建立新的候選項目,重新安裝它,然後重複受影響的測試和迴歸測試。
相關內容
後續步驟
必要證據完成後,繼續 發佈 & 散發: