Achilles — AI Foundation: Учёт расходов

Платформа метит каждый вызов модели — кто, на что и сколько потратил, — чтобы показать расход и держать бюджет. Учёт сквозной: один денежный агрегат по моделям плюс привязка токенов к людям из журналов. Деньги считаются по моделям и по компании; по людям — пока в токенах.

✦ Вызовы AI индексация · поиск
чат · агенты

──▶ каждый вызов метится

▦ Учёт — два пути model_usage · агрегат
журналы · атрибуция

──▶ читает экран

▤ Расходы AI итого · по людям
по моделям · лимиты

model_usage — полный расход платформы, в деньгах журналы — привязка токенов к человеку

Что считаем и откуда → Расходы AI

Экран показывает четыре среза; у каждого — свой источник, единица и охват. Один контур учёта, четыре проекции.

Срез	Источник	Единица	Охват
Итого по компании	`model_usage` · `SUM` за период	токены + $	все функции
По сотрудникам	журналы: `messages` · `agent_runs`	токены	чат + агенты
По моделям	`model_usage` · по модели · функции	$ (вход / выход)	все функции
Лимиты	`platform_settings`	токены · $	потолки + оповещение

Почему два источника

Расход пишется в два места не от дублирования, а потому что они отвечают на разные вопросы.

model_usage агрегат

копит requests · вход · выход · cost по модели · функции · дню
ловит и безличный расход — индексацию и RAG-поиск
основа для «итого по компании» и «по моделям», в деньгах

журналы атрибуция

чат — messages.tokens_used; агенты — agent_runs.tokens_used
расход на человека — SUM из журналов, без счётчика
основа для «по сотрудникам», в токенах

Пересекаются по чату и агентам, но агрегат шире: он ловит индексацию и поиск, которые к человеку не привязать. Поэтому «итого по компании» ≠ сумме по людям. Деньги на человека требуют разнести цену вход/выход по каждому сообщению и прогону — это v2.

Периоды и бюджет

Панорама за неделю, месяц и год — это одна и та же таблица под разным окном.

Итого по периоду — производная SUM по model_usage за календарное окно (неделя · месяц · год), не отдельная таблица-счётчик. Тот же приём, что у бюджета агентов — «бюджет производный».
Оповещение о бюджете — месячный $-порог на всю организацию (ai_monthly_budget): месячная плитка «итого» сверяется с ним, при достижении — уведомление типа Budget, запросы не блокируются.
Недельные токен-потолки на сотрудника (агенты · чат) сверяются с журнальным расходом, окно календарное, сброс в воскресенье 00:00 в зоне организации.

Границы v1 / v2

v1 Токены везде; деньги по моделям и по компании; месячное оповещение о бюджете; недельные токен-потолки (агенты — блокирующий, чат — справочный).

v2 Бюджеты по орг-структуре — потолки и оповещения не двумя полюсами (вся компания + человек), а развитой системой выделения токенов на команды и отделы, по иерархии. Деньги на человека; тренды, графики и экспорт; блокировка чата сверх потолка; суточный агрегат user_usage при росте нагрузки.