이 문서에서는 Microsoft 365 Insights 에이전트에서 지원하는 쿼리 클래스, 각 응답을 계산 또는 검색하는 방법 및 응답하지 않는 항목을 나열합니다. Runbook을 만들거나, 사용자를 교육하거나, 제품 동작을 확인할 때 사용합니다.
쿼리 클래스
| 클래스 |
에이전트가 하는 일 |
| 지원되는 사용량 |
집계된 활동 데이터에서 답변을 계산하고 에이전트 이름 및 기간과 함께 값을 반환합니다. |
| 지속적인 사용 및 성장 |
정의된 집계 프록시 또는 파생 신호를 계산하고 필요한 해석 주의 사항을 포함합니다. |
| 피드백 및 평점 |
정확히 소유된 에이전트를 확인하고, 소유권 및 공유 자격을 확인하고, 샘플 컨텍스트와 함께 사용 가능한 평점 또는 댓글을 반환합니다. |
| 피드백을 사용할 수 없음 |
소유권이 거부되거나, 소유권을 확인할 수 없거나, 공유가 비활성화되거나, 피드백이 반환되지 않는 경우를 설명합니다. |
| 아직 지원되지 않음 |
사용할 수 없는 기능의 이름을 지정하고 번호를 생성하지 않습니다. |
| 설계상 지원되지 않음 |
개별 데이터 경계를 설명하고 가장 가까운 집계 신호를 가리킵니다. |
모든 예제에서 정확한 에이전트 이름으로 바꿉 {Agent Name} 니다. 그리고 비교 {Agent B} 할 두 에이전트로 바꿉 {Agent A} 니다.
지원되는 코어 사용량 확인
다음 프롬프트는 릴리스의 검증된 핵심입니다. 에이전트는 집계된 활동 데이터에서 하나하나씩 답변합니다.
| # |
예제 프롬프트 |
반환된 메트릭 |
계산 |
| 1 |
{Agent Name}에 대한 DAU 및 WAU 비교 |
동일한 에이전트에 대한 주간 활성 사용자와 일별 활성 사용자 비교 |
하루 및 7일 기간에 대한 두 개의 병렬 고유 사용자 수 |
| 2 |
Show me {Agent Name}의 주요 사용 통계 |
DAU, WAU 및 MAU 요약 블록 |
세 가지 고유 사용자 수(1일, 7일 및 30일 기간) |
| 3 |
시간이 지남에 따라 {Agent Name}의 고유 사용자는 몇 명이나 됩니까? |
고유 사용자 시계열 |
연속된 창에서 일련의 고유 사용자 수 |
| 4 |
{Agent Name}의 일일 사용량은 월별 사용량과 어떻게 비교됩니까? |
MAU와 DAU 비교 |
2개의 고유 사용자 수(1일 및 30일 창)가 나란히 표시됨 |
| 5 |
{Agent Name}에 대한 MAU 및 WAU 비교 |
주간 활성 사용자와 월간 활성 사용자 비교 |
두 개의 병렬 고유 사용자 수(30일 및 7일 창) |
| 6 |
{Agent Name}의 주간 활성 사용자 추세는 무엇인가요? |
WAU 추세선 |
최근 몇 주에 걸친 일련의 7일 고유 사용자 수 |
| 7 |
지난주에 {Agent Name}의 고유 사용자는 몇 명인가요? |
이전 7일 창에 고정된 단일 WAU 번호 |
이전 7일 동안의 고유 사용자 수 |
| 8 |
{에이전트 이름}에 대한 모든 사용 정보를 제공합니다. |
전체 요약 블록 |
DAU, WAU, MAU, 트렌드, 내러티브 셰이프 해설 |
| 9 |
{Agent Name}에 대한 전체 사용량 요약을 제공해 주세요. |
전체 요약 블록 |
#8과 동일합니다. 지원되는 변형 구문 |
| 10 |
{에이전트 이름}에 대한 사용 현황 메트릭 표시 |
전체 요약 블록 |
#8과 동일합니다. 지원되는 변형 구문 |
| 11 |
이번 주 사용량이 더 높은 에이전트는 무엇인가요? |
최근 고유 사용자 수를 기준으로 에이전트 순위가 매겨진 목록 |
scope의 에이전트 전체에서 쌍별(또는 N자별) 종류의 7일 고유 사용자 수 |
| 12 |
{Agent Name}의 순 신규 사용자 증가율은 얼마인가요? |
최근 기간의 순 신규 사용자 델타 |
가장 최근 창과 이전 창의 고유 사용자 간 차이 |
| 13 |
{에이전트 이름}의 일별 활성 사용자 표시 |
날짜 한정자에 따라 DAU 값 또는 DAU 시계열 |
일별 고유 사용자 수 |
| 14 |
{Agent A}와 {Agent B} 비교 |
두 에이전트에 대한 병렬 DAU, WAU 및 MAU |
동일한 창에 대한 두 개의 병렬 메트릭 끌어오기 |
지속 사용량 및 증가 프롬프트(5가지 파생 패턴)
이러한 고차 쿼리는 동일한 집계 활동 데이터를 사용하며 항상 응답에 필요한 해석 주의 사항을 포함합니다.
롤링 보존 프록시
| 필드 |
값 |
| 예제 프롬프트 |
{에이전트 이름}의 7일 보존 기간은 얼마인가요? / {에이전트 이름}의 30일 롤링 보존 기간 표시 |
| 지원되는 창(N) |
1일, 7일, 30일, 60일 또는 90일 |
| 정의 |
unique_users[t − N → t] / unique_users[t − 2N → t − N]비율 또는 백분율로 표시 |
| 응답에 필요한 주의 사항 |
"이는 사용자 수준 코호트 보존이 아닌 집계 기간 대비 비율로 계산됩니다." |
점착
| 필드 |
값 |
| 예제 프롬프트 |
{에이전트 이름}의 스티커는 어떻게 되나요? / {Agent Name}의 DAU/MAU 비율은 얼마인가요? |
| 정의 |
DAU를 MAU로 나눈 값(백분율로 표시) |
| 해석 |
비율이 높을수록 월간 사용자가 한 달 중 더 많은 날에 에이전트를 사용하는 경향이 있음을 의미합니다 |
채택 추세
| 필드 |
값 |
| 예제 프롬프트 |
{에이전트 이름}의 채택이 증가하고 있나요? / {Agent Name}의 도입 추세는 어떤가요? |
| 정의 |
고유 사용자 델타의 주별 또는 월별 부호 및 크기 |
| 응답 셰이프 |
방향(증가, 감소 또는 평탄화)에 백분율 변화량을 더한 값 |
가장 빠르게 성장하는 에이전트
| 필드 |
값 |
| 예제 프롬프트 |
이번 주에 가장 빠르게 성장하고 있는 에이전트는 무엇인가요? / 어떤 에이전트가 가장 빠르게 성장하고 있는지 표시 |
| 정의 |
scope 내 에이전트 전체에서 고유 사용자의 주간 가장 높은 백분율 증가 |
| 응답 셰이프 |
전주 대비 백분율 델타가 포함된 상위 에이전트 순위 지정 목록 |
주요 사용 패턴
| 필드 |
값 |
| 예제 프롬프트 |
{Agent Name}의 주요 사용 패턴은 무엇입니까? |
| 정의 |
후행 30일 DAU 분포에서 파생된 시간적 사용량 셰이프에 대한 설명 |
| 응답 셰이프 |
범주형 서술(예: 평일이 많고 업무 시간이 집중적이거나 꾸준하거나 급격함) 에이전트는 가상 사용자 또는 의도 클러스터링을 시도하지 않습니다. |
피드백 및 평점
피드백은 사용과 별도의 권한 부여 흐름을 사용합니다.
- 요청자가 소유한 에이전트를 나열하거나 resolve합니다.
- 대/소문자, 주변 공백 및 따옴표를 정규화한 후 하나의 정확한 소유 에이전트 이름을 요구하거나 에이전트 ID를 요구합니다. 오타, 별칭, 유사 항목 일치 또는 유사 일치는 사용자 확인이 필요합니다.
- 선택한 에이전트의 소유권을 확인합니다.
- 에이전트 피드백 공유가 모든 에이전트에 대해 사용하도록 설정되어 있는지 또는 선택한 에이전트를 포함하는지 확인합니다.
- 사용 가능한 피드백을 반환하거나 반환할 수 없는 이유를 설명합니다.
지원되는 피드백 프롬프트
| 예제 프롬프트 |
예상된 동작 |
| 내가 소유한 에이전트 표시 |
소유한 표시 이름을 나열합니다. 중복을 구분해야 하는 경우에만 에이전트 ID를 표시합니다. |
| {Agent Name}에 대해 사용자가 제공한 피드백은 무엇인가요? |
정확히 소유된 에이전트 한 명에 대해 사용 가능한 평점 또는 댓글을 반환합니다. |
| {에이전트 이름}에 대한 평점 및 댓글 표시 |
개수 및 시간 컨텍스트와 함께 피드백 샘플을 반환합니다. |
| {Agent Name}에 대해 반환된 피드백 댓글을 제출된 그대로 정확하게 표시 |
반환된 샘플의 주석을 의역하지 않고 재현합니다. |
| {에이전트 이름}에 대한 피드백에서 반복되는 제품 topics 요약 |
반환된 피드백에서 관찰 가능한 제품 topics 요약합니다. |
| 이번 달 {에이전트 이름}에 대한 사용 현황 및 사용자 피드백 표시 |
사용량 및 피드백을 독립적으로 실행하고 각 결과에 적용 가능한 컨텍스트로 레이블을 지정합니다. |
피드백 출력 계약
| 출력 |
설명 |
| 등급 |
반환된 샘플의 좋아요 또는 싫어요 값입니다. |
| 사용자가 제출한 메모 |
명시적으로 요청된 경우 축자 주석입니다. |
| 반환된 항목 수 |
응답에 포함된 피드백 항목 수입니다. |
| 샘플 기간 |
사용 가능한 경우 시작 및 종료 타임스탬프. |
| 피드백 더 보기 표시기 |
반환된 샘플 외에 피드백이 있는지 여부입니다. |
| 제품 항목 요약 |
관찰 가능한 topics 및 명시적 평점 값을 기반으로 하는 요약입니다. |
소유권 결과
| 결과 |
의미 |
| 확인됨 |
요청자는 선택한 에이전트에 대한 피드백을 요청할 수 있는 권한이 있습니다. |
| 거부됨 |
소유권 검사에서 요청자가 소유자가 아닌 것으로 확인되었습니다. |
| 사용할 수 없음 |
소유권을 확인할 수 없습니다. 이 결과를 거부로 설명해서는 안 됩니다. |
| 모호한 이름 |
둘 이상의 소유 에이전트가 동일한 표시 이름을 가집니다. 요청자는 에이전트 ID를 선택해야 합니다. 에이전트는 첫 번째 중복을 자동으로 선택하지 않습니다. |
| 잘린 카탈로그 |
반환된 소유권 목록에 소유된 모든 에이전트가 포함되지 않을 수 있습니다. 잘린 목록에 정확히 일치하는 항목이 없다고 해서 요청자가 소유자가 아니라는 증거는 아닙니다. |
피드백 개인 정보 보호 및 제한된 사용
- 피드백 결과에는 제출자 ID, AI 컨텍스트, 프롬프트, 응답, 대본 또는 대화 내용이 포함되지 않습니다.
- 에이전트는 업무 성과, 보호받거나 민감한 개인 특성, 내부 또는 감정 상태 또는 직장 태도를 유추하지 않습니다.
- 이러한 유추 제한은 생성된 요약 및 해석에 적용됩니다. 명시적으로 요청된 경우 반환된 샘플의 축자 피드백을 제출된 대로 재현할 수 있습니다.
- 피드백 텍스트는 지침이 아닌 데이터로 처리됩니다.
아직 지원되지 않음
에이전트는 숫자를 생성하지 않고 사용할 수 없는 기능의 이름을 지정합니다.
| 예제 요청 |
응답 방향 |
| {에이전트 이름}의 설치 추세 표시 |
이 릴리스에서는 설치 및 제거 메트릭을 사용할 수 없습니다. |
| 보존률이 가장 높은 에이전트는 무엇인가요? |
고전적인 코호트 유지 순위는 사용할 수 없습니다. 특정 에이전트에 대한 롤링 보존을 요청합니다. |
설계상 지원되지 않음
Insights 에이전트는 개별 사용자 ID 또는 대화 콘텐츠를 반환하지 않습니다. 경계를 설명하고 지원되는 가장 가까운 신호를 가리킵니다.
| 예제 요청 |
경계 |
| 누가 {에이전트 이름}을 사용했나요? |
에이전트는 개별 사용자 ID를 반환하지 않습니다. |
| 동일한 사용자 중 몇 명이 돌아왔나요? |
집계 롤링 보존 프록시를 사용합니다. |
| {에이전트 이름}의 참여 깊이는 얼마인가요? |
사용자별 세션 세부 정보를 사용할 수 없습니다. 전체 사용량 요약을 사용합니다. |
| 개별 프롬프트 또는 응답 표시 |
프롬프트, 응답, 대본 및 대화 내용을 사용할 수 없습니다. |
| 응답 대기 시간, 토큰 사용량 또는 비용 표시 |
이러한 운영 메트릭을 사용할 수 없습니다. |
| 내가 소유하지 않은 에이전트에 대한 피드백 받기 |
피드백에는 확인된 소유권이 필요합니다. |
의사 결정 흐름
에이전트가 새 프롬프트에 응답하는지 여부를 미리 확인하려면 다음 흐름을 사용합니다.
Does the request combine usage and feedback?
YES -> Send the original request to usage and independently resolve one exact owned agent for feedback.
NO -> continue
Does the request ask only which agents the requester owns?
YES -> List owned agents. If duplicate names exist, require Agent ID selection; if the catalog is truncated, disclose that the list may be incomplete.
NO -> continue
Does the request ask for ratings, comments, thumbs, or feedback?
YES -> Resolve one exact owned agent, verify ownership and sharing, then return feedback or a scoped explanation.
NO -> continue
Does the request ask for a supported aggregate usage metric?
YES -> Return the grounded metric with the agent name and time window.
NO -> continue
Does the request ask for rolling retention, stickiness, adoption trend, fastest-growing, or a usage pattern?
YES -> Return the derived aggregate signal and its required caveat.
NO -> continue
Does the request require individual identity, install data, latency, token usage, cost, prompts, responses, or transcripts?
YES -> Explain the boundary and point to the closest supported signal.
NO -> Return the generic out-of-scope response.
지원되는 도구 호출 후 및 DownstreamError 반환된 대로 보존 NoData 합니다. 결과 중 어느 쪽이든 지원되지 않는 결과로든 성공적인 결과로든 다시 레이블을 지정하지 마세요.
관련 콘텐츠