사용자가 Microsoft 365 Copilot Chat에서 선언적 에이전트와 상호 작용할 때 다른 에이전트에 연결하여 추가 정보를 검색하거나 작업을 수행할 수 있습니다. 속성에 worker_agents 에이전트 타이틀 ID를 나열하여 에이전트 매니페스트에서 이러한 연결을 선언합니다. 런타임 시 Copilot Chat은 상호 작용을 중재하는 브로커 역할을 합니다. 사용자는 에이전트 간 교환을 볼 수 있지만 연결된 에이전트를 직접 선택할 필요는 없습니다.
참고
매니페스트 선언 연결된 에이전트는 사용자 지정 애플리케이션 내에서 Microsoft 365 Copilot에서 제공하는 대화형 환경을 가능하게 하는 Copilot Chat API와는 별도의 메커니즘입니다.
참고
사용자는 연결된 각 에이전트를 확보해야 사용할 수 있습니다. 자세한 내용은 organization의 사용자에게 연결된 에이전트 배포를 참조하세요.
사용자가 선언적 에이전트와 상호작용할 때 에이전트는 작업의 일부를 연결된 에이전트에 위임할 수 있습니다. Microsoft 365 Copilot은 매니페스트에 선언된 연결된 에이전트를 평가하고 현재 작업과 연결된 에이전트의 이름, 설명 및 예제 프롬프트를 기반으로 에이전트를 선택합니다. Copilot은 선택한 연결된 에이전트에게 텍스트 요청을 보내고, 텍스트 응답을 수신하고, 해당 응답을 선언적 에이전트와 사용자의 지속적인 상호 작용에 통합합니다.
연결된 에이전트를 사용해야 하는 경우
연결된 에이전트를 사용하여 기능 또는 개발 팀 전체에서 에이전트를 분리하거나 결합합니다.
하나의 에이전트가 수행할 수 있는 것 이상으로 확장
LLM(대형 언어 모델)에는 유용한 컨텍스트 창과 기능 집합이 제한되어 있습니다. 더 많은 문서가 검색되거나 도구가 활성화되면 단일 LLM 에이전트의 안정성이 떨어지기 시작합니다. 더 많은 지식이나 기능을 추가한 후 에이전트의 품질이 떨어지는 경우 해당 기능 중 일부를 다른 에이전트로 분할하고 연결합니다. 기존 에이전트는 연결된 에이전트가 자신의 역할을 수행하는 데 필요한 작업에 대한 정보만 보냅니다. 연결된 에이전트는 사용자 대화에 있는 다른 문서나 기능과 자유로운 자체 컨텍스트 창에서 작동합니다.
외부에서 개발된 에이전트와 통합
선언적 에이전트를 사용하면 다른 개발 팀과 더 쉽게 작업할 수 있습니다. 각 개발 팀은 연결된 에이전트를 사용하여 다른 에이전트와 통합함으로써 에이전트의 기능과 품질에 집중할 수 있습니다. 마이크로 서비스와 마찬가지로 각 에이전트를 다른 에이전트에 영향을 주지 않고 개발할 수 있습니다. 마이크로 서비스와 달리 에이전트는 인터페이스가 변경되더라도 계속 상호 작용할 수 있습니다.
에이전트 기능을 여러 시나리오에 공유
에이전트는 일련의 문서 및 작업에서는 잘 작동하지만 사용자에게는 여전히 어려울 수 있습니다. 고객 및 영업에 대한 관계형 데이터베이스의 테이블과 데이터를 이해하는 에이전트를 고려합니다. 이 에이전트는 매장 감독자가 재고를 관리하고 비즈니스 분석가가 임원에게 보고하는 데 유용할 수 있습니다. 이 에이전트가 대화 시작 및 지침이 있는 감독자를 저장하도록 맞춤화된 에이전트와 비즈니스 분석가에게 맞춤화된 에이전트에 연결할 수 있는 경우 두 유형의 사용자 모두 시나리오에 맞는 에이전트를 사용하여 더 많은 가치를 얻을 수 있습니다.
연결된 에이전트 활성화
연결된 에이전트는 Microsoft Agent 365 에이전트 레지스트리에 등록해야 합니다. 기존 선언적 에이전트의 매니페스트에 에이전트의 타이틀 ID를 포함하여 다른 에이전트와 연결합니다. 다른 에이전트는 선언적 에이전트이거나 등록된 Agent2Agent 에이전트 카드가 있어야 합니다.
먼저 연결할 에이전트의 타이틀 ID를 가져옵니다. 에이전트의 타이틀 ID는 단일 문자, 밑줄 및 GUID로 구성된 문자열입니다. 선언적 에이전트의 경우 Microsoft 365 에이전트 도구 키트 또는 개발자 모드의 프로비전 명령 출력에서 찾을 수 있습니다. Microsoft 365 에이전트 등록의 경우 agentRegistration 개체의 속성입니다id.
타이틀 ID를 worker_agents 속성 id에 . 이 worker_agents 속성은 선언적 에이전트 스키마 버전 1.6에 추가되었습니다.
인증 및 권한 부여
선언적 에이전트는 Microsoft 365 Copilot Chat 내에서 실행되므로 선언적 에이전트에 연결하려면 Microsoft 365 Copilot에 대한 사용자의 기존 인증에 의존합니다. Microsoft Agent 365에 등록된 외부 에이전트의 경우 에이전트 등록은 Microsoft 365 Copilot이 외부 에이전트에 인증하는 방법을 선언해야 합니다. 인증 구성을 에이전트 등록에 직접 포함하는 대신, 등록은 의 개체를 authorization 통해 기존 인증 등록을 참조합니다.agentRegistration 이러한 분리를 통해 인증 구성을 에이전트 정의와 독립적으로 관리할 수 있습니다. 디자인은 API 플러그인 매니페스트의 디자인을 미러링합니다.
구문
{
"type": "None | OAuthPluginVault",
"referenceId": "{string}"
}
type 이 속성은 외부 에이전트에서 사용하는 인증 체계를 지정합니다.
OAuthPluginVaultMicrosoft Entra SSO 등록을 사용합니다.
referenceId Teams 개발자 포털에서 생성된 값입니다Microsoft Entra SSO registration ID. 자세한 내용은 Teams 개발자 포털 사용을 참조하세요.
사용자가 연결된 에이전트를 사용할 수 있는지 여부는 인증과 별도로 결정됩니다. 사용자가 직접 또는 관리자 배포를 통해 연결된 에이전트에 액세스할 수 있어야 합니다. 관리자는 사용자에 대해 Microsoft Agent 365에 등록된 외부 에이전트를 설치해야 합니다.
모범 사례
선언적 에이전트는 연결된 에이전트의 name, description, 및 예제 프롬프트에 따라 연결할 에이전트를 선택합니다. 선언적 에이전트의 경우 예제 프롬프트는 매니페스트의 필드 conversation_starters 입니다text. agentRegistration examples 의 경우 에이전트 카드에 있는 개체의 AgentSkill 속성입니다. 에이전트의 설명은 인간과 에이전트 모두에게 에이전트가 수행할 수 있는 작업을 설명해야 합니다. 예를 들어, 비디오 게임 판매에 대한 구조화된 데이터로 작업하는 에이전트에 대한 설명을 고려하세요.
A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.
예제 프롬프트는 사용자와 에이전트 모두에게 에이전트가 처리할 수 있는 프롬프트 유형을 알려야 합니다. 사용자가 동일한 개념에 대해 다른 용어를 사용할 수 있으므로 대화를 시작하는 표현을 다양하게 사용하는 것이 좋습니다. 예를 들어, 법적 사건을 다룰 때 대화를 잘 시작하는 사람은 "문제", "사례", "고객" 및 "문제" 용어도 사용할 수 있습니다. 연결된 에이전트는 대화 시작 필드만 text 사용합니다.
제한 사항
활성 에이전트는 연결된 에이전트에만 문자를 보냅니다. 선언적 에이전트는 텍스트 또는 적응형 카드를 반환합니다. Agent2Agent 에이전트 카드가 있는 에이전트는 텍스트, Base64 이미지 이진 및 Base64 파일 이진 파일을 반환합니다.
연결된 에이전트의 API 플러그인 호출을 확인하라는 메시지가 사용자에게 표시되는 동안 모든 적응형 카드 가 활성 에이전트로 전송됩니다. 사용자에게 적응형 카드가 표시되지 않거나 대화 상자를 사용할 수 없습니다. 그러나 활성 에이전트는 적응형 카드의 데이터 콘텐츠를 처리합니다.