Microsoft 365 Copilot용 선언적 에이전트의 MCP 앱에 대한 사용자 환경 지침

이 가이드에서는 Microsoft 365 Copilot에서 MCP 기반 UI 환경을 빌드하는 개발자를 위한 UX(사용자 환경) 지침을 제공합니다. Copilot의 대화 흐름에 원활하게 통합되는 네이티브의 일관된 작업 중심 상호 작용을 만드는 패턴을 다룹니다.


UX 원칙

MCP 기반의 풍부한 UI를 사용하여 훌륭한 Copilot 에이전트를 빌드한다는 것은 Copilot에 기본으로 느껴지는 집중된 대화형 환경을 제공하는 것을 의미합니다. Copilot 에이전트는 Copilot 내에서 다시 빌드된 전체 애플리케이션이 아닌 적시에 올바른 작업을 표시하는 대화의 유용한 확장처럼 느껴져야 합니다.

대화형 가치 전달

  • 에이전트는 독립 실행형 UI보다 Copilot 내에서 더 큰 가치를 제공해야 합니다.
  • 자연어, 스레드 컨텍스트 및 다중 회전 상호 작용을 활용하여 기존 탐색 모델에서는 어렵거나 비효율적인 워크플로를 구현합니다.
  • 기존 흐름을 복제하는 것이 아니라 대화를 활용하는 환경을 설계합니다.

기능을 추출하고 인터페이스를 복제하지 않음

전체 애플리케이션 환경을 Copilot으로 포팅하지 마세요. 대신 도구로 노출될 수 있는 고가치의 원자성 기능을 식별합니다. 각 기능은 다음과 같아야 합니다.

  • 필요한 최소한의 입력만 필요합니다.
  • 구조적이고 신뢰할 수 있는 출력을 반환합니다.
  • 모델이 자신 있게 다음 단계를 결정할 수 있도록 합니다.

Copilot의 네이티브 느낌을 주는 디자인

  • Copilot의 디자인 시스템, 구성 요소, 상호 작용 패턴을 활용하여 원활하고 예측 가능한 환경을 보장합니다.
  • 일관성은 인지 부하를 줄이고 예측 가능성을 높이며 사용자가 새로운 상호 작용 모델을 학습할 필요성을 최소화합니다.

사용자 제어 유지

신뢰는 엔터프라이즈 채택의 기초입니다. 특히 작업이 엔터프라이즈 데이터에 영향을 미칠 때 사용자는 최종 의사 결정권자로 남아야 합니다. 제공하다:

  • 에이전트 작업에 대한 명확한 가시성
  • 중요한 작업에 대한 명시적 확인
  • 생성, 수정 또는 업데이트된 항목에 대한 투명한 결과

의도를 사용하여 밀도 크기 조정

사용자의 즉각적인 필요에 맞게 UI의 시각적 공간을 조정합니다.

  • 한눈에 볼 수 있는 요약과 개략적인 작업을 위해 인라인 위젯을 사용하세요.
  • 사용자가 채팅과 함께 작업하기 위해 더 큰 공간이 필요한 작업에 확장 보기를 사용합니다.

Chat 표면

Chat 표면은 사용자가 Copilot 앱 SDK를 사용하여 빌드된 에이전트와 상호 작용하는 기본 방식으로, Copilot 대화 내에서 앱이 표시되고 작동하는 방식을 정의합니다.

Copilot용으로 디자인할 때 다음 핵심 원칙을 따르세요.

  • 대화 우선: 채팅은 기본 상호 작용 모델로 유지됩니다.
  • 점진적인 복잡성: 경량으로 시작합니다. 필요한 경우에만 확장합니다.
  • 컨텍스트 보존: 사용자는 대화형 컨텍스트를 잃어서는 안 됩니다.
  • 중복에 대한 Clarity: 앱 UI와 모델 텍스트는 콘텐츠를 반복하는 것이 아니라 서로를 보완해야 합니다.

