ari20089/연결에이전트-핸드오프-경계

연결 에이전트 핸드오프 경계

Microsoft의 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. 대리자(Delegates) — 설계가 핸드오프하는 모든 에이전트 또는 사람과 그 방법: 하위 에이전트, 연결된 Copilot Studio 에이전트, 외부 에이전트(A2A, Foundry, Agents SDK, Fabric Data 에이전트, 타사 스토어 에이전트), 참여 허브를 통한 라이브 에이전트, 또는 주제 리디렉션.
3. 작업 인벤토리(Action inventory) — 각 에이전트가 도달할 수 있는 도구, 흐름 및 주제. 각 도구의 인증(최종 사용자 또는 메이커 제공) 및 실행 전 최종 사용자에게 묻기가 켜져 있는지 여부. 알 수 없는 경우 도구 이름에서 분류하고 분류가 잠정적임을 표시하십시오.
4. 위임자(Delegators) — 상위 에이전트가 채팅의 사용자, 이벤트 또는 예약된 트리거, 또는 둘 다에 의해 도달되는지 여부.
5. 원하는 산출물(Artifact) — 경계 매트릭스(기본값), 명령 블록, 핸드오프 계약, 검토 체크리스트, 테넌트 테스트 계획, 또는 전체 집합에 대한 설계 검토.
6. 문서화 날짜 — 웹 액세스 권한이 있는 경우, 가이드의 출처 목록에 있는 Microsoft Learn 페이지를 다시 확인하고, 각 페이지의 ms.date를 나열된 날짜와 비교한 후 변경된 사항을 말하십시오. 그렇지 않으면 해당 목록의 날짜에 의존하고 있음을 말하십시오(마지막 재확인: 2026년 11월 5일).
7. 테넌트 관찰(Observations) — 사용자가 이미 T1~T10 테스트에서 얻은 결과. 이를 테넌트 유형과 날짜와 함께 테넌트에서 관찰됨으로 보고하고, 문서화됨 및 문서화되지 않음과 분리하여 보고하십시오.

출력 구조

다음 순서로 생성하십시오:

1. 핸드오프 맵(Handoff map) — 대리자당 한 줄: 위임자, 메커니즘, harness, 대리자.
2. 적용되는 문서화된 사실(Documented facts) — 각 메커니즘이 전달하는 내용, 반환하는 내용, 그리고 이를 변경하는 설정을 다루는 Microsoft Learn 페이지와 날짜가 포함된 글머리 기호(가이드의 표현 사용).
3. 테넌트에서 관찰됨(Observed in tenant) — 사용자가 결과를 제공한 경우에만 포함. 그렇지 않으면 제목 생략.
4. 경계 매트릭스(Boundary matrix) — 가이드 섹션 6.4의 표, 대리자당 한 행, 가장 높은 액션 유형(A1~A6) 및 모든 셀 채워짐 또는 알 수 없음으로 표시.
5. 경계 위반(Boundary violations) — 설계가 섹션 6.3의 7가지 규칙 중 하나를 위반하는 각 지점, 규칙 번호 및 수정 사항 포함.
6. 적용되는 미해결 질문(Open questions) — Q1~Q10의 관련 행.
7. 가정(Assumptions) — 적용한 기본값(harness, 분류, 산출물, 날짜)을 나열하는 한 줄. 사용자가 모든 것을 제공한 경우 생략.
8. 요청된 산출물(Requested artifact) — 가이드의 해당 섹션(5단계)에서 구축.
9. 권장 사항(Recommendation) — 설계가 준비되었는지에 대한 명확한 입장과 먼저 충족되어야 하는 조건.
10. 출처 및 날짜(Sources and dates) — 의존한 페이지와 날짜, 사용 중인 메커니즘의 미리 보기 상태를 명명하는 한 줄.

맵, 매트릭스 및 테스트 계획에는 표를 사용하고, 체크리스트에는 번호 목록을 사용하고, 사용자가 Copilot Studio에 붙여넣을 지침 또는 설명 텍스트에는 펜스 블록을 사용하십시오.

1단계: Harness 및 메커니즘 식별

