使用連接Agent,讓您的主要Agent將特定工作委派給專門Agent。 本文將教你如何連接現有的 Microsoft Foundry agent,讓你的主要 agent 能將任務交接給它。
Note
用來建置此代理的框架採用基於使用量的計費方式。 使用、建置、測試和評估代理程式可能會消耗 Copilot 點數。 了解更多請參閱 使用量基礎計費概覽。
你從同一個新增 已連接的代理 對話框新增所有已連接的代理。 關於已連線代理程式的概述及路由運作方式,請參閱 已連線代理程式概述。 若要連接另一位 Copilot Studio 代理,請參見「新增一位 Copilot Studio 代理為已連結代理。 若要透過 Agent2Agent (A2A) 協定連接遠端代理,請參見 「新增 A2A 代理作為已連接代理」。 若要連接使用 Microsoft 365 Agents SDK 建置的代理程式,請參見 新增 Microsoft 365 Agents SDK 代理程式作為連線代理程式。
Prerequisites
- 一個使用 Microsoft Copilot harness 創建的代理,作為主要代理。 請參閱建立Agent(預覽版)。
- 在 Microsoft Foundry 入口網站 的專案中建立的現有 Foundry 代理,已啟用活動通訊協定,且可取得代理的代理程式識別碼。 Foundry 代理預設沒有啟用活動協定。 請參閱 「啟用你的 Foundry 代理上的活動協定」。
- 承載 Foundry 代理之 project 的 Azure AI Project 端點 URL。
- 存取 Foundry 專案的權限。 連線會用你的 Microsoft Entra ID 使用者登入來驗證。
Note
你只能連接到目前 Microsoft Foundry 入口網站中建立的代理程式。 連接到先前入口網站中建立的代理程式會傳回 404 - Version not found 錯誤。
新增 Foundry 代理
請登入Copilot Studio。
選擇並開啟你想設為主要代理程式的代理程式。
在代理導覽列中,選擇 「建置 」標籤。
在元件面板中,選取連接的Agent,以開啟新增連接的Agent對話框。
在對話框中,選擇 「新增」,然後選擇 「新增 Foundry agent」。
在「Connect to Azure AI Foundry」步驟中,選擇此代理用來連接 Microsoft Foundry 的連線:
- 從連線清單中選擇一個現有的連線。
- 若無可用連線,請選擇 建立新連線 並繼續下一步。
如果你正在建立一個新連線,請輸入連線細節,然後選擇 建立:
- 顯示名稱 (可選):一個幫助你日後辨識此關聯的名稱。
- 認證類型:Microsoft Entra ID 使用者登入。 這個值已為您設定。
- Azure AI Project 端點:承載代理程式的 Foundry Project 的端點網址。
回到「Connect to Azure AI Foundry」步驟,確認你的連線已被選中,然後選擇「下一步」。
在 審查與新增 步驟中,輸入你想連結的 Foundry 代理的詳細資訊,然後選擇 新增到代理:
- 名稱:顯示給代理人作者的名字。
- 說明:明確說明何時應使用該 Foundry 代理人。 編排器會利用這個描述來決定何時將請求路由給代理,因此請使其具體且避免與其他工具和代理重疊。 欲了解更多資訊,請參閱撰寫有效中繼資料。
- Agent ID:你想連接的 Foundry 代理程式 ID。
確認已連線的代理出現在元件面板的 已連接代理 中。
Note
你有責任在特定使用情境中仔細審查與測試連接代理,並做出所有適當的決策與客製化。 當您連線到 Copilot Studio 以外的 Agent 時,您必須對這些 Agent 的使用負責。 考量包括確保:
- 資料流、資料處理及代理間資料共享適合您的使用情境,並符合相關要求與法律。
- 代理人符合適當的品質、可靠性、安全性及可信度標準。
- 若對您的使用案例而言合適,系統會配置適當的權限、邊界和核可。
- 適當的可觀察性、身份與可追溯性,以及人工監督功能都已到位。
在您的 Foundry 代理程式上啟用 Activity 通訊協定
Copilot Studio 透過 Activity 通訊協定 與連接的 Foundry 代理程式通訊。 Foundry 代理預設沒有啟用此協定,因此你必須先啟用它,才能讓主要代理與 Foundry 代理交換訊息。 如果 Activity 協定沒有啟用,你仍然可以新增連線,但呼叫 Foundry 代理程式會失敗。
您可以透過以下任一方式啟用活動協定:
將 Foundry 代理發佈到 Microsoft 365 或 Microsoft Teams。 當你向 Microsoft 365 或 Teams 發布提示代理時,活動協定及所需的
BotServiceRbac授權方案會自動啟用。 如果你已經打算將代理程式發佈到這些管道,請選擇此選項。用 REST API 呼叫手動啟用。 如果你沒有將代理程式發佈到 Microsoft 365 或 Teams,請呼叫 Foundry Agents - Update agent REST API,將
BotServiceRbac協定和activity授權方案加入代理程式。
欲了解更多關於配置與分享 Foundry 代理人的資訊,請參閱「配置與分享您的 Microsoft Foundry 代理人」。
透過 REST API 呼叫啟用 Activity 協定
呼叫 Foundry Agents - Update agent REST API。 將 {{agent_name}}、{{token}} 和 {{endpoint}} 替換為你的 Foundry 專案的端點、代理程式名稱和存取權杖。
Important
在清單中保留 responses 和 Entra 移除它們會導致從 Foundry 入口網站或 SDK 與代理聊天的功能失效。
PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: Bearer {{token}}
Content-Type: application/merge-patch+json
Foundry-Features: AgentEndpoints=V1Preview
{
"agent_endpoint": {
"protocols": [
"responses",
"activity"
],
"authorization_schemes": [
{
"type": "Entra",
"isolation_key_source": {
"kind": "Entra"
}
},
{
"type": "BotServiceRbac"
}
]
}
}
策劃者如何將要求路由至 Foundry 代理人
加入 Foundry 代理後,編排執行時會自動決定何時委派給它。 路由決策基於:
- 已連線的代理程式名稱與說明
- 使用者的訊息與對話上下文
- 您的主要Agent指示
Tip
為 Foundry 代理撰寫清晰且具體的描述,讓協調者能準確判斷何時將請求路由到它。 避免已連接的代理程式之間出現描述重疊。
委派測試
在你新增 Foundry 代理人後:
於Agent導覽欄,選取 預覽索引標籤。
發送與 Foundry 代理網域相符的訊息。
確認回覆是否來自 Foundry 代理程式且適當。
發送訊息到 Foundry 代理的網域外,確認你的主要代理是否會處理該訊息。
如果你之後需要更改 代理 ID 或描述,請從元件面板編輯已連接的代理。 請參閱「在代理程式中管理已連線的代理程式」。