Copilot은 현재 두 가지 기본 채팅 표면을 지원합니다. 각 표면은 고유한 용도로 사용되며 상호 작용의 복잡성과 깊이에 따라 선택해야 합니다.

  • 모든 앱은 생성된 모델 응답 앞에 인라인 위젯이 표시되는 인라인 모드를 지원해야 합니다.
  • 병렬 모드 는 더 풍부한 상호 작용이 필요할 때 사용할 수 있는 선택적 표면입니다.

Copilot 채팅에서 인라인 모드와 나란히 모드를 비교하는 이미지


인라인 모드

인라인 모드는 Copilot의 기본 대화 중 채팅 표면입니다. 인라인은 미니 애플리케이션이 아닙니다. 그것은 대화를 향상시키지 대체하지는 않습니다.

인라인 모드의 위젯 예

인라인 모드를 사용하는 경우

인라인은 다음과 같은 경우에 권장됩니다.

  • 미리 보기(문서, 이미지, 초안)
  • 확인
  • 간단한 작업
  • 신속한 의사 결정 프롬프트

인라인 환경은 간결하게 유지되어야 하며 응답의 단일 스크롤 내에 이상적으로 맞아야 합니다.


인라인 모드 레이아웃

Copilot 채팅의 인라인 모드 레이아웃

  • 에이전트 헤더: 응답하는 에이전트를 식별하고 컨텍스트를 설정합니다.
  • 인라인 위젯: 구조화된 콘텐츠, 미리 보기 또는 작업 컨트롤을 표시하는 데 사용됩니다.
  • 모델 응답: 편집, 다음 단계 및 관련 작업을 제안하는 위젯 뒤에 표시되는 짧은 모델 생성 메시지입니다.

인라인 위젯

인라인 위젯은 채팅 흐름 내에 직접 표시되므로 사용자는 대화를 종료하지 않고도 정보를 보고 조치를 취할 수 있습니다. 빠른 확인, 간단한 작업 또는 시각 자료를 제공합니다.

  • 제목: 카드가 문서 기반이거나 상위 요소가 있는 항목이 포함된 경우 제목을 포함합니다.
  • 나란히 보기로 확장: 카드에 리치 미디어나 상호작용이 포함된 경우 나란히 표시 모드를 여는 데 사용합니다.
  • 작업: 카드 하단에 배치된 작업을 두 개로 제한합니다. 작업은 대화 차례나 도구 호출을 수행해야 합니다.
상호 작용 지침
  • 상호 작용에 집중 유지: 다단계 흐름, 중첩된 탐색 또는 심층 구성을 피합니다. 작업에 반복, 비교 또는 광범위한 편집이 필요한 경우 나란히로 이동합니다.
  • 시스템이 아닌 요약 표시: 인라인은 전체 응용 프로그램이 아닌 미리 보기를 표시합니다. 내부 스크롤, 페이지 매김, 탭, 필터 또는 다단계 그룹화를 피하세요.
  • 상태를 명시적으로 만들기: 인라인 상호 작용은 로드 상태, 비활성화된 상태, 성공 확인, 복구 옵션이 있는 오류 상태와 같은 명확한 시스템 피드백을 제공해야 합니다. 시스템 상태 전달을 위해 모델 텍스트만 의존하지 마십시오.
  • 대화형 흐름 유지: 위젯은 단일 응답 스크롤 내에 편안하게 들어가야 합니다. 뷰포트를 지배하지 않아야 합니다. 모델 응답과 경쟁하는 것이 아니라 보완해야 합니다.

병렬 모드(선택 사항)

병렬 모드는 대화와 함께 표시되는 확장된 몰입형 작업 영역을 제공합니다. 인라인 표면 내에서 효과적으로 제공할 수 없는 풍부한 워크플로를 위해 설계되었습니다. 가벼운 상호 작용에 최적화된 인라인 모드와 달리 병렬 모드는 대화형 컨텍스트를 유지하면서 더 깊은 참여를 위한 전용 작업 영역을 만듭니다.

