Community生產力與協作github.com

ari20089/connected-agent-handoff-boundaries

用於設計、審查或疑難排解 Microsoft Copilot Studio 代理人委派給子代理人、連線代理人、外部代理人(A2A、Microsoft Foundry、Microsoft 365 Agents SDK)、真人客服或其他代理人(透過 Employee Self-Service 代理人)時的決策邊界,協助決定誰可以委派哪些動作給誰、哪些內容會隨交接傳遞、傳回什麼、以及確認、核准與認證應位於何處。

connected-agent-handoff-boundaries 是什麼?

此技能專為使用 Microsoft Copilot Studio 建置多代理人系統的開發者設計,處理最棘手的問題之一:代理人交接時的資料、權限與安全性邊界。它將微軟分散在不同頁面(代理人對代理人委派、真人客服交接、Employee Self-Service 代理人交接)的指引整合為一個統一的決策邊界模式,按動作類型分類。支援標準、Microsoft Copilot 與 Customer Conversation 三種 Harness,以及子代理人、連線代理人、外部代理人(A2A、Foundry、Agents SDK)、真人客服(透過互動中心)與 Employee Self-Service 代理人等委派機制。核心產出包含交接地圖、邊界矩陣(依動作類型 A1 至 A6 分級)、違規檢查(依七條規則)、以及可貼入 Copilot Studio 的指示區塊與合約範本。強調區分「官方文件記載」、「租戶觀察結果」與「未記載」三類事實,並以具體的 Copilot Studio 設定(如切換鈕、節點名稱)提供修正建議,但絕不會擅自更改代理人、設定或認證。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ari20089/agents-in-practice/tree/HEAD/skills/connected-agent-handoff-boundaries

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Connected-Agent Handoff Boundaries 連線代理人交接邊界

微軟針對 Microsoft Copilot Studio 的交接指引分散在三頁:代理人對代理人委派、交接給真人客服、以及 Employee Self-Service 代理人交接。第四頁定義單一代理人動作的決策層級。沒有任何單一頁面說明誰可以將哪種動作委派給哪種代理人,也沒有一個地方列出交接時會保留什麼。此技能將已記載的機制轉換為每個動作類型的決策邊界模式。本技能為建議性質:請勿變更代理人、設定、原則或認證。

開始之前

請先確認以下事項。如果使用者尚未提供,請詢問缺少的項目。

  1. Harness 或產品 — 標準、Microsoft Copilot(原 GitHub Copilot)、或 Copilot Studio 中的 Customer Conversation Harness,或 Microsoft Copilot 中的 Employee Self-Service 代理人。不同 Harness 的行為不同(請參閱步驟 1);如果使用者不知道,請詢問代理人是如何建立的,並說明您假設的 Harness。
  2. 委派對象 — 設計中會交接給的每個代理人或人員,以及交接方式:子代理人、連線的 Copilot Studio 代理人、外部代理人(A2A、Foundry、Agents SDK、Fabric Data 代理人、第三方市集代理人)、透過互動中心的真人客服、或主題重新導向。
  3. 動作清單 — 每個代理人可使用的工具、流程和主題,以及每個工具的驗證方式(終端使用者或製作者提供)與「在執行前詢問終端使用者」是否開啟。如果不知道,請根據工具名稱分類,並標記為暫定分類。
  4. 委派者 — 父代理人是由使用者在聊天中觸及,還是透過事件、排程觸發程式或兩者觸及。
  5. 需要的成品 — 邊界矩陣(預設)、指示區塊、交接合約、審查檢查清單、租戶測試計劃、或整個設計的審查。
  6. 文件日期 — 如果您有網路存取權限,請重新檢查指南來源清單中的 Microsoft Learn 頁面,比較每個頁面的 ms.date 與清單中的日期,並說明有哪些變更。否則,請說明您依賴該清單中的日期(上次重新閱讀時間為 2026 年 11 月 5 日)。
  7. 租戶觀察 — 使用者已經從測試 T1 到 T10 獲得的任何結果。請將這些報告為 在租戶中觀察到,並區分為 已記載 與 未記載,並附上租戶類型和日期。

輸出結構

請依序產生下列內容:

  1. 交接地圖 — 每個委派對象一行:委派者、機制、Harness、委派對象。
  2. 適用的已記載事實 — 項目符號,附上 Microsoft Learn 頁面和日期,使用指南的措辭,涵蓋每個機制傳遞的內容、傳回的內容,以及會改變兩者的設定。
  3. 在租戶中觀察到 — 僅在使用者提供結果時才顯示;否則省略此標題。
  4. 邊界矩陣 — 指南第 6.4 節的表格,每個委派對象一行,包含最高動作類型(A1 到 A6),每個儲存格都填寫或標記為 未知。
  5. 邊界違規 — 設計中違反第 6.3 節七個規則的每個地方,附上規則編號和修正方式。
  6. 適用的開放問題 — Q1 到 Q10 中的相關行。
  7. 假設 — 一行列出您套用的預設值(Harness、分類、成品、日期)。如果使用者提供了所有資訊,則省略。
  8. 要求的成品 — 根據指南的對應章節(步驟 5)建置。
  9. 建議 — 對於設計是否準備就緒的明確立場,以及必須先滿足的條件。
  10. 來源與日期 — 一行列出所依賴的頁面及其日期,以及使用中機制的預覽狀態。

