Справочник по запросам и возможностям для агента Microsoft 365 Insights

В этой статье перечислены классы запросов, поддерживаемые агентом 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
Фигура "Ответ" категориальный нарратив (например, насыщенный будними днями и сосредоточенный рабочий день, устойчивый или колючий); Агент не пытается выполнить кластеризацию личности или намерения

Отзывы и оценки

В обратной связи используется отдельный от использования поток авторизации:

  1. Перечислить или разрешить агентов, принадлежащих автору запроса.
  2. Требуйте одно точное имя собственного агента после нормализации регистра, окружающих пробелов и кавычек или требуйте идентификатор агента. Опечатка, псевдоним, нечеткое или близкое совпадение требуют подтверждения пользователя.
  3. Подтвердите право собственности для выбранного агента.
  4. Убедитесь, что обмен отзывами об агенте включен для всех агентов или включает выбранного агента.
  5. Возврат доступного отзыва или объяснение причины, по которым его нельзя вернуть.

Поддерживаемые запросы для отзывов

Пример запроса Ожидаемое поведение
Показать агентов, которыми я владею Отображает собственные отображаемые имена. Показывает идентификаторы агентов, только если они нужны для распознавания дубликатов.
Какие отзывы пользователи оставили о {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 как возвращено. Не перевешивайте ни один результат на неподдерживаемый или как успешный.