一起測試您的外掛程式元件

測試您的外掛程式套件包含或參照的內容:技能、遠端 MCP 連接器和宣告式代理程式 (如果包含的話)。 此 套件 & 測試 工作會在建立發行成品之前建立元件行為和整合。 測試 和驗證您的外掛程式中會進行最終套件驗證、安裝和發行體驗檢查。 選擇組件的測試,保留 測試記錄,然後完成 包裝 前。

選擇您的測試

在整合案例中驗證元件

在您的外掛程式中 測試方式 區段
外掛程式層級技能,無論是否有代理程式 Cowork 開發工作階段;支援 Chat 技能選擇 測試技能
指向遠端 MCP 伺服器的外掛程式連接器 檢查器,然後透過 Cowork 中的外掛程式執行相同的任務 測試遠端 MCP 連接器
宣告式代理程式 (如果包含) Work IQ Dev Tools、ask 命令和 DevUI 測試包含的宣告式代理程式
解決方案使用的相依性 連接器診斷,然後重複整合式工作 測試相依性

知道您正在測試哪個連接器

  • 外掛程式連接器: 應用程式資訊清單 agentConnectors[] 項目。 本文測試遠端 MCP 類型:套件引用伺服器;它不包含執行中的服務。
  • Copilot 連接器 (同步) : 將知識擷取至 Microsoft Graph。 測試其擷取和後續擷取作為相依性。
  • Copilot 連接器 (同盟) : 擷取已連線身分識別下的即時資料。 將即時存取與擷取分開進行測試。
  • Power Platform 連接器:Copilot Studio 工具。 測試並不會確定其代理程式是登錄外掛程式。

外掛程式製作參考也會記錄現有 OpenAPI 自訂連接器參考的明確路由。 如果適用,請使用該路線的要求;本文中的 MCP 程序不會測試該連接器類型。

如何判斷結果

個別檢查每個元件,然後執行一起使用元件的工作。 成功的直接服務呼叫會建立伺服器行為。 整合式工作會建立選取、輸入、驗證及使用傳回的資料。

在測試之前,請定義每個元件和目標體驗所需的檢查和可接受的證據。 包括元件選擇、更正結果和存取邊界。 使用符合主張的證據:

元件或宣告 要保留的證據
技能選擇和行為 主機證據,識別已選取或載入的技能,以及所需的輸出和檔案。 在 Cowork 的側邊面板中,[技能] 會識別已載入的技能。 明確選取不會建立自動叫用。
遠端 MCP 叫用 經過驗證的服務日誌與主機請求相關,識別作業、輸入和結果。 直接檢查器呼叫不會透過外掛程式建立叫用。
包含的代理程式 已部署代理程式身分識別、要求和回應,以及可用的功能-選擇、擷取和引文診斷。 僅靠代理程式診斷並無法對每個包含的技能或指令碼建立叫用。
技能指令碼執行 公開時的執行診斷。 必要的輸出檔案會建立輸出結果,而不是特定指令碼執行的證明。 如果執行該指令碼是發行需求,請取得可確立該指令碼的證據。
  • 判斷 回應正確性 與 援引證據分開。 客服專員可以在不加載您的技能的情況下生成合理的發行說明。
  • 缺少所需檢查的證據仍然 未經驗證 ,並阻礙準備就緒。 不要因為診斷無法使用而弱化必要的檢查。
  • 當主機未公開其他診斷詳細資料時,請記錄該限制,而不聲明詳細資料已驗證。 當證據已經滿足必要的檢查時,無法使用的診斷不是單獨的障礙。
  • 將無訊息遞補或不完整的結果視為失敗。
  • 將經過消毒的證據保存在批准的存儲中,而不是憑據。 代理程式快照可能包含敏感性內容。

必要條件和已知測試資料

使用現有的外掛程式專案、開發租用戶、已知的測試身分識別和非生產資料。 選取您想要支援的環境和 Microsoft 體驗。 在測試之前授權必要的登入、同意、連線和外部服務。

