本文涵蓋附加至宣告式代理程式的技能。 若要撰寫技能以直接在 Microsoft 365 Copilot Chat 中使用,而不需建立代理程式,請參閱組建 Copilot Chat 的技能。 本文中的支援矩陣適用於代理範圍的技能,而非所有技能或外掛程式套件。
重要
在使用 Microsoft Purview 資訊屏障 (IB) 的租用戶中,系統管理員可以部署具有技能的宣告式代理程式,但使用者無法將技能新增至他們建立的宣告式代理程式。
技能是一種模組化功能,您可以將其新增至宣告式代理程式,以協助其更可靠且可重複地完成特定工作。 技能是包含必要 SKILL.md 檔案以及選用資源檔案和指令碼的檔案目錄。 檔案 SKILL.md 包含指示模型完成工作的指示。
技能是宣告式代理程式的獨特組成部分。 在先前的指引中, 「技能 」一詞指的是您在客服專員的指示中內嵌撰寫的任務描述。 技能取代了這種方法:您不是直接在說明中寫入任務詳細資訊,而是將其封裝為代理參考的單獨元件。 如需指示應如何參考技能的指導方針,請參閱 撰寫宣告式代理程式的有效指示。
您可以使用 Agent Builder 將技能新增到宣告式代理程式。 針對支援的專業程式碼案例,建議使用 Work IQ 開發工具 。 其 wiqd agent add skill 路由需要 agent-skills 功能旗標,預設為關閉;請參閱 選擇技能實作路徑。 工具 組型逐步解說 仍然適用於現有的工具組專案。
什麼是技能
技能是具有下列內容的目錄:
- 包含下列內容的必要
SKILL.md檔案:- YAML 前事中的技能名稱和描述。
- 技能指示,必須少於 20,000 個字元。
- 選擇性資源檔,例如範本、參考資料或定義。
- 選擇性指令碼和支援資料夾。
例如,財務團隊可能會建立季度業務審查技能,該技能捆綁了製作審查的指示、轉換資料和生成圖表的腳本,以及財務模型、KPI 定義和品牌幻燈片範本等資產。 當使用者要求該工作時,代理程式會使用該技能。
為什麼要在宣告式代理程式中使用技能
技能可協助您建立更可靠、可重複的客服專員工作流程:
- 優化上下文使用並改進準確性。 技能使用漸進式揭露:只有當任務需要時,模型才會將技能的指令和內容載入上下文中。 即使代理的技能庫不斷增長,代理的上下文仍然集中。 提供指令碼,而不是依賴模型產生的程式碼,也為您的工作流程帶來了更多的可重複性。
- 縮放指令而不會造成品質損失。 您可以將複雜的指令分解為模組化、可重複使用的技能。 此方法可讓您提供更長、更具體的指引,而不會降低遵循指令的品質,也不會達到宣告式代理程式指令的 8,000 個字元限制。
- 封裝可重複使用的資產。 您可以將指令、資源和指令碼封裝在一起作為技能,並將該功能整合到宣告式代理程式中。
- 企業就緒。 指令碼在安全的沙箱中執行,技能檔案上的敏感度標籤會保留並遵守,並且系統管理員治理可供使用。
支援矩陣
某些限制會因您使用 Agent Builder 或 Agents Toolkit 新增技能而有所不同。
下表描述這兩個撰寫路徑,而非 WIQD 限制或功能涵蓋範圍。 對於建議的專業代碼路由,請確認 WIQD 文件中的目前需求。
| 項目 | 代理程式建立器 | Agents Toolkit |
|---|---|---|
| 每個代理程式的最大技能 | 8 | 8 |
| 技能套件 | 壓縮, .zip最大 50 MB |
技能目錄; .zip 不支援 |
| 檔案大小上限 | 每個檔案 25 MB | 沒有技能等級限制;完整的應用程式套件限制為 10 MB |
| 每個套件的檔案數量上限 | 涵蓋所有技能的 350 個檔案 | 涵蓋所有技能的 350 個檔案 |
| 從個別上傳建立技能 | 不支援;上傳完整的 .zip |
新增或匯入完整的技能目錄 |
| 目錄階層 | 目錄深度上限為 3 | 目錄深度上限為 3 |
| 跨代理程式重複使用 | 不支援 | 不支援 |
支援的檔案和指令碼類型
技能可以包含下列檔案類型:
| 類別 | 檔案類型 |
|---|---|
| 指示和資源檔 |
.json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log |
| 指令碼和二進位檔 |
.py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash |
指令碼執行沙箱
技能指令碼在安全沙箱中執行,但有下列限制:
| 功能 | 支援 |
|---|---|
| 從指令碼存取網際網路或網路 | 不支援。 沙箱在執行階段沒有網路存取權。 |
| 套件安裝 | 不支援。 技能無法在執行階段安裝套件。 |
| 來自指令碼的已驗證網路呼叫 | 不支援。 |
| 預先安裝的套件 | 技能可以使用沙箱中已存在的套件。 除非確認套件可用性,否則不要依賴套件。 |
| 連接器、API 外掛程式和 MCP 伺服器 | 代理程式可以透過協調器使用已啟用的功能。 指令碼無法透過沙箱呼叫它們。 |
敏感度和儲存空間
| 項目 | 支援 |
|---|---|
| 敏感度標籤 | 沙箱會保留敏感度標籤並遵守標籤原則。 不支援使用者定義權限或雙重金鑰加密。 |
| 儲存空間 | 系統會將上傳的技能檔案儲存在租用戶範圍的 SharePoint Embedded 容器中。 |