에이전트 홈페이지는 에이전트의 기본 방문 보기입니다. 여기서 사용자는 범위가 지정된 환경에서 상호 작용을 시작합니다. 일반적으로 에이전트의 이름, 아이콘 및 특성을 제공하며, 관련 기능에 대한 컨텍스트 및 빠른 액세스를 제공하기 위해 목적에 따라 다른 요소(예: 과거 상호 작용, 대시보드 또는 미디어 갤러리)를 포함할 수 있습니다.
이러한 기본 요소를 올바르게 얻는 것은 필수적입니다. ID를 설정하고, 기대치를 설정하고, 첫 번째 메시지를 보내기 전에 신뢰를 알릴 수 있습니다.
에이전트 홈페이지는 몇 가지 고유한 요소로 구성됩니다. 각 요소는 사용자가 에이전트를 이해하고 참여하도록 돕는 데 특정 역할을 합니다.
| 요소 | 설명 |
|---|---|
| 제목 표시줄 | 기본 에이전트 정보, 탐색 및 기본 옵션을 표시합니다. |
| 아이콘 | 에이전트의 브랜딩 요소로, 사용자가 쉽게 인식할 수 있습니다. |
| 이름 | 에이전트의 고유 식별자 또는 제목으로, 사용자가 용도 또는 기능을 인식할 수 있도록 지원합니다. |
| Attribution | 사용자가 에이전트의 신뢰성과 안정성을 확인할 수 있도록 에이전트 뒤에 수단 또는 조직을 표시합니다. |
| 채팅 입력 상자 | 사용자가 에이전트와 상호 작용하여 쿼리 또는 명령을 입력할 수 있도록 하는 기본 수단입니다. 채팅 입력 상자는 네이티브 Microsoft 365 Chat 동일한 지침을 따라 일관된 환경을 보장합니다. |
| 프롬프트 시작 | 사용자가 항목을 입력하기 전에 에이전트의 시작 화면에 표시되는 짧고 클릭 가능한 제안입니다. 사용자는 시작하는 방법과 에이전트가 수행할 수 있는 작업을 안내합니다. |
Icon
아이콘은 사용자가 에이전트와 연결하는 첫 번째 시각적 신호입니다. 브랜드와 명확하고, 목적이 있고, 일관성이 있어야 합니다.
에이전트 아이콘을 디자인할 때 다음 지침을 따릅니다.
- 에이전트의 용도를 반영하는 간단하고 인식 가능한 이미지를 사용합니다.
- 아이콘이 작은 크기로 작동하는지 확인합니다. 제목 표시줄, 채팅 선택기 및 에이전트 저장소와 같은 컴팩트한 UI 화면에 표시됩니다.
- 아이콘의 텍스트를 사용하지 마세요. 이름은 별도로 식별됩니다.
- 크기, 모양 및 색 요구 사항에 대한 Teams 앱 아이콘 지침을 따릅니다.
메모
아이콘은 앱 패키지의 일부입니다. 게시하기 전에 아이콘 자산이 Teams 스토어 요구 사항을 충족하는지 확인합니다. 에이전트에 대한 유효성 검사 지침에 대해 자세히 알아보세요.
Name
이름은 타이틀 표시줄, 에이전트 선택기, 채팅 기록 및 에이전트 저장소에서 에이전트 환경 전체에서 사용자가 볼 수 있는 고유 식별자입니다. 에이전트의 용도를 즉시 전달해야 합니다.
에이전트 이름을 지정할 때 다음 지침을 따릅니다.
- 에이전트의 함수 또는 도메인을 반영하는 명확하고 간결한 이름을 사용합니다. 예: Contoso Ticket Manager 또는 Sales Pipeline Agent.
- "최고", "놀라운" 또는 "#1"과 같은 최상급 표현은 피하세요.
- 에이전트를 다른 이름과 구별하지 않는 지나치게 일반적인 이름을 사용하지 마세요.
- 선언적 에이전트의 경우, 선언적 에이전트 JSON 파일인
name의manifest.json값과 모든 플러그인 JSON 파일의name_for_human는 동일해야 합니다. - 이름에 명령문, URL, 이모지 또는 숨겨진 문자를 사용하지 마세요.
Important
UI의 에이전트 이름은 매니페스트에 정의된 이름과 정확히 일치해야 합니다. 불일치로 인해 저장소에 게시할 때 유효성 검사 오류가 발생할 수 있습니다.
기여
출처 표시는 에이전트를 제공하는 게시자 또는 조직을 표시합니다. 에이전트 홈 페이지에 표시되며, 사용자가 에이전트와 상호작용하기 전에 그 출처를 확인하는 데 도움이 됩니다.
명확한 출처 표시는 사용자 신뢰를 높이는 데 도움이 됩니다. 에이전트를 빌드한 사용자를 식별하고 해당 엔터티에 책임을 물을 수 있는 사용자는 자신 있게 참여할 가능성이 높습니다. 이 신뢰는 에이전트가 중요한 워크플로 또는 데이터를 처리할 수 있는 엔터프라이즈 환경에서 특히 중요합니다.
표기된 이름이 Partner Center에 등록된 실제 조직 이름과 일치하는지 확인하세요. 에이전트가 독립적으로 게시된 경우, Microsoft에서 구축했거나 퍼스트 파티 에이전트임을 암시하는 오해의 소지가 있는 표기는 피하세요.
프롬프트 스타터
프롬프트 시작은 에이전트의 시작 화면에 표시되는 짧고 클릭 가능한 제안입니다. 사용자가 어떤 것을 입력하기 전에 의미 있는 상호 작용으로 안내합니다.
효과적인 프롬프트 시작 문구:
- 실제 사용 사례를 반영합니다. 각 시작은 에이전트가 실제로 완료할 수 있는 작업에 해당해야 합니다.
- 일반 동작 지향 언어를 사용합니다. 동사 또는 명확한 질문으로 리드. 전문 용어를 사용하지 마십시오.
- 에이전트의 다양한 기능을 다룹니다. 한 기능을 중심으로 모든 스타터를 클러스터링하지 마세요.
- 간략하게 유지합니다. 각 프롬프트 시작은 128자를 초과하지 않아야 합니다.
첫 실행 사용자 환경
사용자가 에이전트에 처음으로 액세스하면 홈페이지에 에이전트의 아이콘, 이름, 특성 및 프롬프트 시작이 표시됩니다. 대화 기록이 없습니다. 지금이 바로 강한 첫인상을 남기는 순간입니다.
첫 실행 환경은 다음과 같아야 합니다:
- 즉시 ID와 목적을 설정합니다. 사용자는 에이전트가 도착한 후 몇 초 이내에 수행하는 작업을 알고 있어야 합니다.
- 시작 장벽을 낮춥다. 프롬프트 시작은 사용자에게 구체적이면서 신뢰할 수 있는 진입점을 제공하여 빈 프롬프트 문제를 제거합니다.
- 정확한 기대치를 설정합니다. 이름, 특성 및 프롬프트 스타터의 조합은 에이전트가 수행할 수 있는 작업과 수행할 수 없는 작업을 함께 전달해야 합니다.
첫 실행 환경을 설계하는 방법에 대한 자세한 지침은 에이전트에 대한 사용자 중심 디자인으로 이동하세요.
사용자 환경 반환
재방문 사용자가 에이전트를 열면 홈 페이지에 이전에 하던 작업을 이어서 할 수 있도록 돕는 추가 정보가 표시됩니다.
채팅 선택기
채팅 선택기는 사용자 지정할 수 없지만 사용자가 에이전트를 사용하여 채팅 세션 기록을 쉽게 탐색할 수 있습니다. 반환되는 사용자 보기에 이전 대화의 탐색 가능한 목록으로 표시되므로 사용자가 컨텍스트를 반복하지 않고 이전 상호 작용을 다시 시작할 수 있습니다.
List
목록은 사용자 지정할 수 없지만 에이전트 도메인의 최근 항목 또는 관련 항목을 홈페이지에 직접 표시하는 선택적 구성 요소입니다. 새 프롬프트 없이 이전 출력, 추적된 항목 또는 큐레이팅된 콘텐츠에 빠르게 액세스할 수 있습니다.
홈 페이지
단일 채팅 입력을 넘어서는 에이전트의 경우 탐색 및 목록 보기를 사용하여 홈 페이지를 확장할 수 있습니다. 이러한 구성 요소를 사용하면 기능을 더 쉽게 찾을 수 있고, 대시보드와 비슷한 보다 풍부하고 익숙한 상호 작용이 가능해집니다.
네비게이션
탐색을 사용하면 에이전트가 단일 홈페이지 내에서 여러 보기 또는 모드를 표시할 수 있습니다. 예를 들어 에이전트는 홈 탭과 인사이트 탭을 제공할 수 있으므로 사용자는 대화형 인터페이스와 데이터 요약 보기 간에 전환할 수 있습니다.
에이전트에 지속적인 최상위 액세스의 이점을 제공하는 의미 있는 고유한 표면이 있는 경우 탐색을 사용합니다.
관련 콘텐츠
- 에이전트에 대한 유효성 검사 지침입니다. 에이전트 이름, 프롬프트, 적응형 카드 응답 등에 대한 제출 요구 사항을 저장합니다.
- Teams 앱 디자인 기본 사항 Teams 및 Copilot 앱에 대한 레이아웃, 아이콘, 입력 체계, 색 및 셰이프 지침입니다.