共用方式為

使用 YAML 建置 Security Copilot 代理程式

重要事項

本文中的部分資訊與發行前版本產品有關，在產品正式發行前可能會大幅度修改。 Microsoft 對此處提供的資訊，不提供任何明確或隱含的瑕疵擔保。

本文為開發人員提供如何建置和上傳資訊清單 YAML 檔案以建立代理程式的一般指引。

若要試用 YAML 範例，請參閱 範例集合。

注意事項

此處說明的上傳 YAML 檔案的解決方案是解決方法，直到在 Agent Builder 中開發上傳 YAML 功能為止。

建置和上傳 YAML 的步驟

身為開發人員，您建立的代理程式定義可供安全分析師執行並查看結果。

若要建置代理程式資訊清單，請參考資訊清單中的屬性，請參閱 代理程式資訊清單。 您可以使用提供的範例來建置資訊清單。

如果您要自行建置代理程式，請遵循下列步驟來建置和上傳 YAML。

步驟 1：建立工具 (技能)

  1. 建立名為 的檔案 http_manifest.yaml。

  2. 您可以新增任何預先定義的工具，例如 API、 、 KQLGPT或 AGENT。

  • 對於 Format： GPT， ， APIKQL

    • 在 Skills下 ：定義名稱、描述、輸入 (如果有) 、設定。

  • 對於 Format： AGENT

    • 提供其他詳細資料，例如：
      1. 指示 - 您可以新增自然語言 (NL) 指示，以指導代理程式應如何執行工作。
      2. 子技能 ( 選擇性) - 您可以定義代理程式可用來解決業務邏輯的技能。 定義後，客服專員會使用本節中定義的技能清單來建立動態計劃並執行它。

請參閱格式和設定的資訊清單區段，請參閱 設定。

步驟 2：將 YAML 上傳為自訂外掛程式

將自訂外掛程式新增至 YAML 之後，您必須上傳檔案。

注意事項

只有在擁有者設定 Security Copilot 以允許擁有者和參與者為組織中的每個人新增和管理自訂外掛程式時，才能使用此選項。

  1. 選取 [Security Copilot 來源] 圖示。

  2. 在 [管理外掛程式] 中，向下捲動至 [自訂] 區段。

    插件自定義部分的屏幕截圖。

  3. 選取 [上傳外掛程式]。

  4. 從下拉式選項中，指定是否要讓外掛程式僅供您自己或組織中的任何人使用。 然後選擇新增 Security Copilot 外掛程式或 OpenAI 外掛程式。

    顯示將外掛程式新增為擁有者的螢幕擷取畫面。

    注意事項

    如果您選擇將外掛程式設為僅供您自己使用，則會將私人標籤新增至外掛程式。 如果您選擇將其提供給組織中的任何人的選項，則所有 Security Copilot 使用者都可以使用該插件。

  5. 根據想要新增的外掛程式，遵循相對應的步驟:

    1. 選取 Security Copilot 外掛程式。

    2. 您可以選擇上傳檔案或以連結上傳。

      • 若要上傳檔案:

        1. 選取 [上傳檔案] 區段。
        2. 選取要上傳的檔案，然後選取 [新增]。

      • 若要上傳連結:

        1. 開啟 [以連結上傳] 切換。
        2. 貼上 YAML 或 JSON 檔案的連結。
        3. 指定檔案類型。
        4. 選取 新增。

  6. 成功新增外掛程式之後，可能需要設定某些外掛程式。 您也可以選擇稍後再設定外掛程式。

  7. 為 [設定] 欄位提供適當的值，然後選取 [設定]。

    • 完成設定步驟之後，您的外掛程式會顯示在 [自訂] 區段中。
    • 選擇螢幕底部的 顯示 # 更多 選項。
    • 向下捲動以找到您的插件。
    • 您必須開啟切換開關。
    • 您可以關閉「 管理來源 」對話方塊。

注意事項

您必須完成設定步驟，外掛程式才能使用，並顯示在 「自訂」 區段中。 只有在資訊清單 YAML 具有) 定義代理程式定義 (AgentDefinitions 時，上傳的 YAML 或資訊清單才會以代理程式的形式發佈至作用中代理程式。

步驟 3：檢查權限

Security Copilot 角色控制您可以在平台上存取哪些活動，例如設定設定、指派權限和執行工作。 Security Copilot 角色是在 Copilot 中定義和管理，而且只會授與 Security Copilot 功能的存取權。 如需權限的詳細資訊 ，請參閱權限。

步驟 4：發現和設定/配置代理程式

若要在 Security Copilot 中探索代理程式，您必須依資訊清單欄位中DisplayName指定的值進行搜尋。

管理員或 Copilot 擁有者可以選擇為工作區設定、設定和啟用代理程式（如果尚未安裝）。

步驟 5：測試外掛程式 (代理程式)

測試代理程式的最簡單方法是透過 系統功能 呼叫代理程式，如下所示：

  • 如果您已登入產品，請選取導覽功能表>首頁左上角的 Microsoft Security Copilot 連結。

  • 在「Security Copilot如何提供協助？」提示列中選取提示。

  • 導覽至 [查看所有系統功能]。

  • 使用搜索欄查找並選擇您的插件。 這會在搜尋列中填入客服專員的名稱和輸入參數。

  • 選取 提交提示。 這會運行代理程式 (可能需要大約 30 - 45 秒) 。

  • 回應應該會顯示結果。

  • 您可以按一下畫面右上角的 「代理程式檢視 」按鈕，以驗證代理程式是否執行了其函數呼叫迴圈。 這會顯示客服專員用來完成任務的 決策樹 。

後續步驟

  • Last updated on