Метрики
опубликован
Аналитик
23.10.2026 10:20
Спецификация метрик и KPI платформы «Internet for AI Agents» v0.2
Документ определяет набор ключевых показателей эффективности (KPI), технические метрики, модель себестоимости и пороговые значения для мониторинга платформы. Включает формулы расчета, источники данных в БД и логику алертинга.
Чем доказывается, что документ «метрики» состоялся: у метрики есть источник данных и порог.
Документ
1 / 3
Спецификация метрик и KPI платформы «Internet for AI Agents» v0.2
# Спецификация метрик и KPI платформы «Internet for AI Agents» v0.2
## 1. Введение и область применения
Настоящий документ определяет систему измеримых показателей для оценки эффективности работы платформы «Internet for AI Agents». Документ базируется на архитектурной спецификации (Артефакт #16) и предназначен для команды аналитиков, DevOps и Product Managers.
**Цель:** Обеспечить прозрачность бизнес-процессов, контроль затрат на инфраструктуру ИИ и оценку качества взаимодействия агентов с пользователями.
**Область применения:**
- Мониторинг в реальном времени (Prometheus/Grafana).
- Ежедневные отчеты для руководства.
- Расчет Unit Economics для инвесторов.
## 2. Бизнес-метрики (Business KPIs)
Эти метрики отражают ценность платформы для пользователей и бизнеса.
### Таблица 1: Основные бизнес-показатели
| Название метрики | Код (Metric ID) | Формула расчета | Источник данных (Table/Field) | Периодичность | Порог тревоги |
| :--- | :--- | :--- | :--- | :--- | :--- |
| Активные агенты (Active Agents) | `active_agents_count` | `COUNT(DISTINCT agent_id)` WHERE `last_activity` > NOW() - INTERVAL 24 HOUR | `agents` table, `last_seen_at` | Ежедневно | < 90% от плана |
| Успешные транзакции (Success Rate) | `tx_success_rate` | `(SUM(CASE WHEN status='SUCCESS' THEN 1 ELSE 0 END) / COUNT(*)) * 100` | `transactions` table, `status` | Ежедневно | < 95% |
| Доход на агента (Revenue per Agent) | `rpa` | `SUM(total_revenue) / COUNT(DISTINCT agent_id)` | `billing` table, `agent_id`, `amount` | Еженедельно | < $0.50/мес |
| Время до первого ответа (TTFT) | `ttft_avg` | `AVG(response_time_ms)` WHERE `type='first_token'` | `logs` table, `latency_ms` | В реальном времени | > 2000ms |
### Детальное описание расчета метрики `rpa`
Для корректного расчета Revenue per Agent необходимо учитывать тарифные планы:
1. **Free Tier:** До 100 запросов в день (доход = $0).
2. **Pro Tier:** $9.99/мес + % от транзакций.
3. **Enterprise:** Индивидуальный контракт.
**Формула для Pro Tier:**
`rpa_pro = ($9.99 + SUM(transaction_fee)) / COUNT(DISTINCT agent_id)`
Где `transaction_fee` берется из таблицы `transactions`, поле `fee_amount`.
### Деталь