Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье перечислены классы запросов, поддерживаемые агентом Microsoft 365 Insights, способы вычисления и получения каждого ответа и ответы, на которые он не отвечает. Используйте его при создании модуля Runbook, обучении пользователей или проверке поведения продукта.
Классы запросов
| Класс | Действия агента |
|---|---|
| Поддерживаемое использование | Вычисляет ответ на основе агрегированных данных о действиях и возвращает значение с именем агента и временным окном. |
| Устойчивое использование и рост | Вычисляет определенный агрегированный прокси-сервер или производный сигнал и включает необходимое предостережение интерпретации. |
| Отзывы и оценки | Разрешается точно принадлежащий агент, проверяет право собственности и право на совместное использование и возвращает доступные оценки или комментарии с контекстом примера. |
| Отзывы недоступны | Объясняется, когда отрицается право владения, право собственности не может быть проверено, общий доступ отключен или обратная связь не возвращается. |
| Пока не поддерживается | Присваивает имя недоступной возможности и не создает число. |
| Не поддерживается дизайном | Объясняет границу индивидуальных данных и указывает на ближайший агрегатный сигнал. |
В каждом примере замените {Agent Name} его точным именем агента. Замените {Agent A} и {Agent B} с двумя агентами, которых вы хотите сравнить.
Поддерживаемые запросы на использование ядра
Следующие запросы являются проверенным ядром выпуска. Агент отвечает на каждый из них из агрегированных данных о действиях.
| # | Пример запроса | Возвращаемая метрика | Вычисление |
|---|---|---|---|
| 1 | Сравнение DAU и WAU для {Agent Name} | Количество активных пользователей в день в сравнении с еженедельно активными пользователями для одного и того же агента | Два параллельных количества разных пользователей за день и за 7-дневное окно |
| 2 | Показать статистику использования ключей {Agent Name} | Блок сводки DAU, WAU и MAU | Три разных количества пользователей (1-дневное, 7-дневное и 30-дневное окна) |
| 3 | Сколько уникальных пользователей было у {Agent Name} за определенное время? | Временные ряды для уникальных пользователей | Ряд подсчетов отдельных пользователей в последовательных окнах |
| 4 | Как ежедневное использование {Agent Name} сравнивается с ежемесячным использованием? | DAU в сравнении с MAU | Два разных количества пользователей (1-дневное и 30-дневное окна), показанные рядом |
| 5 | Сравнение MAU и WAU для {Agent Name} | Количество активных пользователей за месяц по сравнению с активными пользователями за неделю | Два параллельных количества отдельных пользователей (30-дневное и 7-дневное окна) |
| 6 | Какова тенденция активности активных пользователей за неделю для {Agent Name}? | Линия тренда WAU | Серия 7-дневных подсчетов отдельных пользователей за последние недели |
| 7 | Сколько уникальных пользователей было у {Agent Name} на прошлой неделе? | Единый номер WAU, привязанный к предыдущему 7-дневному окну | Отдельное количество пользователей за предыдущий 7-дневный период |
| 8 | Предоставьте всю аналитику по использованию для {Agent Name} | Полный блок сводки | DAU, WAU, MAU, тренд, а также комментарий к форме повествования |
| 9 | Предоставить мне полную сводку использования {Agent Name} | Полный блок сводки | То же, что и #8; Поддерживаемые варианты формулировок |
| 10 | Показать метрики использования для {Agent Name} | Полный блок сводки | То же, что и #8; Поддерживаемые варианты формулировок |
| 11 | Какие агенты используют чаще всего на этой неделе? | Ранжированный список агентов по количеству уникальных пользователей за последнее время | Попарное (или N-внутреннее) 7-дневное количество разных пользователей для разных агентов в областях |
| 12 | Каков чистый рост новых пользователей для {Agent Name}? | Чистая разница новых пользователей в последних окнах | Разница между уникальными пользователями в последнем и предыдущем окне |
| 13 | Показывать ежедневных активных пользователей для {Agent Name} | Значение DAU или временной ряд DAU, в зависимости от квалификатора даты | Количество разных пользователей по дням |
| 14 | Сравните {агент A} с {агентом B} | Параллельные DAU, WAU и MAU для двух агентов | Два параллельных запроса метрик для одних и тех же окон |
Запросы для устойчивого использования и роста (пять производных шаблонов)
Эти запросы более высокого порядка используют одни и те же совокупные данные о действиях и всегда включают в ответ требуемое предостережение об интерпретации.
Скользящий прокси-сервер хранения
| Поле | Значение |
|---|---|
| Примеры запросов | Какой срок хранения (7 дней) для {имя агента}? / Покажи 30-дневное накопительное хранение {Agent Name} |
| Поддерживаемые Windows (N) | 1, 7, 30, 60 или 90 дней |
| Определение |
unique_users[t − N → t] / unique_users[t − 2N → t − N], выраженный в виде отношения или процента |
| Обязательное предостережение в ответ | «Это вычисляется как агрегированное соотношение окна к окну, а не удержание когорты на уровне пользователя». |
Липкость
| Поле | Значение |
|---|---|
| Примеры запросов | Насколько закреплен {имя агента}? / Каково соотношение DAU/MAU для {Agent Name}? |
| Определение | DAU, деленная на MAU, выраженная в процентах |
| Устный перевод | Более высокий коэффициент означает, что ежемесячные пользователи, как правило, используют агент больше дней в течение месяца |
Тенденция внедрения
| Поле | Значение |
|---|---|
| Примеры запросов | Растет ли внедрение {Agent Name}? / Какова тенденция внедрения {Agent Name}? |
| Определение | Знак и величина разницы значений уникального пользователя "неделя за неделей" или "месяц за месяцем" |
| Фигура "Ответ" | Направление (нарастающее, убывающее или плоское) плюс процентное изменение |
Самый быстрорастущий агент
| Поле | Значение |
|---|---|
| Примеры запросов | Какой агент растет быстрее всех на этой неделе? / Показать, какой агент растет быстрее |
| Определение | Самый высокий недельный процентный прирост уникальных пользователей среди агентов в областях |
| Фигура "Ответ" | Ранжированный список лучших агентов с их недельными процентными дельтами |
Основной шаблон использования
| Поле | Значение |
|---|---|
| Примеры запросов | Каковы основные шаблоны использования {Agent Name}? |
| Определение | Описательное описание фигуры "Временное использование", полученной из конечного 30-дневного распределения DAU |
| Фигура "Ответ" | категориальный нарратив (например, насыщенный будними днями и сосредоточенный рабочий день, устойчивый или колючий); Агент не пытается выполнить кластеризацию личности или намерения |
Отзывы и оценки
В обратной связи используется отдельный от использования поток авторизации:
- Перечислить или разрешить агентов, принадлежащих автору запроса.
- Требуйте одно точное имя собственного агента после нормализации регистра, окружающих пробелов и кавычек или требуйте идентификатор агента. Опечатка, псевдоним, нечеткое или близкое совпадение требуют подтверждения пользователя.
- Подтвердите право собственности для выбранного агента.
- Убедитесь, что обмен отзывами об агенте включен для всех агентов или включает выбранного агента.
- Возврат доступного отзыва или объяснение причины, по которым его нельзя вернуть.
Поддерживаемые запросы для отзывов
| Пример запроса | Ожидаемое поведение |
|---|---|
| Показать агентов, которыми я владею | Отображает собственные отображаемые имена. Показывает идентификаторы агентов, только если они нужны для распознавания дубликатов. |
| Какие отзывы пользователи оставили о {Agent Name}? | Возвращает доступные оценки или комментарии для одного конкретного агента. |
| Показать оценки и комментарии для {Имя агента} | Возвращает образец отзыва с контекстом счетчика и времени. |
| Показать комментарии, возвращенные для {Agent Name}, в том виде, в котором они были отправлены | Воспроизводится комментарий в возвращенном образце без их перефразирования. |
| Резюмировать повторяющиеся темы продуктов в отзывах для {Agent Name} | Обобщает наблюдаемые темы продуктов из возвращенных отзывов. |
| Показать использование и отзывы пользователей для {Agent Name} в этом месяце | Использует и отзыв независимо и помечает каждый результат соответствующим контекстом. |
Контракт вывода отзывов
| Вывод | Описание |
|---|---|
| Оценки | Значения "нравится" или "не нравится" в возвращаемой выборке. |
| Комментарии, отправленные пользователями | Дословные комментарии по явному запросу. |
| Количество возвращенных элементов | Количество элементов отзыва, включенных в ответ. |
| Интервальный интервал | Метки времени начала и окончания, если они доступны. |
| Индикатор дополнительных отзывов | Существует ли обратная связь за пределами возвращенного образца. |
| Сводка по теме продукта | Сводка, основанная на наблюдаемых темах и явных оценочных значениях. |
Результаты ответственности
| Результат | Значение |
|---|---|
| Проверено | Инициатор запроса уполномочен запрашивать обратную связь для выбранного агента. |
| Отказано | Проверка права собственности определила, что инициатор запроса не является владельцем. |
| Недоступно | Не удалось проверить право собственности. Этот результат не следует описывать как отрицание. |
| Неоднозначное имя | Одно и то же отображаемое имя используется несколькими агентами. Инициатор запроса должен выбрать идентификатор агента; Агент никогда не выбирает первый дубликат автоматически. |
| Усеченный каталог | Возвращенный список владельцев может не включать всех владельцев агентов. Отсутствие точного совпадения в усеченном списке не является доказательством того, что инициатор запроса не является владельцем. |
Конфиденциальность отзывов и ограничение использования
- Результаты отзыва не включают личность отправителя, контекст ИИ, запросы, ответы, расшифровки или содержимое беседы.
- Агент не делает вывод о производительности труда, защищенных или чувствительных личностных характеристиках, внутренних или эмоциональных состояниях или отношении к рабочему месту.
- Эти ограничения вывода применяются к созданным сводкам и интерпретациям. При явном запросе дословный отзыв в возвращенном образце может быть воспроизведен в том виде, в котором он отправлен.
- Текст отзыва рассматривается как данные, а не как инструкции.
Пока не поддерживается
Агент называет недоступную возможность, не создавая номер.
| Пример запроса | Направление ответа |
|---|---|
| Показать тенденции установки для {Agent Name} | Метрики установки и удаления недоступны в этом выпуске. |
| У каких агентов лучший показатель хранения? | Классические рейтинги удержания когорт недоступны; Запрос на сохранение последовательного хранения для определенного агента. |
Не поддерживается дизайном
Агент Insights не возвращает идентификаторы отдельных пользователей или содержимое бесед. Он объясняет границу и указывает на ближайший поддерживаемый сигнал.
| Пример запроса | Максимальное |
|---|---|
| Кто использовал {Agent Name}? | Агент не возвращает отдельные идентификаторы пользователей. |
| Сколько из тех же пользователей вернулось? | Используйте прокси-сервер aggregate rolling-retention. |
| Какова глубина взаимодействия для {Agent Name}? | Сведения о сеансе пользователя недоступны. Используйте полную сводку использования. |
| Отображение отдельных запросов или ответов | Запросы, ответы, расшифровки и содержимое бесед недоступны. |
| Отображение задержки отклика, использования маркера или стоимости | Эти операционные показатели недоступны. |
| Получение отзыва об агенте, владельцем которого я не являюсь | Для отправки отзыва требуется подтвержденное владение. |
Поток принятия решений
Чтобы заранее узнать, отвечает ли агент на новый запрос, воспользуйтесь следующей последовательностью действий.
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.
После вызова поддерживаемого средства сохранить NoData и DownstreamError как возвращено. Не перевешивайте ни один результат на неподдерживаемый или как успешный.