建置宣告式代理程式

在 建置或重複使用期間,實作 元件計劃中選取的宣告式代理程式元件。 本文可協助您選擇產品程序,並確認元件的準備就緒。 您完成工作代理程式、其相依性,並測試外掛程式整合的證據。

您不需要每個插件都有代理。 針對您自己的協調流程、模型、裝載或執行階段,請改為遵循 應用程式路徑 。

建立現有代理程式之前先檢查一個代理程式

  1. 檢閱現有客服專員的預定使用者、支援的經驗、指示、知識、動作、權限,以及與其擁有者的已知限制。

    驗證:其記載的功能與元件計劃中的任務和目標體驗相符。

  2. 選取產品已記錄的重複使用或延伸路徑。 您可以從代理程式範本開始,或在工作流程適合時將 Agent Builder 代理程式複製到 Copilot Studio。

    驗證:路線支援您的來源和目的地。 請勿假設將代理程式元件新增至外掛程式會匯入現有專案。

  3. 就擁有權、版本設定、支援和變更管理達成一致,然後測試代表性工作。

    驗證:在決定使用原封不動、設定代理或建置新元件之前,請記錄結果和未解決的差距。

從 Work IQ 開發工具開始

對於專業發展,請從 Work IQ 開發工具開始,選擇 記錄的環境,並僅在您的元件需要其特定專案控制時才新增 Agents Toolkit。

您的起點 產品程序 預期的結果
需要代理程式元件的新外掛程式 使用 Work IQ 開發工具建置外掛程式 wiqd plugin create 建立容器; wiqd plugin add agent Scaffold 選用代理程式元件。
現有的宣告式代理程式來源專案 代理程式元件生命週期 使用記載 wiqd agent 的命令繼續執行代理程式特定的撰寫和反覆運算。
需要編輯的代理程式指示、知識或動作 WIQD 中的宣告式代理程式 和 命令參考 為所選元件和環境設定的儲存來源。

使用 WIQD 編碼助理外掛程式進行引導式工作,或使用直接 CLI 進行可重複的命令。 需要時,安裝編碼助理外掛程式和 CLI 作為單獨的先決條件。 GitHub Copilot 可協助撰寫檔案、指示、設定和測試;它不會取代撰寫工具、執行時間或元件需求。

對於現有的代理專案,明確選取離線驗證:

wiqd agent validate --mode source --env dev

驗證:閱讀儲存來源的發現項目並修正報告的錯誤。 通過的來源檢查不會建立執行階段行為、端點可連線性、驗證正確性或最終套件接受。 預設 package 模式會使用現有的 ZIP、上傳它以進行驗證,而且可能需要登入。

若要將技能新增至現有的 WIQD 代理程式專案,請檢查agent-skills代理程式技能命令參考中的功能旗標和目前結構描述需求。 頂層外掛程式技能和附加至宣告式代理程式的技能是不同的註冊;兩者都不會在每個主機中建立支援。

當它適合元件時,使用其他產品路線

需求 產品程序
Microsoft 365 Copilot 中的受管理撰寫 代理程式建立器概觀和組建代理程式
低程式碼邏輯、受管理環境或 Power Platform 連接器 Copilot Studio 和連線並設定 Teams 和 Microsoft Copilot 的代理程式
較低層級的代理程式資訊清單與支援的開發整合 針對支援的專業程式碼案例,建議使用 Work IQ 開發工具 ()
現有工具組代理程式中的技能 使用 Agents Toolkit 新增技能

獨立 Copilot Studio 代理程式會顯示在代理程式登錄中,而不是外掛程式中。 不要假設發佈獨立代理程式會將其重新封裝為外掛程式。

設定並測試代理程式

如需詳細的實作步驟,請遵循宣告式代理程式產品指引:

完成的工作 權威指導 驗證
定義身分識別、行為、工作界限和交談入門人 建置代理程式 或 使用 JSON 建置,然後 撰寫有效的指示 代表性提示會產生預期的行為,並停留在預期的工作範圍內。
設定知識與功能 知識來源 和 新增功能和自訂動作 必要資料可供預期使用者使用,且在權限不允許時無法使用。
新增支援的 MCP 或 API 動作 宣告式代理程式的 MCP 和 API 外掛程式 工具選取、驗證、同意、確認、錯誤和不支援的要求皆如預期般運作。
新增支援的技能 宣告式代理 程式和所選撰寫程序的技能 目標代理程式載入技能並在該產品的限制內完成定義的任務。
管理撰寫路由的設定 工具組環境和版本 或 WIQD 環境 識別值、相依性和設定屬於預期的測試環境。

記錄代理程式版本、擁有者、支援的體驗、相依性、已知限制和測試結果。 需要針對特定產品進行測試;通過來源或套件驗證並不能證明每個使用者都可以執行該工作。

如需設計指導方針,請參閱 宣告式代理程式的最佳做法 和 Copilot 協調器選擇動作的方式。 當所需行為運作時,您可以選擇性 地啟用使用者意見反應 並 最佳化內容擷取。

後續步驟

繼續 建置或重複使用任何剩餘的元件。 當它們準備就緒時,輸入 封裝 & 使用 [整合和測試您的元件] 進行測試。