선언적 에이전트는 Microsoft 365 Copilot의 관리되는 오케스트레이션 및 언어 모델 인프라에서 실행됩니다. 사용자가 직접 대화형 런타임을 구현하고 호스팅하는 대신 에이전트의 지침, 지식 소스 및 지원되는 기능을 구성합니다.
에이전트는 Microsoft 365 기술 자료, 코드 인터프리터와 같은 기본 제공 기능, 사용자 지정 기술(미리 보기), MCP 서버 또는 REST API에서 제공하는 작업을 사용할 수 있습니다. 연결된 에이전트에게 작업을 위임할 수도 있습니다. 가용성은 작성 도구, 매니페스트 버전, 대상 환경, 라이선스 및 조직 정책에 따라 달라집니다.
이 문서를 사용하여 관리되는 플랫폼과 구성하거나 작동하는 구성 요소 간의 경계를 이해합니다. 오케스트레이션 및 모델 호스팅을 제어할 수 있는 아키텍처와의 비교는 선언적 및 사용자 지정 엔진 에이전트 비교를 참조하십시오.
아키텍처 구성 요소
Microsoft 365 Copilot은 사용자 요청을 해석하고, 관련 컨텍스트를 검색하고, 기능을 선택하고, 응답을 생성하는 런타임을 제공합니다. 구성 및 외부 서비스에 따라 에이전트가 작업을 완료하는 데 사용할 수 있는 항목이 결정됩니다.
| 구성 요소 | 관리형 플랫폼 | 개발자 책임 |
|---|---|---|
| 클라이언트 | 지원되는 Microsoft 365 환경에서 대화를 호스트합니다. | 대상 환경을 선택하고 지원되는 상호 작용, 문서 컨텍스트 및 응답 형식을 테스트합니다. |
| 인프라 | Copilot 오케스트레이션 및 모델 런타임을 호스트합니다. | 에이전트를 구성하고 사용하는 외부 API, MCP 서버 또는 기타 서비스를 호스트합니다. |
| 카탈로그 및 배포 | 지원되는 획득, 게시 및 관리 환경을 제공합니다. | 지원되는 패키지 및 배포 경로를 선택하고, 버전을 유지 관리하고, 액세스 및 배포에 대해 관리자와 협력합니다. |
| 보안 및 규정 준수 | Microsoft 365 ID, 데이터 액세스 및 플랫폼 보호를 적용합니다. | 사용 권한 및 인증을 구성하고, 데이터 흐름을 평가하고, 외부 서비스에서 권한 부여 및 데이터 보호를 적용합니다. |
| 오케스트레이터 및 언어 모델 | 기능을 선택 및 호출하고 응답을 생성합니다. | 지침 및 도구 설명을 작성하고, 지원되는 동작 설정을 구성하고, 결과 동작을 평가합니다. 관리되는 오케스트레이터를 사용자 지정 런타임 코드로 대체하지 않습니다. |
| 지식 및 역량 | 지원되는 지식을 검색하고 기본 제공 기능을 실행합니다. | 관련 원본과 기능을 선택하고, 사용자 액세스를 확인하고, 검색 품질을 테스트합니다. |
| 도구 호출 | 지원되는 통합을 통해 구성된 MCP 또는 API 작업을 호출합니다. | 도구 입력 및 출력을 정의하고, 인증 및 확인을 구성하고, 신뢰할 수 있는 서비스 동작을 구현합니다. |
지원되는 구성 설정은 관리되는 런타임에 영향을 줍니다. 구현을 완전히 제어할 수 있는 것은 아닙니다. 예를 들어 매니페스트는 사용자가 재정의할 수 있는 기본 응답 모드를 지원합니다. 선택한 매니페스트 스키마 및 작성 도구에 따라 사용 가능한 설정을 확인합니다.
참고
검색된 콘텐츠 및 도구 응답에 신뢰할 수 없는 지침이 포함될 수 있습니다. 플랫폼 보호는 서비스의 권한 부여 확인 또는 에이전트의 동작 평가를 대체하지 않습니다. 해당 데이터, 개인 정보 보호 및 보안 요구 사항을 계획합니다.
선언적 에이전트 데이터 흐름
다음 개념적 흐름은 에이전트가 구성 및 기능을 사용하는 방법을 설명합니다. 이는 고정된 실행 순서가 아니며 발생한 검색 또는 도구 호출 횟수를 보장하지도 않습니다.
- 요청을 수신합니다. 사용자가 지원되는 환경에서 프롬프트를 제출합니다. 대화 기록 및 사용 가능한 앱 컨텍스트가 요청에 영향을 줄 수 있습니다.
- 관련 컨텍스트 및 기능을 선택합니다. Copilot은 에이전트의 지침, 지식 구성 및 도구 설명을 사용하여 요청을 처리하는 방법을 결정합니다.
- 정보를 검색하거나 작업을 호출합니다. Copilot은 사용 가능한 지식을 검색하거나 활성화된 기능을 호출합니다. 외부 작업은 구성된 인증 및 확인 동작을 사용합니다. 외부 서비스는 자체 권한 부여 및 비즈니스 규칙을 적용합니다.
- 응답을 생성합니다. Copilot은 사용 가능한 컨텍스트 및 기능 결과를 사용하여 응답합니다. 작업에 따라 상호 작용에는 추가 통화, 사용자 입력 요청 또는 연결된 에이전트에 대한 위임이 포함될 수 있습니다.
선언적 에이전트는 API 호출을 연결하고, 한 호출의 출력을 다른 호출의 입력으로 사용하고, SharePoint 지식 또는 코드 인터프리터를 API 작업과 결합할 수 있습니다. 지원되는 패턴 및 예제는 API 플러그인에서 함수 호출 체인을 참조하세요.
지침은 모델 동작을 안내합니다. 트랜잭션, 정확한 실행 순서 또는 복구 절차를 적용해야 하는 응용 프로그램 논리를 대체하지는 않습니다. API 또는 워크플로 서비스에서 이러한 요구 사항을 구현하거나 오케스트레이션을 소유해야 하는 경우 사용자 지정 엔진 아키텍처를 평가합니다.
기능별 제한에 맞게 설계
각 기능 및 통합에 대한 지침의 제한을 확인합니다. 매니페스트 필드의 문자 제한, 지식 소스 구성 제한 및 런타임 컨텍스트 제한은 서로 다른 제약 조건을 설명합니다.
| 영역 | 디자인 고려 사항 | 지침 |
|---|---|---|
| 에이전트 구성 | 선택한 스키마 버전 및 작성 도구에서 지원하는 속성 및 기능을 사용합니다. | 선언적 에이전트 매니페스트 참조 |
| 지식 검색 | 관련 원본을 선택하고 원본별 파일, 범위, 액세스 및 인덱싱 요구 사항을 따릅니다. 응답에 원본의 모든 항목이 반드시 포함되는 것은 아닙니다. | 지식 원본 및 콘텐츠 검색 최적화 |
| 도구 정의 및 페이로드 | 도구에 초점을 맞추고 입력 및 출력을 관련성 있게 유지합니다. 큰 플러그 인 입력 및 출력은 잘릴 수 있으며 효과적인 컨텍스트 제한은 모델 및 시스템 오버헤드에 따라 변경될 수 있습니다. | MCP 및 API 플러그인 제한 사항 |
| 문서 컨텍스트 | 모든 문서 콘텐츠가 동일하게 표현된다고 가정하기보다는 호스트 앱에서 지원하는 문서 상호 작용 및 콘텐츠 형식을 따르세요. | 문서와 상호 작용 |
| 서비스 동작 및 대기 시간 | 응답 시간, 인증 실패, 서비스 오류, 외부 API 또는 MCP 서버의 제한을 테스트합니다. | 구성 요소 통합 및 테스트 |
큰 데이터 집합의 경우 모든 레코드를 대화로 보내는 대신 관련 하위 집합을 필터링, 집계 또는 반환하도록 API를 디자인합니다. 시나리오에 문서 콘텐츠가 필요한 경우 지원되는 호스트 환경을 테스트합니다. 선언적 에이전트는 문서 형식 고려 사항에 따라 Word 및 PowerPoint에서 열려 있는 전체 문서에 액세스할 수 있습니다.
장점과 한계
선언적 에이전트의 주요 장점과 주요 제한 사항은 이 아키텍처가 특정 사용 사례에 적합한 시기를 결정하는 데 도움이 됩니다.
주요 이점
선언적 에이전트는 기존 Microsoft 365 환경 내에서 AI 솔루션을 구현하려는 조직에 상당한 이점을 제공합니다.
- 관리형 대화형 런타임: Microsoft에서 오케스트레이터 및 모델 인프라를 호스트하므로 해당 런타임을 구현할 필요가 없습니다.
- Microsoft 기능에 대한 액세스: 에이전트는 지원되는 지식 소스 및 기본 제공 기능을 외부 도구와 함께 사용할 수 있습니다.
- 구성 기반 사용자 지정: 지침, 기능 및 작업은 사용자 지정 대화형 엔진 없이도 환경을 맞춤화합니다. 외부 통합에는 여전히 코드와 호스팅이 필요할 수 있습니다.
기본 제한 사항
선언적 접근 방식은 또한 특정 사용 사례를 제한할 수 있는 제약 조건을 도입합니다.
- 관리되는 오케스트레이션: 모든 런타임 결정을 제어하는 대신 지원되는 구성을 통해 동작에 영향을 미칩니다. 지침을 결정론적 워크플로 엔진으로 취급하는 대신 대표적인 작업을 평가합니다.
- 플랫폼 및 호스트 종속성: 기능, 응답 프레젠테이션, 라이선싱 및 관리는 선택한 Microsoft 365 환경에 따라 달라집니다. 각 대상 호스트에서 지원을 확인합니다.
- 컨텍스트 및 검색 제약 조건: 지식 검색 및 도구 결과는 사용 가능한 컨텍스트에 맞아야 합니다. 큰 원본 또는 페이로드가 응답의 전체 범위를 보장하지는 않습니다.
- 동적 웹 콘텐츠 고려 사항: 범위 웹 검색은 기본 데이터 원본을 직접 쿼리하는 대신 Bing 인덱싱된 콘텐츠를 사용합니다. 동적으로 생성된 콘텐츠는 불완전하거나 부실할 수 있습니다. 작업에서 현재 구조화된 데이터에 직접 액세스해야 하는 경우 지원되는 API 통합을 사용합니다. 웹 검색 기반 및 동적 콘텐츠를 참조하세요.
- 지속적인 평가: 플랫폼 및 모델 업데이트는 동작을 변경할 수 있습니다. 에이전트와 해당 종속성이 진화함에 따라 테스트 명령, 검색 및 도구 사용.
사용 사례 정렬
작업에 여러 단계가 있는지 여부가 아니라 솔루션에 필요한 제어에 따라 아키텍처를 선택하세요.
최적의 시나리오
선언적 에이전트는 다음과 같은 경우에 최적입니다.
- 정보 검색: 주로 Microsoft 365 또는 외부 원본에서 정보를 검색하고 요약해야 하는 에이전트.
- 보조 작업: 지식과 지원되는 API 또는 MCP 작업을 결합하여 사용자가 작업을 완료할 수 있도록 돕는 에이전트입니다.
- 문서 지원 및 분석: 지원되는 문서 컨텍스트를 사용하거나 코드 인터프리터와 같은 기능을 사용하는 에이전트입니다.
- 생산성 향상: Microsoft 365 내에서 관리되는 대화형 환경의 이점을 활용하는 작업입니다.
부적합한 시나리오
요구 사항이 다음과 같은 경우 사용자 지정 엔진 에이전트 또는 별도로 구현된 워크플로를 고려합니다.
- 사용자 지정 런타임 제어: 관리되는 Copilot 런타임을 사용하는 대신 사용자 고유의 오케스트레이션, 모델 호스팅 또는 사용자 인터페이스를 구현해야 합니다.
- 지속성 비즈니스 프로세스: 시스템은 대화와 독립적으로 정확한 실행 순서, 트랜잭션 경계, 재시도 또는 복구를 적용해야 합니다.
- 대규모 데이터 처리: 이 작업에는 관련 대화형 컨텍스트를 검색하거나 분석하기보다는 데이터 세트를 철저하게 처리해야 합니다. 서비스에서 해당 처리를 수행하고 에이전트에 적절한 결과를 노출합니다.
- 동적 원본에 직접 액세스: 이 작업에는 웹 검색에 제대로 표현되지 않은 원본의 정렬된 현재 결과가 필요합니다. 범위가 지정된 웹 검색에만 의존하는 대신 지원되는 API 또는 MCP 통합을 제공하세요.
이러한 요구 사항에서 항상 선언적 에이전트를 대화형 인터페이스로 제외하는 것은 아닙니다. 에이전트가 입력을 수집하고 지원되는 작업을 호출하고 결과를 표시하는 동안 서비스는 비즈니스 프로세스를 소유할 수 있습니다.