對於地圖、矩陣和測試計劃請使用表格,對於檢查清單請使用編號清單,對於使用者將貼入 Copilot Studio 的任何指示或說明文字請使用圍欄區塊。

步驟 1:識別 Harness 與機制

閱讀 references/handoff-guide.md 的第 1 節和第 2 節。首先確定 Harness:同一個詞在不同 Harness 中意義不同。

使用者說法在 ... 上的意思注意事項
"Child agent"標準 Harness總是接收父代理人的內容;沒有設定可排除它
"Sub-agent"Customer Conversation Harness(或廣義上指任何子代理人)與主要代理人共用設定、部署和 ALM
"Connected agent"任何 Harness標準:歷史記錄切換、相同環境、一層。Microsoft Copilot Harness:父代理人是唯一的溝通者;沒有名為歷史記錄的設定(Q3)。Customer Conversation:僅限 Microsoft Foundry 代理人。
"A2A agent", "Foundry agent"標準或 Microsoft Copilot Harness外部:微軟將資料流程和核准的責任交給製作者
"Hand off to a human", "escalate"標準 Harness,或 Customer Conversation 升級路徑標準:完整歷史記錄和使用者定義的所有主題變數都會傳遞到互動中心。Customer Conversation:酬載未記載。
"Agent handoff", "hub agent"Microsoft Copilot 中的 Employee Self-Service 代理人交接會傳遞歷史記錄和原始提示,可以跨環境,並且可以鎖定第三方代理人

如果使用者在一項設計中混合使用 Harness,則分別處理每個委派邊緣。

步驟 2:確定每個交接傳遞的內容

對於每個委派對象,根據指南第 3 節說明它接收的內容、傳回的內容,以及遺失的內容:重新表述的要求、引文、子代理人自己的訊息、Adaptive Card 動作和存取權。使用微軟的措辭。如果指南說 未記載,請照實說明;不要根據其他 Harness 的行為來填補這個差距。

步驟 3:分類動作並設定執行的層級

根據每個委派對象可以使用的工具中的最高動作類型(指南第 6.1 節,A1 到 A6)對其進行分類。將每種類型對應到微軟的三個層級(指南第 5 節):無確認、對話中確認、離線核准。該層級屬於擁有該工具的代理人。閱讀指南第 4 節,了解確認和認證的設定位置,並標記每個使用製作者提供認證的 A2 到 A5 委派對象工具。MCP 伺服器工具視為工具。

步驟 4:檢查誰可以委派什麼給誰

套用指南第 6.2 節(委派表格和自主委派者規則)和第 6.3 節的七個規則。列出每個違規事項及其規則編號,並以 Copilot Studio 用語提供具體的修正方式,說明設定、節點或輸入。

步驟 5:建置成品

成品指南章節內容
邊界矩陣6.4每個委派對象一行,每個欄位都填寫或標記為 未知
指示區塊7父代理人、子代理人和描述區塊,名稱已調整,微軟的措辭保持不變,邊界行已標記
交接合約8每個委派對象的輸入和輸出,附上為協調器撰寫的描述
審查檢查清單11十個檢查項目,每個標記為通過、失敗或未知
租戶測試計劃10適用於使用者 Harness 和委派對象的測試;刪除已執行的測試,並將其結果合併到「在租戶中觀察到」
設計審查6.4, 6.3, 11矩陣、違規事項、檢查清單和建議彙整在一起

每個成品都附帶文件日期及其涵蓋機制的預覽狀態。

步驟 6:建議,然後停止

提出明確的立場:準備就緒、準備就緒但需進行所列修正、或尚未準備就緒。如果符合以下任一條件,則設計尚未準備就緒:任何 A5 動作可透過生成式路由觸及、任何 A2 到 A5 委派工具使用製作者提供的認證但沒有記錄的例外(自主委派者永遠需要一個,因為觸發程式會使用製作者的認證執行;指南第 4 節和第 6.2 節)、或外部委派對象接收聊天歷史記錄但沒有記錄的資料共享決策。請勿提議變更代理人。

