子 Agent 是一種輕量級 Agent,存在於您主 Agent 的情境中。 子 Agent 讓您能將工具、指令和知識邏輯地歸類為明確定義的子 Agent,並置於更大的 Agent 中。 它們非常適合針對單一用途,回應單一意圖或完成單一任務。 本文說明如何建立和管理子 Agent。
建立子 Agent
前往主 Agent 的 Agent 頁面,然後選取新增 Agent。
選擇新子 Agent。
為您的新子 Agent 輸入一個獨特的名字。
判斷何時使用您的 Agent。 預設情況下,Agent 會根據使用者或觸發程序的描述來回應。
- 如果您想使用預設行為 (Agent 選擇 - 根據描述),請輸入 Agent 的簡短目的說明。
- 否則,請在何時使用?下展開清單,並選擇想要的行為。 欲了解更多支援行為的資訊,請參閱判斷何時使用您的 Agent。
輸入您希望 Agent 在叫用時遵循的明確指示。 若要參考工具、變數或在說明中新增 Power Fx 公式,請輸入斜杠 (/) 並從出現的選單中選擇想要的選項。
重要
在說明中提及現有工具時,請決定該工具是否應該由主要 Agent 直接存取,或僅在說明中明確呼叫時才能使用。 將工具的使用方式限制於明確的指令參考,有助於防止存在類似工具或 Agent 時產生混淆。 例如,如果您有一個「Check Account Balance」Agent 和類似的「取得帳戶餘額」工具,可以限制該工具只能由 Agent 呼叫,以避免重複使用。 若要將工具限制為只有在從另一個 Agent 參考時才能使用,請在工具的詳細資料頁面上,清除其他詳細資料區段中的允許 Agent 動態決定何時使用此工具屬性。
可選擇性地加入只有這個子 Agent 才會使用的知識和工具:
如果您還不希望此 Agent 處於使用中狀態,請關閉已啟用。 您可以之後再讓子 Agent 啟用。
選取儲存。
管理輸入和輸出
預設情況下,子 Agent 在主 Agent 呼叫時會接收到一個自然語言任務來完成。 完成任務後,會回傳執行過程中發生的自然語言摘要。 在某些情況下,您可能想為 Agent 指定更明確的輸入和輸出值。
管理輸入
請前往子 Agent 的詳細資料。
向下捲動到輸入區段。
要新增輸入,請選擇新增輸入。 定義顯示名稱與描述,幫助 Agent 了解輸入的目的,以便在呼叫該 Agent 時填入相關值。
選取資料類型。
可 選擇「使此輸入必須」 ,要求該輸入必須有值,才能呼叫 Agent。
選取儲存。
注意
您可以選擇展開進階區塊,並設定其他輸入設定,包括應該提示使用者選項。 如果啟用了設定,Agent 會明確向終端使用者詢問輸入值,若在可用上下文中找不到。 請參閱更多關於其他輸入設定的詳細資訊。
管理輸出清單
請前往子 Agent 的詳細資料。
向下捲動到輸出區段。
要查看目前的輸出清單,請展開輸出區塊中的進階區。
要新增輸出,請選擇新增輸出。 定義顯示名稱和描述,這有助於子 Agent 理解輸出的用途,從而在將值回傳給呼叫 Agent 時填入相關的內容。
選取資料類型。
選取儲存。
在 輸出 區塊中,您也可以選擇在子 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。
若需設定更複雜的條件,可切換至 Power Fx 公式編輯工具:選擇組建工具後再選取公式。
優先順序
多個 Agent 可以針對單一接收活動 (例如訊息) 引發。 預設情況下,您選取的何時使用?選項決定 Agent 引發的順序。
子系 Agent 和主題共用同一組其可回應的觸發程序或事件。 如果 Agent 和主題設定為回應相同事件,例如使用者不活躍,請使用優先權屬性決定哪一個先發生。
執行順序:
- 活動發生
- 收到訊息時 / 發生自訂客戶端事件時 / 對話內容變更時 / 已叫用
- Agent 選擇
如果必須根據相同類型的事件呼叫多個 Agent 或主題,則依建立順序 (最早的先) 呼叫。
您可以明確設定優先權屬性。 數位越小表示優先順序越高。