在 Agent Builder 中將技能新增至宣告式代理程式

技能是模組化、可重複使用的元件,您可以將其新增至宣告式代理程式,以協助其執行特定的封裝工作。 技能是一個目錄,其中包含包含說明的必要 SKILL.md 檔案,以及選用的資源檔案和指令碼。 本文說明如何透過以自然語言描述技能或上傳技能套件,將技能新增至 Agent Builder 內建的代理程式。

若要瞭解什麼是技能、使用這些技能的原因,以及完整的支援矩陣、支援的檔案類型、沙箱行為和治理,請參閱 宣告式代理程式的技能。

如需在沒有代理程式的情況下直接在 Copilot Chat 中使用的個人技能,請參閱建立 Copilot Chat 的技能。 本文中的上傳步驟和限制適用於 Agent Builder,而非個人 Chat 上傳。

重要

在使用 Microsoft Purview 資訊屏障 (IB) 的租用戶中,系統管理員可以部署具有技能的宣告式代理程式,但使用者無法將技能新增至他們建立的宣告式代理程式。

先決條件

  • 符合資格的 Microsoft 365 訂閱,可提供 Microsoft 365 Copilot Chat 的存取權。 不需要 Microsoft 365 Copilot 附加元件授權。 某些代理程式功能需要 Microsoft 365 Copilot 授權或隨用隨付。 如需詳細資料,請參閱代理 程式功能和授權模型。

注意

在 Agent Builder 中,每個代理程式最多可以新增 8 個技能,每個技能套件都是最大 50 MB 的壓縮 .zip 檔案。 如需完整的支援矩陣和限制,請參閱 宣告式代理程式的技能。

從描述建立技能

您可以要求 Agent Builder 從自然語言描述建立可重複使用的技能。

  1. 在 Copilot 聊天中,選取 [ 代理程式] & [技能],然後選取 [新增代理程式]。

  2. 選取 [訊息代理程式建立器 ] 文字方塊,並要求代理程式建立器建立可重複使用的工作流程。

    Create an agent that helps my team write release notes. Add a reusable skill that always follows the same steps:
    
    1. Takes a list of merged changes (a pasted list or an uploaded  .csv  of PR titles).
    2. Groups them into Features, Fixes, and Other.
    3. Runs a script to format them into a clean Markdown changelog with a version heading and today's date.
    
    Package this as a skill with clear instructions and the formatting script so the output looks the same every time.
    

    Agent Builder 提示建立代理程式的螢幕擷取畫面

  3. 在 [設定 ] 索引標籤上,確認已建立技能。

    Agent Builder 中 [設定] 索引標籤的螢幕擷取畫面,其中顯示已附加的技能

  4. 選取技能以檢閱其詳細資料。

    新增技能詳細資料的螢幕擷取畫面

如果未新增技能,您可以 上傳技能套件來明確新增技能。

上傳技能套件

若要新增技能套件,請先建立套件,然後將其上傳到 Agent Builder 中。

建立您的技能套件

在 Agent Builder 中新增技能之前,請將技能封裝為 .zip 包含下列內容的檔案:

  • 必要的 SKILL.md 檔案。
  • YAML 前事中的 SKILL.md 技能名稱和描述。
  • 選用支援的資源檔。
  • 選用支援的指令碼和支援資料夾。
  • 20,000 字元以下的技能說明。

您的套件類似下列目錄結構:

my-skill.zip
|-- SKILL.md              # required
|-- <resource files>      # optional
`-- <scripts or folders>  # optional

如需支援的檔案和指令碼類型,請參閱 支援的檔案和指令碼類型。

重要

上傳完整的 .zip 套件。 請勿自行上傳 SKILL.md 。

上傳您的技能套件

  1. 在 Agent Builder 中開啟或建立宣告式代理程式。

  2. 在 [設定 ] 索引標籤上,展開 [技能],然後選取 [ 新增]。

    Agent Builder [設定] 窗格的 [技能] 區段中 [新增] 按鈕的螢幕擷取畫面

  3. 上傳完整的 .zip 技能套件。

  4. 檢閱技能名稱、描述、指示和包含的檔案。

  5. 在 [試試看 ] 索引標籤上,嘗試應該使用該技能的提示。