AIKraft/Skills/scenario-admin-analytics

scenario-admin-analytics

Помогает с аналитикой администратора Scenario: потребление Creative Unit, популярные модели, использование по пользователям или проектам, отчеты, CSV-экспорт и локальный дашборд. Подходит для вопросов по usage API, adoption и кэшированным данным.

SCScenario official Данные ★ 1.8k

Что делает навык

Навык преобразует данные использования Scenario через MCP в ответы, CSV, Markdown, PDF с графиками или локальный дашборд, собирая данные исключительно через MCP без прямого API или скрапинга. Он решает задачи аналитики потребления Creative Unit (CU), популярности моделей, использования по пользователям или проектам, а также экспорта отчетов.

Когда применять

  • Анализ потребления CU и количества задач (jobs) по топ-моделям или конкретным пользователям за заданный период.
  • Генерация CSV-экспорта с группировкой данных по месяцам UTC или создание PDF-отчетов с графиками.
  • Построение локального дашборда для фильтрации данных по пользователям, моделям и датам.
  • Объяснение расхождений между общим потреблением CU и активностью моделей через анализ журналов usage и activity.

Как работает

  1. Определить контекст (team_id, project_id) и масштаб (scope: team или project), а также временные границы запроса.
  2. Получить текущую схему данных через scenario_tools_search или использовать прямой вызов usage с параметром include для получения modelUsages.daily и entities.
  3. Выполнить запросы к API usage, соблюдая правила инклюзивных дат, агрегации по UTC дням и обработки пагинации activity.
  4. Обработать данные: суммировать consumption[].value (уже со скидками), ранжировать модели и пользователей, избегать двойного вычета скидок.
  5. Сформировать итоговый ответ, CSV или PDF, используя локальные скрипты или шаблоны, с сохранением метаданных о времени получения.
  6. Проверить согласованность данных (reconciliation) между общим потреблением, суммами по моделям и пользователям.

Примеры запросов агенту

Покажи топ-5 моделей по потреблению CU для каждого пользователя за последние три месяца.
Сгенерируй CSV-отчет с ежемесячным потреблением всех моделей за прошлый квартал.
Объясни разницу между общим потреблением CU и суммой по моделям за выбранный период.

Что понадобится

  • Доступ к Scenario MCP для сбора данных (без прямого API или SDK).
  • Установленные навыки сценария (scenario skill) для настройки подключения.
  • Локальное окружение с Python и вспомогательными скриптами для генерации PDF/дашбордов (опционально, для расширенного экспорта).

Описание составлено по SKILL.md навыка, сверено 04.11.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «scenario-admin-analytics» из репозитория: # https://github.com/scenario-labs/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r scenario-admin-analytics/ ~/.claude/skills/scenario-admin-analytics/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.