나란히 모드는 선택 사항이며 의도적으로 사용해야 합니다.

병렬 모드를 사용하는 경우

환경에서 다음이 필요한 경우 병렬 모드를 사용합니다.

  • 다단계 편집 또는 구성
  • 영구적인 상태의 반복적인 워크플로
  • 복잡한 시각적 레이아웃(테이블, 캔버스, 대시보드)
  • 확장 검토 또는 비교 작업
  • 풍부한 작성(문서 초안 작성, 디자인 편집, 구조화된 입력)
  • 단일 스크롤을 넘어서는 작업 영역 수준 상호 작용
  • 작업을 간결한 단일 턴 상호 작용으로 완료할 수 있는 경우 대신 인라인 모드를 사용합니다.

나란히 배치

Copilot 채팅의 나란히 배치

  • 대화 창: 의도 및 제어의 주요 소스로 남아 있는 Copilot 채팅입니다.
  • 치클릿 카드: 병렬 모드가 활성화되면 원래 인라인 위젯이 대화에서 컴팩트한 카드로 축소되어 확장된 작업 공간과 함께 컨텍스트를 보존합니다.
  • 나란히 표시 패널 머리글: 에이전트 ID(아이콘 및 이름)를 표시하고 전체 애플리케이션에 대한 전달 옵션을 포함합니다.
  • 앱 작업 영역: 구조화된 콘텐츠를 편집, 검토 또는 관리하기 위한 더 큰 MCP 렌더링 표면입니다. 이는 독립 실행형 애플리케이션 셸이 아닌 Copilot 내의 상황에 맞는 작업 영역입니다.
  • 상황에 맞는 컨트롤: 작업 영역 내의 작업별 컨트롤(예: 편집 도구, 서식, 확대/축소, 내보내기).
상호 작용 지침
  • 작업 영역을 상황에 맞게 유지: 병렬 모드는 전체 애플리케이션 셸이 아닌 포커스가 있는 작업별 작업 영역을 제공합니다. 전역 탐색, 다중 탭 시스템, 설정 패널 또는 관련 없는 기능을 피하세요. 환경이 전체 SaaS 제품과 유사한 경우 scope를 초과합니다.
  • 채팅을 기본으로 유지: 대화는 여전히 의도와 제어의 원천으로 유지됩니다. 사용자는 병렬 모드가 열려 있는 동안 채팅을 계속할 수 있어야 하고, 작업 중간에 명확한 질문을 하고, 작업 영역과 함께 Copilot 추론을 볼 수 있어야 합니다.
  • 활성 작업으로 범위: 병렬 모드는 일관된 단일 워크플로를 지원해야 합니다. 관련 없는 엔터티 간에 전환하거나 중첩된 환경을 시작하지 마세요. 여러 워크플로가 필요한 경우 별도의 표면 또는 작업으로 분할합니다.
  • 상태를 명시적으로 만들기: 인라인 상호 작용은 로드 상태, 비활성화된 상태, 성공 확인, 복구 옵션이 있는 오류 상태와 같은 명확한 시스템 피드백을 제공해야 합니다. 시스템 상태 전달을 위해 모델 텍스트만 의존하지 마십시오.
  • 점진적 에스컬레이션 유지: 나란히 모드는 의도적으로 입력해야 합니다. 간단한 미리 보기 또는 빠른 확인을 위해 나란히 정렬되도록 기본 설정하지 마세요.

모범 사례

다운로드 단추가 있는 위젯 스크린샷

위젯의 FluentUI 구성 요소 스크린샷

✅ 대화형 흐름 유지

