共用方式為


新增下層 Agent

子 Agent 是一種輕量級 Agent,存在於您主 Agent 的情境中。 子 Agent 讓您能將工具、指令和知識邏輯地歸類為明確定義的子 Agent,並置於更大的 Agent 中。 它們非常適合針對單一用途,回應單一意圖或完成單一任務。 本文說明如何建立和管理子 Agent。

建立子 Agent

  1. 前往主 Agent 的 Agent 頁面,然後選取新增 Agent

  2. 選擇新子 Agent

  3. 為您的新子 Agent 輸入一個獨特的名字。

  4. 判斷何時使用您的 Agent。 預設情況下,Agent 會根據使用者或觸發程序的描述來回應。

    • 如果您想使用預設行為 (Agent 選擇 - 根據描述),請輸入 Agent 的簡短目的說明。
    • 否則,請在何時使用?下展開清單,並選擇想要的行為。 欲了解更多支援行為的資訊,請參閱判斷何時使用您的 Agent
  5. 輸入您希望 Agent 在叫用時遵循的明確指示。 若要參考工具、變數或在說明中新增 Power Fx 公式,請輸入斜杠 (/) 並從出現的選單中選擇想要的選項。

    重要

    在說明中提及現有工具時,請決定該工具是否應該由主要 Agent 直接存取,或僅在說明中明確呼叫時才能使用。 將工具的使用方式限制於明確的指令參考,有助於防止存在類似工具或 Agent 時產生混淆。 例如,如果您有一個「Check Account Balance」Agent 和類似的「取得帳戶餘額」工具,可以限制該工具只能由 Agent 呼叫,以避免重複使用。 若要將工具限制為只有在從另一個 Agent 參考時才能使用,請在工具的詳細資料頁面上,清除其他詳細資料區段中的允許 Agent 動態決定何時使用此工具屬性。

  6. 可選擇性地加入只有這個子 Agent 才會使用的知識和工具:

    • 知識區塊中,選擇 新增,並以與加入知識到主 Agent 相同的方式繼續操作。
    • 知識區塊中,選擇 新增,並以與加入知識到主 Agent 相同的方式繼續操作。
  7. 如果您還不希望此 Agent 處於使用中狀態,請關閉已啟用。 您可以之後再讓子 Agent 啟用

  8. 選取儲存

管理輸入和輸出

預設情況下,子 Agent 在主 Agent 呼叫時會接收到一個自然語言任務來完成。 完成任務後,會回傳執行過程中發生的自然語言摘要。 在某些情況下,您可能想為 Agent 指定更明確的輸入和輸出值。

管理輸入

  1. 請前往子 Agent 的詳細資料。

  2. 向下捲動到輸入區段。

  3. 要新增輸入,請選擇新增輸入。 定義顯示名稱描述,幫助 Agent 了解輸入的目的,以便在呼叫該 Agent 時填入相關值。

  4. 選取資料類型

  5. 選擇「使此輸入必須」 ,要求該輸入必須有值,才能呼叫 Agent。

  6. 選取儲存

注意

您可以選擇展開進階區塊,並設定其他輸入設定,包括應該提示使用者選項。 如果啟用了設定,Agent 會明確向終端使用者詢問輸入值,若在可用上下文中找不到。 請參閱更多關於其他輸入設定的詳細資訊。

管理輸出清單

  1. 請前往子 Agent 的詳細資料。

  2. 向下捲動到輸出區段。

  3. 要查看目前的輸出清單,請展開輸出區塊中的進階區。

  4. 要新增輸出,請選擇新增輸出。 定義顯示名稱描述,這有助於子 Agent 理解輸出的用途,從而在將值回傳給呼叫 Agent 時填入相關的內容。

  5. 選取資料類型

  6. 選取儲存

輸出 區塊中,您也可以選擇在子 Agent 完成後立即發送訊息給使用者。 要發送訊息,請更改執行後的選擇。

決定何時使用您的 Agent

預設情況下,子 Agent 會根據使用者的描述回應使用者查詢。 您也可以設定子 Agent 攔截其他事件並回應,分類為何時會使用?

事件 描述
收到訊息 收到消息活動 (最常見的活動類型) 時調用。 當使用者輸入或向 Agent 說某事時收到。 預設情況下,Agent會回應任何訊息。 若要限制 Agent 回應至特定類型的訊息,請使用額外細節中的活動類型清單。
發生自訂用戶端事件 收到事件活動時調用。 預設情況下,Agent 會回應任何事件。 若要限制 Agent 對特定事件的回應,請在額外細節中使用事件名稱屬性。
活動發生 在收到任何類型的活動時呼叫。 若要限制 Agent 回應至特定類型的訊息,請使用額外細節中的活動類型清單。
交談變更 當收到對話更新活動時會被呼叫。 例如,當使用者加入交談時,Teams 會傳送此類活動。
已叫用 在接收到呼叫活動時觸發。 最常見的是從 Teams 頻道接收,例如,當使用者與 Teams 中的訊息或搜尋擴充功能進行互動時。
它已重新導向到 在明確從主題中呼叫 Agent 時呼叫
該使用者有一段時間處於非使用中狀態 當使用者在設定一段時間後未與主 Agent 互動時,才會被呼叫。 從額外細節非活動期間清單中選擇所需的非活動門檻。
方案完成 在主要 Agent 完成執行所有規劃步驟以回應使用者查詢或自主觸發程序時呼叫。
AI 生成的回覆即將傳送 當主 Agent 在呼叫一個或多個主題、工具或知識來源後,為使用者產生回應時,會被呼叫。 使用 Response.FormattedText 系統變數來查看產生的回應。 若要防止發送協調流程回應 (即修改訊息後使用訊息節點自行發送),請將 ContinueResponse 變數設為 false。

其他詳細資料

根據您選擇的何時使用?,可能會有更多屬性可供選擇。 可用的屬性如下:

條件

指定必須符合的條件,才能呼叫該 Agent。 例如,您可能希望只有在員工使用的管道是 Microsoft Teams 時才會呼叫 Agent。

將子系 Agent 範圍限制為 Microsoft Teams 管道的條件的螢幕擷取畫面。

若需設定更複雜的條件,可切換至 Power Fx 公式編輯工具:選擇組建工具後再選取公式

螢幕擷取畫面顯示了前往公式編輯器的選項。

優先順序

多個 Agent 可以針對單一接收活動 (例如訊息) 引發。 預設情況下,您選取的何時使用?選項決定 Agent 引發的順序。

子系 Agent 和主題共用同一組其可回應的觸發程序或事件。 如果 Agent 和主題設定為回應相同事件,例如使用者不活躍,請使用優先權屬性決定哪一個先發生。

執行順序:

  1. 活動發生
  2. 收到訊息時 / 發生自訂客戶端事件時 / 對話內容變更時 / 已叫用
  3. Agent 選擇

如果必須根據相同類型的事件呼叫多個 Agent 或主題,則依建立順序 (最早的先) 呼叫。

您可以明確設定優先權屬性。 數位越小表示優先順序越高。