Раздел «Аналитика» помогает ответить на два разных вопроса: как расходуется API и кто использует платформу. Для этого есть вкладки «API Ключи» и «Пользователи». Они описывают использование, а не автоматически рассчитанную экономию рабочего времени или качество ответов.#
Откройте данные нужной команды#
Выберите рабочее пространство, перейдите в «Настройки» → «Аналитика». Доступ к API-аналитике и аналитике участников зависит от разрешений. Если одной из вкладок нет, это может соответствовать вашей роли: право создавать запросы в чате не означает право просматривать использование всей организации.#
До сравнения показателей зафиксируйте контекст: рабочее пространство, вкладку, период и группировку. График тестового проекта за неделю и график рабочей организации за месяц нельзя сопоставлять без этих уточнений. Для обсуждения с коллегами достаточно записать выбранные параметры рядом со снимком графика.#
Посмотрите расходы API#
На вкладке «API Ключи» выберите «Период»: «Неделя», «Месяц» или «Год». Затем задайте «Группировку»:#
| Группировка | На какой вопрос отвечает |
|---|---|
| «Модель» | Какие модели дают основную долю расхода и запросов |
| «Ключ» | Какие приложения или среды создают нагрузку, если для них выданы отдельные ключи |
| «Создатель» | Как распределяется использование ключей между их создателями |
На странице представлены три показателя: «Расходы», «Запросы» и «Токены». Расход отражается в денежной единице интерфейса, запросы — в количестве обращений, токены — в объёме модельной обработки. Запрос с большой историей или длинным результатом может отличаться по токенам и расходу от короткого вопроса, даже если оба дают по одному обращению в счётчике.#
Откройте показатель в расширенном виде, чтобы рассмотреть график и таблицу. Наведение на область графика помогает увидеть отдельные значения; выбор строки или серии выделяет её. В расширенной таблице можно сортировать по колонкам «Мин», «Макс», «Среднее» и «Сумма».#
Эти статистики относятся к агрегированным точкам выбранного периода и показателя. Например, «Среднее» на графике расходов не следует автоматически читать как стоимость одного запроса. Для сравнения приложений сначала используйте общую сумму и число запросов за одинаковый период, затем при необходимости рассчитывайте дополнительный показатель с явно указанной формулой.#
Не теряйте данные в группировке#
На компактных графиках показывается ограниченное число крупнейших серий, остальные могут быть объединены как Others. Расширенный просмотр отображает больше серий, но также может объединять оставшиеся. Поэтому отсутствие отдельного названия на графике не доказывает нулевое использование.#
Смена группировки помогает разобрать суммарный рост. Сначала посмотрите модель, затем ключ, затем создателя. В текущей таблице подпись первого столбца может оставаться «Модель», даже если выбран «Ключ» или «Создатель»; смысл строк задаёт выбранная группировка. Названия самих строк помогут понять, что сейчас сравнивается.#
Если в организации один общий ключ, аналитика по нему не восстановит, какое из нескольких приложений отправило запрос. Для дальнейшего разграничения создайте отдельные API-ключи с понятными именами. Исторические запросы не перераспределятся между новыми ключами задним числом.#
Разберите неожиданное увеличение расхода#
- Выберите период, включающий день изменения.
- В группировке «Модель» посмотрите, изменился ли используемый набор моделей.
- Переключитесь на «Ключ» и найдите приложение, которое дало рост.
- Сопоставьте «Запросы» и «Токены»: выросло количество обращений или объём каждого сценария.
- Откройте список ключей, найдите запись по имени и проверьте лимит и последнее использование.
- При необходимости измените лимит или отключите конкретный ключ, затем проверьте приложение.
Эта последовательность сужает поиск. Она не объясняет сама по себе причину каждого запроса: её находят в приложении, которое использует ключ. Например, повторная отправка после ошибки, слишком длинная история или массовая обработка файлов требуют разных исправлений. Не меняйте все ключи организации из-за одного отклонения, пока данные позволяют выделить конкретный источник.#
Посмотрите активность участников#
Перейдите на вкладку «Пользователи». Поле «Поиск по имени или почте» фильтрует таблицу. В строке показаны пользователь, группа и «Последняя активность»: «Сегодня», «На этой неделе», «На прошлой неделе», «В этом месяце», «Больше месяца назад» или «Никогда».#
Активность формируется по обращениям к модели. Вход в аккаунт или открытие страницы без запроса не обязательно обновит этот показатель. «Никогда» означает отсутствие зарегистрированной активности в этих данных; это не утверждение, что человек не открывал платформу или не читал чужой результат.#
Такой список помогает найти сотрудников, которым после приглашения нужен первый рабочий сценарий. Например, отфильтруйте нового участника, предложите задачу по его роли и после выполнения убедитесь, что он смог получить результат. Не превращайте количество запросов в оценку качества работы: один полезный документ и множество неудачных повторов дают разную ценность при любой статистике обращений.#
Используйте группы#
Если доступны группы, над таблицей пользователей отображается сводка: название группы, «Количество участников» и активность за выбранное окно. Можно переключать «Активность сегодня», «Активность на этой неделе», «Активность в этом месяце». Пользователи без группы обозначаются отдельно в таблице участников.#
Группы помогают сравнивать внедрение по командам, но сначала приведите их состав в порядок в настройках участников. Число активных людей нужно оценивать вместе с общим числом участников и характером их задач. Одинаковая абсолютная активность в отделах разного размера означает разную долю пользователей.#
Размещение платформы и маршруты обработки#
В облаке интерфейс показывает данные использования, доступные для выбранной организации. Для финансового контроля сопоставляйте их с условиями тарифа; график сам по себе не заменяет договорные или расчётные документы.#
При установке Platform в контуре события использования и аналитические компоненты работают в инфраструктуре заказчика. Источниками использования могут быть как модели заказчика, так и разрешённые российские или глобальные провайдеры. Место сбора аналитики не определяет, где выполнилась модель: это отдельный маршрут.#
Если компонент сбора событий недоступен, успешный ответ модели не гарантирует немедленного появления точки на графике. Для сравнения затрат отделяйте расходы на внешнего провайдера от инфраструктурной стоимости собственных моделей. Pro и Advanced сравнивайте по доступным лимитам и реальному использованию, а не по разному набору инструментов.#
Если данные не отображаются#
Сообщение «Данные не доступны» может означать отсутствие данных в выбранном периоде; оно не является гарантией нулевого расхода. Сначала проверьте рабочее пространство, период и вкладку, затем выполните один проверочный сценарий соответствующего типа: API-запрос для API-графика или обращение в платформе для активности участника.#
Если сведения не появляются, сохраните время запроса, название ключа или пользователя, выбранный период и снимок экрана. Передайте администратору эти параметры для проверки сбора событий. Не прикладывайте полный API-ключ и содержимое пользовательских запросов к обычному снимку аналитики.#