快速入門:使用 Work IQ 開發工具將現有的宣告式代理程式封裝為外掛程式

將 Work IQ 開發工具 與現有宣告式代理程式的本機來源搭配使用,以驗證、佈建、封裝並將其共用為外掛程式。 本快速入門從現有的來源專案開始,而不是從新的代理程式基架開始。

本逐步解說不會建立新的代理程式或從已安裝的代理程式重建來源。 如果您要改為啟動新外掛程式,請遵循 使用 Work IQ 開發工具建置外掛程式。

秘訣

觀看 Work IQ 開發工具如何從提示建置 Copilot 外掛程式,並在 互動式示範中將其發佈到代理程式商店。

先決條件

  • 具有有效 Copilot 訂閱的 GitHub Copilot CLI
  • 適用於 GitHub Copilot CLI 的 WIQD 編碼助理外掛程式 (請參閱本節中的安裝命令)
  • Node.js 24.15 或更新版本和 npm,可用於 PATH您的 ,用於 WIQD CLI 和安裝指令碼
  • 僅限 Windows) (PowerShell 7 或更新版本
  • 可存取 Copilot 的 Microsoft 365 帳戶
  • 您的租用戶已啟用自訂應用程式上傳
  • 支援的宣告式代理程式來源專案

安裝 GitHub Copilot CLI 之後,安裝 WIQD 編碼助理外掛程式:

copilot plugin install wiqd@awesome-copilot

或者,新增 WIQD Marketplace 並從該處安裝外掛程式:

copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd

使用 安裝指令碼安裝 WIQD CLI。

安裝之後,啟動新的 GitHub Copilot CLI 工作階段。

編碼助理外掛程式提供撰寫指導;它不會安裝 wiqd CLI。 在執行驗證和生命週期命令之前,請先單獨安裝 CLI。 使用 確認 wiqd --version CLI 安裝,並使用 wiqd doctor檢查其先決條件。

確認您有支援的啟動專案

從本機宣告式代理程式來源專案的根資料夾開始。 資料夾至少必須包含:

contoso-support-agent/
|-- appPackage/
|   |-- manifest.json
|   |-- declarativeAgent.json
|   `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>

生命週期檔案可以是 m365agents.yml、 m365agents.local.yml、 teamsapp.yml或 teamsapp.local.yml。 專案可以包含其他資料夾和環境檔案。

本快速入門不適用於下列情況:

  • 您只有已發佈的代理程式或已安裝的套件,沒有本機來源專案。 工作 IQ 開發工具不支援從已部署的遊戲重新建構來源專案。 復原原始來源存放庫,或使用原始撰寫工具。
  • 代理程式僅存在於受管理的撰寫體驗中,例如 Agent Builder 或 Copilot Studio。 使用該工具的發佈和共用程序。
  • 您有自訂引擎代理程式。 此 Work IQ 開發工具路由支援宣告式代理程式。
  • 您只有代理程式套件 .zip。 生命週期命令需要來源專案及其生命週期檔案。

如果您沒有現有的專案,請從 WIQD 快速入門 開始,建立外掛程式並新增宣告式代理程式。 對於支援的案例,建議使用 WIQD 專業程式碼起點。

注意

wiqd plugin import支援的匯入 Open Plugin、Claude 外掛程式或 Cursor 外掛程式格式。 它不會匯入現有的 Microsoft 365 宣告式代理程式專案或套件。 如需詳細資訊,請參閱匯 入 / 匯出 (互通) 。

建立您的外掛程式

  1. 如果您尚未安裝,請 安裝 Work IQ 開發工具。

  2. 在您要建立外掛程式的目錄中開啟 CLI,然後使用下列命令登入:

    wiqd auth login --interactive
    
  3. 在您的 CLI 中,使用命令copilot啟動 GitHub Copilot。

  4. 要求 GitHub Copilot 使用您現有的宣告式代理程式、技能或 MCP 伺服器建立外掛程式。 例如:

    Create a plugin named My Plugin by using the agent in "..\My Agent"
    

驗證外掛程式專案

在佈建或封裝外掛程式之前,明確選取離線來源驗證。 在 GitHub Copilot CLI 中,詢問:

Validate the plugin source offline in the dev environment

佈建外掛程式

重要

此範例會使用標準共用 dev 環境。 在佈建共用之前 (檢查預設 env) AGENT_SCOPE=shared 下的environmentFolderPath有效生命週期組態和選取的環境檔案。 單獨命名 dev 的環境不會建立共用範圍。 保留相同的環境來進行佈建、封裝、驗證和共用。

要求 GitHub Copilot 佈建外掛程式。

Provision the plugin using the dev environment

等待佈建完成。 佈建並不會確定每個外掛程式功能都可在 Copilot Chat 中使用;支援取決於元件和目標 Microsoft 365 體驗。

封裝外掛程式

要求 GitHub Copilot 封裝外掛程式。

Package the plugin using the dev environment

重要

您必須先佈建外掛程式,再進行封裝。 如果在佈建之前進行封裝,則產生的套件無效。

驗證套件

封裝後,找到生成的 ZIP 並確認該文件存在。 在 GitHub Copilot CLI 中,提供其實際路徑並詢問:

Validate this existing plugin ZIP in package mode using the dev environment

封裝驗證會使用 --mode package 和透過 提供的現有 ZIP --package-file,而不是自動組建。 檢閱傳回的判決和結果。 結束碼 0 表示選取的檢查已通過;仍可報告警告。 封鎖發現項目或不完整的結果無法通過,而且封裝驗證無法證明執行階段行為。

目前的驗證模式為 source、 package和 marketplace。 source 是明確的離線檢查。 預設值需要 package現有的 ZIP、將擷取的複本上傳到 Microsoft 365 驗證服務,而且可能需要驗證。 marketplace 增加政策和證據檢查;這不是官方商店核准。 驗證不會自動建立 ZIP、將您登入或佈建外掛程式。 如需詳細資訊,請參閱 驗證和 MVL。

共用外掛程式

您現在可以要求 GitHub Copilot 與組織內的特定使用者或整個組織共用您的外掛程式部署。 共用前先在選取的環境中進行確認 AGENT_SCOPE=shared 。 共用對象 (--scope users 或 --scope tenant) 不會變更部署範圍。

Share the plugin with AmberR@contoso.com using the dev environment

或:

Share the plugin with my organization using the dev environment

重要

共用自訂外掛程式取決於貴組織允許或封鎖共用外掛程式的設定。 如果您在此步驟中遇到任何錯誤,請洽詢您的系統管理員。 如需詳細資訊,請參閱 代理共用和發佈設定。

將外掛程式發佈到貴組織的外掛程式登錄

您可以要求將外掛程式發佈到貴組織的外掛程式登錄,而非共用您的外掛程式。 您的組織系統管理員可以檢閱您的外掛程式,然後核准或拒絕要求。

Submit my plugin to the organization catalog for admin approval using the dev environment

共用授予直接存取;目錄提交是個別的作業,並非系統管理員核准或完成使用者安裝。

刪除套件 (選用)

如果此外掛程式只是測試外掛程式,請要求 GitHub Copilot 移除該外掛程式。 此動作會刪除任何佈建的雲端資源。

Delete the plugin using the dev environment