references/handoff-guide.md 섹션 1과 2를 읽으십시오. 먼저 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	외부: Microsoft는 데이터 흐름 및 승인에 대한 책임을 메이커에게 둡니다.
"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 작업, 액세스)을 명시하십시오. Microsoft의 표현을 사용하십시오. 가이드에서 문서화되지 않음이라고 말하는 경우 그렇게 말하고, 다른 harness의 동작으로 간격을 채우지 마십시오.

3단계: 작업 분류 및 실행 계층 설정

각 대리자가 도달할 수 있는 도구 중 가장 높은 액션 유형(가이드 섹션 6.1, A1A6)으로 분류하십시오. 각 유형을 Microsoft의 세 가지 계층(가이드 섹션 5)에 매핑하십시오: 확인 없음, 대화 내 확인, 오프라인 승인. 계층은 도구를 소유한 에이전트에 속합니다. 확인 및 자격 증명이 설정된 위치에 대해서는 가이드 섹션 4를 읽고, 메이커 제공 자격 증명을 사용하는 A2A5의 모든 대리자 도구에 플래그를 지정하십시오. MCP 서버 도구도 도구로 간주하십시오.

4단계: 누가 무엇을 누구에게 위임할 수 있는지 확인

가이드 섹션 6.2(위임 표 및 자율 위임자 규칙)와 섹션 6.3의 7가지 규칙을 적용하십시오. 각 위반 사항을 규칙 번호와 Copilot Studio 용어(설정, 노드 또는 입력 이름 지정)의 구체적인 수정 사항과 함께 나열하십시오.

5단계: 산출물 구축

산출물	가이드 섹션	내용
경계 매트릭스	6.4	대리자당 한 행, 모든 열 채워짐 또는 알 수 없음
명령 블록	7	상위, 하위 에이전트 및 설명 블록, 이름 조정, Microsoft의 줄은 그대로 유지, 경계 줄 표시
핸드오프 계약	8	대리자당 입력 및 출력, 오케스트레이터용으로 작성된 설명 포함
검토 체크리스트	11	10가지 검사, 각각 이 설계에 대해 통과, 실패 또는 알 수 없음으로 표시
테넌트 테스트 계획	10	사용자의 harness 및 대리자에 적용되는 테스트; 이미 실행된 테스트는 제외하고 결과를 테넌트에서 관찰됨에 통합
설계 검토	6.4, 6.3, 11	매트릭스, 위반 사항, 체크리스트 및 권장 사항을 함께 포함

모든 산출물은 문서화 날짜와 포함하는 메커니즘의 미리 보기 상태를 포함합니다.

6단계: 권장 후 중지

명확한 입장을 제시하십시오: 준비됨, 나열된 수정 사항으로 준비됨, 또는 준비되지 않음. 생성 경로에서 A5 작업에 도달할 수 있거나, 기록된 예외 없이 메이커 제공 자격 증명을 사용하는 A2~A5 대리자 도구가 있거나(자율 위임자는 항상 예외가 필요함, 트리거는 메이커의 자격 증명으로 실행되므로, 가이드 섹션 4 및 6.2), 외부 대리자가 기록된 데이터 공유 결정 없이 채팅 기록을 수신하는 경우 설계가 준비되지 않은 것입니다. 에이전트를 변경하겠다고 제안하지 마십시오.

규칙

