秘訣
推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。
重要
在使用 Microsoft Purview 資訊屏障 (IB) 的租用戶中,系統管理員可以部署具有技能的宣告式代理程式,但使用者無法將技能新增至他們建立的宣告式代理程式。
技能是模組化元件,您可以將其新增至宣告式代理程式,以封裝特定工作的指令、資源和指令碼。 在 建置或重複使用期間,當您選擇的專案已使用 Microsoft 365 Agents Toolkit (ATK) 時,請使用本文。 您完成時將在代理程式中註冊技能、儲存的任務指令和佈建的測試版本。
對於新的專業開發人員外掛程式專案,請從 Work IQ 開發工具和文件化環境開始。 當此工具包程序的專案控制項適合您選取的客服專員路線時,請保留此工具包程序;這不是每個插件的要求。
若要瞭解什麼是技能、使用這些技能的原因,以及完整的支援矩陣、支援的檔案類型、沙箱行為和治理,請參閱 宣告式代理程式的技能。
本指南新增代理範圍技能。 若要散發技能以透過外掛程式直接在 Copilot Chat 中使用,請參閱建立 Copilot Chat 的技能。
重要
本指南假設您已完成使用 Microsoft 365 代理程式工具組和 JSON 建立宣告式代理 程式教學課程。 新增技能需要宣告式代理程式資訊清單 1.9 版。 如果您使用透過舊版 Agents Toolkit 建立的代理程式,您可能需要更新代理程式資訊清單的版本。 如需詳細資訊,請參閱宣 告式代理程式資訊清單參考。
先決條件
啟用代理程式技能
客服專員技能支援是由環境變數所 TEAMSFX_AGENT_SKILLS 控制。 在啟動 CLI 或 Visual Studio Code 之前先設定。
Windows (PowerShell) - 若要跨工作階段保存變數,請將變數新增至您的使用者環境變數:
[System.Environment]::SetEnvironmentVariable("TEAMSFX_AGENT_SKILLS", "true", "User")macOS 或 Linux - 設定變數:
export TEAMSFX_AGENT_SKILLS=true若要保存變數,請將該行
export新增至您的~/.bashrc、~/.zshrc或對等的殼層設定檔。
如果您在安裝 Visual Studio Code 擴充功能之後設定變數,請完全重新啟動 Visual Studio Code。
驗證:重新啟動的工具程序會設TEAMSFX_AGENT_SKILLS為 true。 使用者層級 Windows 設定不會變更已在執行的處理程序。
將技能新增至您的代理程式
在現有專案中新增技能。 若要建立新技能,請提供名稱和描述:
atk add skill --name skill-name --description description若要新增現有的技能資料夾,請使用下列
--from選項:atk add skill --from PATH_TO_SKILL驗證:專案包含技能目錄 和
SKILL.md,而宣告式代理程式資訊清單會參考該技能。 遵循 支援矩陣;此匯入選項不會建立跨代理程式的重複使用。使用任務說明、資源和支援的指令碼編輯技能
SKILL.md。驗證:儲存的檔案會保留其必要的中繼資料,並描述工作、預期輸出和界限。
佈建宣告式代理程式,使其在您的環境中可供使用:
atk provision --env local驗證:預定的租用戶和環境佈建成功。 在預期代理程式中測試技能的任務;佈建成功不會建立執行階段行為。
限制
在 Agents Toolkit 中,您可以將技能新增為目錄 (您無法使用 .zip) ,並且完整的應用程式套件限制為 10 MB。 您最多可以為每個代理程式新增 8 個技能,目錄深度上限為 3,所有技能最多可新增 350 個檔案。 如需完整的支援矩陣,請參閱 宣告式代理程式的技能。
發佈您的代理程式
獨立軟體廠商 (ISV) 可以提交包含技能的宣告式代理程式到 Microsoft Marketplace。 使用 Work IQ 開發工具從現有的宣告式代理程式專案驗證和建置可提交套件。 針對外掛程式套件, wiqd publish pc 可以建立合作夥伴中心供應項目、填入草稿清單、上傳套件和影像、使用個別授權提交認證,以及追蹤狀態。 合作夥伴中心帳戶註冊和驗證仍然是入口網站步驟,而 Microsoft 會控制認證和發佈。
使用 WIQD 追蹤發佈至合作夥伴中心 ,以取得先決條件、套件驗證、清單設定、提交和狀態追蹤。 門戶提交仍然是一種替代方案;請參閱 Microsoft Marketplace 提交指南。 請遵循已確認的代理程式提交路由,而不是 Office 增益集範例或撰寫外掛程式的假設供應項目類型。
後續步驟
輸入 封裝 & 使用 整合和測試您的元件進行測試。 當代理程式準備好公開發佈時,請繼續 透過 Microsoft Marketplace 發佈。