規則

  • 絕對不要陳述父代理人的確認、認證或資料原則適用於委派對象的工具。微軟根據每個工具所屬的代理人記錄這些設定。
  • 絕對不要陳述連線代理人只接收工作,除非使用者已確認在標準 Harness 代理人的「將對話記錄傳遞給此代理人」已清除。預設會傳遞歷史記錄。
  • 絕對不要在指南說 未記載 的地方提及歷史記錄設定、委派深度、代理人連線的系統管理員封鎖或使用者權杖傳遞。回答「截至 <日期> 未記載」,並說明可用來確認的測試。也不要否認:常見問題表示您「可以設定是否將完整對話記錄傳遞」給外部代理人,儘管沒有頁面說明該設定(指南 Q3;測試 T6)。
  • 絕對不要將動作類型、委派表格、七條規則、actionsTaken 輸出或 boundary 指示行呈現為微軟指導方針。它們是此技能在微軟事實之上建構的模式;請標記清楚。
  • 始終保持三類事實分開:已記載(頁面和日期)、在租戶中觀察到(誰的測試、何時)、以及 未記載。
  • 始終從指南或即時擷取的頁面中引用微軟的措辭,而不是從記憶中引用。
  • 始終解決「唯一與使用者交談的代理人」衝突(Q6),採用子代理人頁面的說法(模式頁面現在也遵循此說法):指示子代理人保持沉默;不要僅依賴父代理人專用的指示。
  • 始終使用微軟的現有名稱:標準 Harness;Microsoft Copilot Harness(2026 年 10 月 28 日從 GitHub Copilot Harness 重新命名;Learn 和產品可能仍顯示舊名稱;在 Learn 頁面標題和引用中保留舊名稱;「一個 Microsoft Copilot Studio 編寫和協調架構,而非 GitHub Copilot 服務」;一個 Copilot Studio Harness,而非 Microsoft Copilot 產品);Customer Conversation Harness,其專家稱為子代理人;Microsoft Foundry(非 Azure AI Foundry);Agent2Agent (A2A);Microsoft 365 Agents SDK;互動中心;以及對於 Employee Self-Service 代理人,請依其頁面所稱的 Microsoft Copilot 和 Copilot Chat。
  • 始終將使用者分享的租戶、代理人、使用者和客戶名稱從可重複使用的範例和準備貼入的區塊中移除。
  • 如果設計中沒有委派,請說明此技能是錯誤的工具,並指向指南第 5 節的單一代理人層級。

範例

輸入:「我們的 IT 服務台代理人(標準 Harness)將請求路由到同一環境中的 Facilities 連線代理人,以及一個可以取消硬體訂單的廠商 A2A 代理人。使用者在 Microsoft Teams 中與其聊天。我們需要哪些邊界?」

輸出(摘要):

交接地圖: Helpdesk → Facilities(連線的 Copilot Studio 代理人,標準);Helpdesk → Vendor orders(A2A,標準)。 已記載事實: Facilities 會收到對話記錄,除非「將對話記錄傳遞給此代理人」已清除;它「預設為啟用」(Design subagents,2026 年 11 月 4 日)。A2A 範例酬載包含「完整聊天記錄,而不僅僅是最新的使用者話語」(A2A,2026 年 8 月 26 日)。對於外部代理人,「您需負責此類代理人的使用」(同一頁面)。確認是每個工具進行的:「在執行前詢問終端使用者」「預設設為否」(Add tools,2026 年 10 月 1 日)。 邊界矩陣: Facilities,A3(草擬工作單),生成式路由,歷史記錄開啟(原因未知),終端使用者認證,無確認,無輸出:違反規則 4。Vendor orders,A5(取消訂單),生成式路由,完整聊天記錄,OAuth 2.0 連線,無確認:違反規則 1、3 和 5。 違規與修正:

  • 規則 5:將廠商代理人從生成式路由中移除。僅透過「取消訂單」主題(包含確認節點和重新導向)觸及,傳遞僅包含訂單編號的 scopedRequest。
  • 規則 3:記錄與廠商之間的資料共享決策(涵蓋聊天記錄),否則不要連線代理人。
  • 規則 4:將 answered、findings、openQuestions 和 actionsTaken 輸出新增至 Facilities,並清除歷史記錄切換。 開放問題: Q1、Q4、Q5。 建議: 尚未準備就緒。在規則 4 修正後部署 Facilities;在重新導向主題存在且資料共享決策簽署之前,暫緩廠商連線。 來源與日期: Multi-agent patterns(2026 年 11 月 4 日);Connect to an existing Copilot Studio agent(2026 年 10 月 30 日);A2A(2026 年 8 月 26 日);Design subagents(2026 年 11 月 4 日);Add tools(2026 年 10 月 1 日)。標準 Harness「新增其他代理人」為預覽文件。

參考資料

  • references/handoff-guide.md — 微軟指引所在(第 1 節);依 Harness 區分的機制(2);每個交接傳遞的內容,逐字(3);認證和確認的設定位置(4);微軟的決策層級(5);此技能的邊界模式:動作類型、委派表格、七條規則、矩陣範本(6);準備貼入的指示區塊(7);交接合約(8);開放問題 Q1 到 Q10(9);租戶測試 T1 到 T10(10);審查檢查清單(11);注意事項(12);所有來源及日期。在回答之前閱讀它;在建置成品之前閱讀步驟 5 中命名的章節。

相關技能