在 準備期間,將您的 功能選擇 轉換成建置計劃。 從專業開發的 Work IQ 開發工具開始,選擇已記錄的環境,並僅在案例需要時才新增 Microsoft 365 代理程式工具組或 SDK。 您完成工具、來源位置、擁有者和每個元件的先決條件。
若要將 Copilot 功能建成您擁有的應用程式,請改為 遵循建置 Copilot 支援的應用程式 。
從 Work IQ 開發工具開始
Work IQ 開發工具 是支援的外掛程式案例的預設專業開發人員路徑。 使用其引導式工作流程來建立和撰寫外掛程式,然後驗證、佈建、封裝和共用它。 當您需要可重複的執行或指令碼處理時,請使用直接 CLI 命令。
選擇擁有來源的命令介面:
| 您的來源和任務 | 從這裡開始 | 邊界 |
|---|---|---|
| 包含支援技能、遠端 MCP 伺服器的外掛程式連接器或選用宣告式代理程式的新外掛程式 | 使用 WIQD 建置外掛程式 |
wiqd plugin add agent 支架,代理組件;它不會匯入現有的代理程式專案。 |
| 現有的宣告式代理程式來源專案 | 代理程式元件生命週期 | 針對該專案使用已 wiqd agent 記載的工作流程。 |
| 支援的 Open 外掛程式、Claude 外掛程式或 Cursor 外掛程式來源 | WIQD 匯入和匯出 | 格式轉換不會建立同等的執行階段行為或主機支援。 |
| 針對所選使用者經過測試的共用部署 | 使用 WIQD 建置外掛程式 | 共用會授與存取權;這不是組織目錄提交。 |
| 經過測試的組織目錄外掛程式 | 發佈和現有專案 |
wiqd plugin publish 提交供系統管理員核准,而非公開 Marketplace 認證。 |
使用明確的來源驗證來進行離線檢查。 預設驗證模式是針對現有 ZIP 進行封裝驗證;IT 可以上傳套件並要求驗證。 這兩種模式都不會取代在預期體驗中測試實際功能。
選擇您的環境
下表列出已記錄的 WIQD 路由。 它不是詳盡的相容性矩陣:
| 環境 | 將其用於 | 設定和限制式 |
|---|---|---|
| GitHub Copilot CLI | 使用 WIQD 編碼助理外掛程式進行引導式外掛程式編寫 | 安裝主機及其 WIQD marketplace 外掛程式,然後啟動新的工作階段。 marketplace 外掛程式未安裝 WIQD CLI。 |
| Claude Code | 使用該主機的 WIQD 外掛程式進行引導式製作 | 請遵循 WIQD 安裝中的主機特定 Marketplace 步驟。 |
| 直接命令列 | 驗證和可重複的外掛程式或代理程式生命週期命令 | 安裝不同的 CLI。 安裝指令碼路由需要 Node.js 24.15 或更新版本和 npm;Windows 需要 PowerShell 7 或更新版本。 |
| Visual Studio Code | 透過選用的 WIQD 擴充功能進行專案編輯和資訊清單診斷 | 請遵循目前編輯器整合的 WIQD 安裝 。 編輯器診斷不會取代最終封裝驗證。 |
| 信任的 CI/CD 管線 | 核心支援的佈建、發佈和共用作業,受限於所選版本的驗證限制 | 遵循 外掛程式 CI/CD 指導方針 和 管線驗證。 代理程式 專案管線範例 不是外掛程式感知管線產生器。 |
針對本機租用戶作業,請在佈建之前以互動方式登入。 對於自動化,請使用已發佈的受信任管線合約和秘密儲存。 不要在 CI 中執行互動 wiqd auth login 式,或將認證公開給不受信任的提取要求作業。 核心生命週期驗證不會驗證 Work IQ 查詢、評估或其他擴充功能。 請勿將原封不動的代理程式專案命令主體套用至外掛程式專案。
如需帳戶、租用戶和工具的先決條件,請使用 設定您的開發環境。 編碼助理可協助撰寫檔案,但不會取代元件的撰寫工具、執行階段、權限或發佈需求。
需要時新增元件特定工具
當選取的元件需要特定的編寫或專案控制時,請使用這些產品路線。 遵循產品自己的程序,而不是將工具視為可互換的封裝格式。
| 需求 | 工具或產品遞交 |
|---|---|
| 支援的宣告式代理程式專案、資訊清單或整合的較低層級控制 | Microsoft 365 代理程式工具組,使用 JSON 或 TypeSpec |
| 受引導、受管理的宣告式代理程式撰寫體驗 | 代理程式建立器;針對支援的技能使用自己的技能程序 |
| 受管理的工作流程、Power Platform 連接器、環境和低程式碼代理程式邏輯 | Copilot Studio;如適用,請使用其 Microsoft 365 發佈通道 |
| 以選取的 SharePoint 網站或文件庫為基礎的代理程式 | 所選格式的 SharePoint 代理程式指引和升級指引 |
| Copilot Cowork 的技能或外掛程式連接器 | 為 Copilot Cowork 建置外掛程式,以滿足產品特定的檔案、執行階段和測試需求 |
| Copilot 連接器 (同步處理) ,可將外部內容擷取至 Microsoft Graph | 建置您的第一個自訂 Copilot 連接器 |
| 宣告式代理程式中的遠端 MCP 動作 | 從 MCP 伺服器建置外掛程式 |
Copilot Studio 中的代理程式建立器目前不支援新增技能。 請勿從 Microsoft 365 Copilot 中的個別 Agent Builder 體驗推斷其功能集。 獨立 Copilot Studio 代理程式會顯示在代理程式登錄中,而不是外掛程式中。
對於匯入的 Cowork 專案,請在規劃封裝或發佈之前檢查 Cowork 開發指南中的目前限制。
當您需要自己的協調流程、模型、裝載或執行階段時,請在 應用程式路徑 上使用 SDK。 不要僅僅因為它也使用 Microsoft 365 服務,就將自訂引擎應用程式開發移至外掛程式工作流程。
記錄建置計劃
針對每個元件,記錄:
- 工作、預期體驗和記錄的元件格式。
- 無論您是建置新元件、設定現有來源,還是使用特定產品的重複使用工作流程。
- 製作工具、來源存放庫或受管理環境,以及負責任的擁有者。
- 必要的帳戶、訂閱、權限、服務和測試使用者。
- 產生成品的工具,以及接受該成品的散發方法。
- 封裝 & 測試之前所需的執行階段測試和證據。
共用套件並不表示所有位置都有相同的體驗。 支援的功能、可用性和所需設定會因產品、發佈路線和推出而異。
後續步驟
輸入 [組建或重複使用] 搭配外掛程式的建置或重複使用功能。 若要建立新的外掛程式,請 遵循使用 WIQD 建置外掛程式。 如果您已經有宣告式代理程式來源,請遵循 將 現有的宣告式代理程式封裝為外掛程式。