針對下列命令,請安裝 Work IQ 開發工具: 其 CLI 需要 Node.js 24.15+ 和 npm,加上 Windows 上的 PowerShell 7+。

準備:

  • 已知記錄: 測試存放庫中的問題 123,其確切標題、狀態和來源記錄的 URL。
  • 技能輸入:Added CSV export; Fixed duplicate rows; Updated help text. 對於版本資訊技能,請分別期待功能、修復和其他,以及任何承諾的檔案或腳本產生的內容。

取代範例名稱、識別碼和預留位置。 在租用戶命令之前登入並檢查整備程度:

wiqd auth login --interactive
wiqd doctor

驗證:預期的租用戶登入和整備檢查成功。

如需選用助理提示,請安裝 GitHub Copilot CLI。 如果尚未安裝其 WIQD 指南外掛程式,請執行這些命令,然後在現有的外掛程式專案中啟動新的工作階段:

copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot

驗證:清查顯示已安裝且啟用的 WIQD 指南。 現有安裝應遵循安裝指南,而不是新增重複項。 本指南外掛程式不會安裝 WIQD CLI。 將助理提示貼到編碼助理工作階段;已部署代理程式要求請改為使用-q測試包含的宣告式代理程式中的選項。

測試技能

外掛程式元件: 透過 app-manifest agentSkills註冊的外掛程式層級技能。

這證明什麼: 預期的技能會在開發部署中載入並產生預期的輸出。

包裝後仍有待證明: 確切的成品會驗證、透過您的分發路線安裝,並在每個宣稱的體驗中執行。

要保留的證據: 部署/版本、載入的技能、輸入、輸出檔案和可用的遠端通話記錄。

使用 Copilot Cowork 進行開發部署。 如果有的話,重複使用其實際列印的安裝/測試連結。

  1. 如果需要佈建,請先檢查 m365agents.yml 並先在其設定 environmentFolderPath 下的所選環境檔案。 確認租用戶且有效 AGENT_SCOPE;標準腳手架用於 local 個人範圍和 dev 共用範圍,但僅名稱並不能證明。 核准建議的變更,然後執行:

    wiqd plugin provision --env "<test-environment>"
    

    驗證:佈建成功並傳回部署的安裝/測試連結。

  2. 開啟傳回的連結,並使用測試身分識別完成安裝和必要連線。 啟動 Cowork 工作階段,並使用已知輸入要求版本資訊。

    驗證:您的技能會顯示在工作階段側邊面板的「技能」下。

  3. 檢查回應和 [輸出資料夾>]、[預覽] 或 [下載] 底下的任何檔案。

    驗證:所有變更都會顯示在預定類別中,而承諾的檔案符合需求。

  4. 使用此部署和已知輸入,在每個支援的體驗中執行 探索和叫用測試 。

    驗證:探索、選取和失敗行為符合該體驗的技能需求。

個人上傳的技能會測試與外掛程式不同的 agentSkills註冊;代理程式附加技能改為在 agent_skills 宣告式代理程式資訊清單中使用。 載入技能證據不會建立每個腳本執行。

在記載的 生命週期中,佈建會在其所選範圍內建立或更新租用戶部署,並寫入環境繫結。 重複使用現有的資源身分識別可能會影響目前的使用者;授權這些變更。 佈建不會執行個別的發佈或共用命令。 安裝連結並不能證明登錄發佈、受眾可用性或最終 ZIP 的安裝。 繼續分別進行 [ 發佈 & 散發 ] 和 [提供] & 治理,包括適用的核准、安裝、同意和連線。

偏好使用 GitHub Copilot CLI?

Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.

測試遠端 MCP 連接器

外掛程式元件:agentConnectors[] 指向遠端 MCP 服務的項目。

這證明什麼: 伺服器行為獨立,然後透過開發外掛程式驗證使用。

包裝後仍有待證明: 連接器宣告、連線設定和執行階段呼叫可從確切安裝的成品運作。

