宣告式代理程式的技能

本文涵蓋附加至宣告式代理程式的技能。 若要撰寫技能以直接在 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 容器中。