封裝您的 Microsoft 365 Copilot 外掛程式

建立您要測試和發行的確切版本外掛程式套件。 此步驟是在插件的組件在預期的開發或測試環境中協同工作之後進行的。

重要

.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 開發工具外掛程式專案 (針對支援案例建議的專業程式碼路由) 遵循所選環境的來源驗證與佈建步驟,然後執行 wiqd plugin package。 請參閱 使用 Work IQ 開發工具建置外掛程式。 已設定版本的應用程式套件,在共用或發佈之前要加以驗證。
當選取的工作流程支援外掛程式的元件和目標體驗時,使用 Microsoft 365 Agents Toolkit 建置的外掛程式套件 選取 [ Zip] Teams 應用程式套件 或使用 teamsApp/zipAppPackage 生命週期動作。 請參閱 Agents Toolkit 中的自訂應用程式資訊清單。 支援的工作流程所產生的外掛程式套件。
手動組合的 Cowork 外掛程式套件 請遵循為 Copilot Cowork 建置外掛程式中的資訊清單、技能、連接器、圖示和 ZIP 版面配置指示。 適用於已記載 Cowork 路線的 Microsoft 365 應用程式套件。

如果沒有封裝路由支援外掛程式的元件和目標體驗,請停止。 選擇支援的方法或修改外掛程式。 請勿結合或重新命名成品來建立不支援的套件。

針對直接在 Copilot Chat 中使用的技能,請透過應用程式資訊清單的agentSkills屬性封裝外掛程式層級技能。 這與宣告式代理程式資訊清單的 agent_skills 屬性不同。 Chat 接受的獨立或SKILL.md技能 ZIP 並不是完整的外掛程式應用程式套件。 請參閱 在外掛程式中封裝技能。

若要自動化 WIQD 來源檢查、候選封裝和封裝優先驗證,請參閱 使用 Work IQ 開發工具設定外掛程式 CI/CD。

注意

WIQD 來源驗證不是建置套件的完整驗證。 使用 測試和驗證外掛程式中目前的套件驗證程序,在封裝之後驗證確切的 ZIP。

識別套件及其相依性

在組裝發行成品之前,先選擇預期的 發佈和發佈路徑 。 針對每條路線,請識別:

  • 身份: 應用程式識別碼、套件版本和元件識別碼。
  • 中繼資料: 名稱、描述、開發人員資訊、圖示,以及適用的隱私權和條款連結。
  • 驗證: 身分識別模型、支援的授權設定、權限和同意需求,以及認證參考。
  • 連線: 端點、連線參照和環境特定設定。
  • 外部相依性: 套件外部所需的遠端服務、資料來源、擁有者和設定。

僅在套件中放置架構支援的宣告和參照。 將操作詳細資料保留在發佈整備記錄中,且不要包含認證或密碼。

配送路線 此套件的確認內容
直接共用以進行測試 選取的對象、測試環境、套件身分識別和中繼資料,以及這些測試人員所需的驗證、連線和外部服務。
組織分佈 用於系統管理員檢閱的套件身分識別和中繼資料,以及組織中所需的驗證、連線、權限和外部服務設定。
公開發佈 所選提交路由的套件身分識別和中繼資料,以及客戶組織和使用者必須設定的驗證、連線和外部相依性。

共用或發佈套件無法完成安裝、指派、同意或連線設定。 遵循所選路線的當前要求;本文不會定義提交合約。

建立套件

  1. 開啟所選外掛程式路由的封裝程序。
  2. 選取預期的環境和您測試的確切元件版本。
  3. 執行記載的命令、UI 動作或自動化工作流程。
  4. 記錄成品名稱、位置、版本、環境和工具版本。

檢查產生的成品

請確認:

  • 外掛程式身分識別與套件版本正確無誤。
  • 套件包含預期的資訊清單、中繼資料、設定和資產。
  • 元件宣告、檔案、識別碼、端點和服務參考符合您測試的版本。
  • 套件會使用預定的環境設定。
  • 驗證、權限、同意和連線需求是在沒有認證、權杖或祕密的情況下宣告的。
  • 套件不包含暫存檔案、記錄、測試資料或不相關的成品。

記錄發佈整備程度

將發佈整備記錄帶入 測試和驗證,並在發佈之前完成。 記錄:

  • 套件或成品身分識別和確切版本。
  • 元件、遠端服務和外部參考。
  • 封裝工具和預期的發佈方法。
  • 經過測試的 Microsoft 365 體驗與環境。
  • 驗證、權限、同意和連線需求。
  • 驗證證據和結果。
  • 已知限制、不支援的組合,以及可接受的風險。
  • 發行擁有者和驗證日期。

後續步驟