要保留的證據: 端點/版本、工具架構、輸入/結果、身分識別和相互關聯的主機/伺服器記錄。

使用 MCP 檢查器 與 Node.js 22.19.0+、受信任的 Streamable HTTP 端點、其身份驗證詳細信息和安全的唯讀操作。

  1. 啟動檢查器,取代範例 URL:

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    驗證:驗證完成並顯示預期的伺服器身分識別和功能。

  2. 列出工具,選取查閱作業,輸入已知記錄的結構描述定義欄位,然後執行它。

    驗證:架構和傳回的標題、狀態和 URL 符合預期。

  3. 使用不存在的記錄和受限制的身分識別重複上述動作。

    驗證:遺失記錄行為是可採取動作的,未經授權的內容將保持無法存取。

  4. 如果需要,請使用「測試技能」中的佈建步驟,開啟開發外掛程式的 Cowork 安裝和測試連結;僅限連接器的專案不需要技能。 完成連線設定並要求相同的記錄。 如果技能應該使用連接器,請使用該請求叫用它。

    驗證:經過驗證的服務記錄會顯示預期的作業和輸入,而傳回的值會與工作階段結果相符。

  5. 僅針對一次性記錄測試任何已核准的寫入作業,包括取消。

    驗證:已核准的變更與要求相符,取消則會讓來源資料保持不變。

將元件組態中的端點和驗證參照與實際執行的內容進行比較。 遵循 連接器要求,包括適用的工具描述要求;僅靠伺服器成功並不會建立主機連線整備。

對於本機服務,請使用其專案的命令來啟動它。 核准暴露之後,請遵循建立 持續的開發通道。 針對此外掛程式連接器,請設定 remoteMcpServer.mcpServerUrl 為具有其實際 MCP 路徑的公用 HTTPS 端點;透過專案的工作流程更新其開發部署並重新測試。 保留應用程式驗證,並在測試完成時停止通道。

驗證:服務記錄會顯示在預定端點處已驗證的主機要求。

偏好使用 GitHub Copilot CLI?

Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.

測試包含的宣告式代理程式

外掛程式元件: 組合到外掛程式專案中的選用宣告式代理程式。

這證明什麼: 客服專員回應和可用的選取外掛程式、擷取和引文診斷。

包裝後仍有待證明: 封裝代理程式參考和完整的已安裝外掛程式案例可在宣告的體驗中運作。

要保留的證據: 代理程式/版本、要求/交談識別碼、選取的功能、輸入和實際輸出。

遵循 支援的外掛程式專案剖析。 針對與該元件對應的已部署代理程式,使用 Work IQ 開發工具和DevUI 。

  1. 列出代理程式並執行查閱:

    wiqd agent list
    wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    驗證:選取的代理程式和傳回值符合元件和來源記錄。

  2. 啟用記載的 DevUI 預覽旗標並重複:

    wiqd config flags set devui true
    wiqd devui start --agent "<agent-name>"
    wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    檢查選定的插件、檢索、引文和原始結果。

    驗證:可用的診斷可識別預期的功能與預期的傳回資料。

  3. 如果客服專員有附加技能,請檢查其輸出:

    wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."
    

    驗證:變更和承諾的檔案滿足技能的要求。

  4. 停止診斷伺服器:

    wiqd devui stop
    

    驗證:命令報告已停止或未執行。

DevUI 已發佈的診斷不會建立每個技能或每個指令碼叫用。 分別記錄輸出正確性。 針對其定義的行為測試代理程式特定的指示、建議的提示和範圍外請求。

偏好使用 GitHub Copilot CLI?

Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.

請參閱 已記錄的 DevUI 代理程式工作流程。

測試相依性

測試元件所依賴的服務和知識,然後重複整合的外掛程式工作。 這些相依性檢查不是額外的外掛程式元件註冊。

同步的 Copilot 連接器

相依性: 所包含代理程式使用的索引知識。

這證明什麼: 擷取、新鮮度、權限和後續擷取。

