使用連接Agent,讓您的主要Agent將特定工作委派給專門Agent。 本文將教你如何新增另一位已發佈的 Copilot Studio 代理作為連結代理,並驗證委派是否如預期運作。
Note
用來建置此代理的框架採用基於使用量的計費方式。 使用、建置、測試和評估代理程式可能會消耗 Copilot 點數。 了解更多請參閱 使用量基礎計費概覽。
你可以從同一個新增已連接的代理對話方塊新增所有已連接的代理。 無論代理是在 Copilot Studio 內建、託管於 Microsoft Foundry,或是透過 Agent2Agent(A2A)協定存取,皆適用此指引。 本文介紹如何與 Copilot Studio 代理程式建立連線。 若要連接 Microsoft Foundry 代理程式,請參見「新增 Foundry 代理作為已連接代理」。 若要透過 A2A 協定連接遠端代理,請參見「新增 A2A 代理作為已連接代理」。 若要連接使用 Microsoft 365 Agents SDK 建置的代理程式,請參見 新增 Microsoft 365 Agents SDK 代理程式作為連線代理程式。
Prerequisites
- 一個使用 Microsoft Copilot harness 建立的代理,作為主要代理。 請參閱建立Agent(預覽版)。
- 同一環境中至少還有一個由 Microsoft Copilot harness 驅動的代理程式。 另一個代理程式必須已發佈,並設定為可供連線。
- 主要代理程式的建立者必須是已連線代理程式的擁有者,或是該代理程式已與其共用。
共享與連接器存取
對於由 Microsoft Copilot 線束驅動的代理程式,與使用者共用主要(父)代理,允許該代理代表使用者呼叫其連接的 Copilot Studio 代理程式。 你不需要分別將每個連接的代理程式分享給該使用者,透過父代理程式進行委派即可運作。 建立者仍需具備 必要條件中所述的存取權,才能新增連接代理。
共享要求會因 harness 而異:
| 利用 | 連接代理委派的共享要求 |
|---|---|
| Microsoft Copilot harness | 將父代理程式分享給目標使用者或群組。 每個連接的 Copilot Studio 代理不需要分別與這些使用者共用,父代理程式即可叫用它。 |
| 標準 harness(經典體驗) | 根據認證設定,你可能需要將已連接的代理人另外分享給父代理人的終端使用者。 在「連線到現有的 Copilot Studio 代理程式」中了解更多。 |
呼叫連接代理的權限,並不等同於存取其工具所用資料的權限。 對該資料的存取仍受連接代理的連線存取控制清單(ACL)及每個連線所使用的身份權限所規範。 共用父代理不會覆蓋這些控制。
Important
若要限制連接代理工具存取呼叫使用者被允許存取的資料,請設定其工具使用 使用者認證。 如果工具使用 Agent 作者認證,它會使用作者提供的憑證,並能透過父裝置回傳使用者無法用自身憑證存取的資料。 不要依賴將已連線的代理程式保持為未分享狀態來限制這些資料。 在分享父項目前,先檢查它的認證設定和連線權限。 在 「為工具設定使用者認證」中了解更多。
新增 Copilot Studio 代理
請登入Copilot Studio。
選擇並開啟你想設為主要代理程式的代理程式。
在代理導覽列中,選擇 「建置 」標籤。
在元件面板中,選取連接的Agent,以開啟新增連接的Agent對話框。
在「新增已連接的代理人」對話框中,瀏覽或搜尋可用的 Copilot Studio 代理人,並選擇你想要連接的代理人。
檢視代理程式的功能,然後新增一段清楚的說明,指出何時應使用該已連線的代理程式。
選擇 連線。
確認已連線的代理程式顯示在元件面板中。
編排器如何路由至已連線的代理程式
新增連接的Agent後,編排執行階段會自動判斷何時將工作委派給它。 路由決策基於:
- 已連線的代理程式名稱與說明
- 使用者的訊息與對話上下文
- 您的主要Agent指示
Tip
為每個連接的Agent撰寫明確且具體的描述,讓編排器能準確判斷何時將請求路由到該Agent。 避免已連接的代理程式之間出現描述重疊。
委派測試
新增已連線的代理程式後:
於Agent導覽欄,選取 預覽索引標籤。
傳送一則符合已連接代理程式網域的訊息。
確認回覆來自連接的Agent且適當。
發送訊息到連接客服的網域外,確認你的主要客服是否會處理該訊息。
測試分享與資料存取
同時也測試委派作為預期的最終使用者,而不僅僅是作為製造商:
將已發佈的父代理分享給測試使用者,且不要另外與該使用者分享已連接的代理。
作為該使用者,向父方發送需要已連接代理的請求。 確認父項是否能呼叫它。
對於設定為使用者 驗證的連接代理工具,測試使用者可存取與不允許存取的資料請求。 確認允許的資料有回傳,且沒有被限制資料。
如果任何連接代理工具使用 代理作者認證,請確認這些憑證回傳的資料是否適合所有能使用父代理的人。