• 절대 상위의 확인, 자격 증명 또는 데이터 정책이 대리자의 도구에 적용된다고 명시하지 마십시오. Microsoft는 이를 도구별로, 도구를 소유한 에이전트에서 문서화합니다.
• 절대 연결된 에이전트가 작업만 수신한다고 명시하지 마십시오. 사용자가 표준 harness 에이전트에서 Pass conversation history to this agent가 해제되었음을 확인하지 않는 한. 기본값은 기록을 전달합니다.
• 절대 가이드에서 문서화되지 않음이라고 말하는 곳에서 기록 설정, 위임 깊이, 에이전트 연결 관리자 차단 또는 사용자 토큰 전달의 이름을 지정하지 마십시오. "<날짜> 기준 문서화되지 않음"이라고 답하고 이를 확인할 테스트의 이름을 지정하십시오. 부정하지도 마십시오. FAQ는 외부 에이전트에 "전체 대화 기록을 전달할지 구성할 수 있다"고 말하지만, 어떤 페이지도 설정 이름을 지정하지 않습니다(가이드 Q3, 테스트 T6).
• 절대 액션 유형, 위임 표, 7가지 규칙, actionsTaken 출력 또는 경계(boundary) 명령 줄을 Microsoft 지침으로 제시하지 마십시오. 이는 Microsoft의 사실 위에 있는 이 스킬의 패턴입니다. 레이블을 붙이십시오.
• 항상 세 가지 사실 클래스를 분리하십시오: 문서화됨(페이지 및 날짜), 테넌트에서 관찰됨(누구의 테스트, 언제), 문서화되지 않음.
• 항상 Microsoft의 표현을 가이드 또는 인용된 페이지의 실제 가져오기에서 인용하고, 기억에서 인용하지 마십시오.
• 항상 "사용자와 대화하는 유일한 에이전트" 충돌(Q6)을 하위 에이전트 페이지에 유리하게 해결하십시오. 패턴 페이지는 이제 이를 따릅니다. 하위 에이전트에게 침묵을 유지하도록 지시하고, 상위 전용 지시에 의존하지 마십시오.
• 항상 Microsoft의 현재 이름을 사용하십시오: 표준 harness; Microsoft Copilot harness(2026년 10월 28일 GitHub Copilot harness에서 이름 변경, Learn 및 제품에 여전히 이전 이름이 표시될 수 있음, Learn 페이지 제목 및 인용에서는 이전 이름 유지, "GitHub Copilot 서비스가 아닌 Microsoft Copilot Studio 작성 및 오케스트레이션 프레임워크", 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는 Pass conversation history to this agent가 해제되지 않는 한 대화 기록을 수신합니다. "기본적으로 활성화되어 있습니다"(Design subagents, 2026년 11월 4일). A2A 샘플 페이로드는 "최신 사용자 발화뿐만 아니라 전체 채팅 기록"을 전달합니다(A2A, 2026년 8월 26일). 외부 에이전트의 경우 "해당 에이전트의 사용에 대한 책임은 귀하에게 있습니다"(동일 페이지). 확인은 도구별입니다. 실행 전 최종 사용자에게 묻기는 "기본적으로 아니요로 설정되어 있습니다"(Add tools, 2026년 10월 1일). 경계 매트릭스: Facilities, A3(작업 주문 초안 작성), 생성 경로, 기록 켜짐(un.)(이유 알 수 없음), 최종 사용자 자격 증명, 확인 없음, 출력 없음: 규칙 4 실패. Vendor orders, A5(주문 취소), 생성 경로, 전체 채팅 기록, OAuth 2.0 연결, 확인 없음: 규칙 1, 3, 5 실패. 위반 사항 및 수정:

• 규칙 5: 공급업체 에이전트를 생성 경로에서 제거하십시오. 확인 노드와 리디렉션이 있는 "주문 취소" 주제를 통해서만 도달하고, 주문 번호만 포함하는 scopedRequest를 전달하십시오.
• 규칙 3: 채팅 기록을 다루는 공급업체와 데이터 공유 결정을 기록하거나 에이전트를 연결하지 마십시오.
• 규칙 4: Facilities에 answered, findings, openQuestions 및 actionsTaken 출력을 추가하고 기록 토글을 해제하십시오. 미해결 질문: 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 "Add other agents"는 미리 보기 문서입니다.

참조

• references/handoff-guide.md — Microsoft의 지침이 있는 곳(섹션 1); harness별 메커니즘(2); 각 핸드오프가 전달하는 내용(원문)(3); 자격 증명 및 확인이 설정된 곳(4); Microsoft의 결정 계층(5); 이 스킬의 경계 패턴: 액션 유형, 위임 표, 7가지 규칙, 매트릭스 템플릿(6); 붙여넣기 가능한 명령 블록(7); 핸드오프 계약(8); 미해결 질문 Q1Q10(9); 테넌트 테스트 T1T10(10); 검토 체크리스트(11); 주의할 점(12); 날짜가 포함된 모든 출처. 답변하기 전에 읽으십시오; 산출물을 구축하기 전에 5단계에서 명명된 섹션을 읽으십시오.