包裝後仍有待證明: 安裝的外掛程式會使用預期的連線和記錄。

要保留的證據: 連線識別碼、編目輸出、索引計數、引文數和來源值。

如需 GitHub 問題範本,請遵循 建置您的第一個同步連接器 ,以取得先決條件、存放庫設定、同意、編目和索引檢查。 對於其他實作,請使用其記載的編目和診斷程序。

  1. 確認為包含的代理程式設定的連線識別碼符合測試的連線,且已知記錄已編製索引。

    驗證:連線診斷可識別預期的來源和預期的索引項目。

  2. 查詢使用該連線設定的代理程式,然後更新置件問題、重新執行連接器,然後再次查詢。 透過其對帳路徑和套用項目權限的限制存取來測試刪除。

    驗證:值、引文、更新、刪除處理和存取比對需求。

同盟 Copilot 連接器

相依性: 在支援案例中使用的可用 同盟連線 。

這證明什麼: 在已連線身分識別下的即時擷取。

包裝後仍有待證明: 您的完整已安裝外掛程式案例會使用其預期的資料存取路徑。

要保留的證據: 身分識別、來源記錄、回應/引文和可用的服務記錄。

  1. 在 Copilot Chat 中,選取 ...>設定>Sources,尋找來源,選取 [連線],然後進行驗證。

    驗證:預期身分識別連線成功。

  2. 依來源名稱或識別碼詢問已知記錄。 更新一次性記錄並重複。 此外,請測試受限制的身分識別。

    驗證:即時變更會出現,來源權限仍會強制執行。

測試完整的使用者案例

在啟用所有必要元件的情況下,透過預期體驗執行相同的已知工作。 例如,僅當合併的工作流程是解決方案的一部分時,才要求技能擷取已知問題並產生版本資訊。

  1. 使用預期的測試身分識別和輸入開始新的交談。

    驗證:預期的技能或代理程式會處理要求。

  2. 收集 元件特定的辨識項。 針對遠端通話,請將可用的主機診斷與已驗證的服務記錄進行關聯。

    驗證:已選取預定的元件。 在需要工具的地方,它會接收正確的輸入和標識,並使用其實際輸出。

  3. 比較回應和檔案與預期結果。

    驗證:內容、引文和承諾的輸出符合要求。

測試失敗和界限

重複缺少或模棱兩可的輸入、過期的驗證、拒絕的同意、受限的資料、無法使用的相依性、空白或格式錯誤的結果、指令碼失敗、逾時、節流和重試。 確認安全、可採取動作的失敗行為和必要的確認。 在執行測試之前,記錄每個預期的結果。

記錄整合結果

每個案例和身分識別使用一筆記錄。 將其帶入 封裝測試;封裝後填入套件欄位。

欄位 保留
元件 版本、檔案、端點、連線參考和來源修訂
套件 身分、版本、ZIP 路徑和可選的 SHA256 雜湊;封裝前待處理
內容 環境、體驗/版本狀態、功能旗標、測試身分識別角色和日期
案例 必要檢查、可接受的證據、可重複的輸入,以及預期與實際結果
證據 已清理的叫用記錄、要求識別碼、輸出和報告位置
決策 通過、失敗或未驗證;必要證據差距、診斷限制、擁有者和下一步動作

包裝之前

  • 叫用: 確認預期的功能選擇和預期的輸入/輸出。
  • 存取: 完成授權/限制存取、同意和確認檢查。
  • 結果和失敗: 完成適用的 故障測試。
  • 預期體驗: 針對每個支援的發行體驗,分別記錄開發結果;規劃最終的已安裝成品檢查。
  • 交接記錄: 在封裝之前儲存 測試記錄 並解決實作障礙。
  • 套件參考: 確認測試的元件版本、檔案、識別碼、連線參考及端點都是套件將參考的項目。

後續步驟

繼續 封裝 & 測試: 建立外掛程式套件,然後使用相同的辨識項記錄和確切的封裝參考來 驗證和測試套件 。