인라인 위젯은 가볍고 작업 지향적으로 유지하세요. 최대 두 가지 기본 작업(예: 승인, 편집, 다운로드)을 지원합니다. 작업에 심층적인 탐색, 다단계 워크플로 또는 과도한 구성이 필요한 경우 나란히 모드로 전달합니다.

✅ 기본 맞춤에 Fluent 구성 요소 사용

인라인 환경은 Copilot의 자연스러운 확장처럼 느껴져야 합니다. Copilot에 맞추어진 Fluent 2 구성 요소, 간격, 입력 체계, 토큰을 사용하여 시각적 및 상호 작용의 일관성을 보장합니다.

'문서 열기' 표시기가 있는 위젯의 스크린샷

전체 응용 프로그램을 모방한 위젯의 스크린샷

✅ 위젯 상태 처리 제공

위젯은 로드 상태, 비활성화 상태, 성공 확인, 복구 옵션이 있는 오류 상태와 같은 명확한 시스템 피드백을 제공해야 합니다.

❌ 전체 응용 프로그램과 유사하게 위젯을 사용하지 마세요.

인라인 모드는 채팅에 포함된 전체 애플리케이션이 아니라 채팅의 자연스러운 확장처럼 느껴져야 합니다.

자연어 프롬프트가 있는 위젯의 스크린샷

여러 탭이 있는 위젯의 스크린샷

❌ 위젯에서 Copilot 기능을 복제하지 않음

위젯 내에서 채팅 기능(프롬프트 입력, 제안, 추론 요약, 재시도 컨트롤)을 다시 만들지 마세요. 중복으로 인해 혼란, 시각적 노이즈 및 조각화된 상호 작용 모델이 발생합니다.

❌ 위젯에서 심층 탐색 피하기

위젯에는 여러 탭이나 더 깊은 탐색이 포함되어서는 안 됩니다. 이를 별도의 카드나 도구 작업으로 분할하는 것이 좋습니다.

큰 스크롤 막대가 있는 위젯의 스크린샷

모델 텍스트의 콘텐츠를 복제하는 위젯의 스크린샷

❌ 크고 스크롤이 많은 레이아웃 피하기

인라인 위젯은 간결하고 한눈에 볼 수 있어야 합니다. 위젯 내에서 세로 스크롤을 피하세요. 높이는 응용 프로그램 크기가 아니라 위젯 크기로 느껴져야 합니다. 콘텐츠에 스크롤, 복잡한 표 또는 자세한 편집이 필요한 경우 나란히 모드로 전환합니다.

❌ 모델 텍스트 및 위젯의 콘텐츠를 복제하지 마세요.

위젯과 모델 메시지 모두에서 동일한 정보를 반복하지 마십시오.


시각적 디자인 지침

시각적 및 상호 작용 일관성은 Copilot의 사용자 환경에 매우 중요합니다. 앱은 사용자가 예측 가능한 동작, 친숙한 컨트롤 및 앱 전반에 걸쳐 일관된 환경을 경험하도록 Fluent 디자인 시스템과 일치해야 합니다. 이러한 일관성을 통해 사용자는 신뢰를 구축하고, 워크플로 간에 자신 있게 이동하고, Copilot 내의 여러 앱에서 안전하게 조치를 취할 수 있습니다.

Fluent Copilot 테마 지침

Fluent 2 UI 키트를 사용하여 아름답고 응집력 있는 Microsoft 환경을 만드세요. Figma에서 빌드된 Fluent 2 UI 키트에는 코드 라이브러리에 매핑되는 디자인 자산이 포함되어 있습니다. 즉, 디자인에서 개발까지 원활한 핸드오프가 이루어집니다.

입력 체계

Fluent 2 > 입력 체계: 다양한 텍스트 크기 및 스타일의 스크린샷

반경

Fluent 2 > 도형 사각형 도형의 모서리 반경 스크린샷

간격

앱 카드의 전역 안쪽 여백은 24픽셀이어야 합니다. 카드 주위의 패딩 스크린샷