Бюджеты и расходы
Смотрите стоимость каждого запуска, задавайте бюджеты для организации, проектов, агентов и отдельных задач и узнайте, что происходит на 80 и 100 %.
Каждый запуск сохраняет свою стоимость. Бюджеты ограничивают расходы до того, как они произойдут, а не после: когда лимит исчерпан, работа приостанавливается, пока человек не решит продолжить.
Откуда берутся расходы
Каждый запуск сообщает провайдера, модель, токены и стоимость. Veyra суммирует их по агентам, задачам, проектам, рутинам и дням. Запуски по подписке учитывают её стоимость отдельно от потокенного использования, чтобы были видны обе части.
Примечание
Цифры Veyra — это её собственный учёт запусков. Это не счёт вашего провайдера: в нём может быть и использование вне Veyra.
Просмотр расходов
Откройте Costs:
- Сводка сравнивает расходы за месяц с бюджетом организации.
- Фильтры сужают выборку по агенту, проекту, модели и периоду; кнопка «поделиться» сохраняет отфильтрованное представление в виде ссылки.
- Daily charges показывает расходы по дням.
- Subscriptions перечисляет аккаунты с фиксированной оплатой. Можно изменить цену, которой вы управляете, связать два аккаунта, которые являются одним оплаченным местом, или перестать отслеживать аккаунт.
- Вкладки Decisions и Fast responses показывают стоимость этих сервисов.
Если стоимость запуска не удалось записать, сводка показывает его в разделе run costs unavailable. Retry cost recording повторно обрабатывает сохранённые данные об использовании, не запуская агента снова.
Бюджеты
Бюджеты задаются в долларах США (в API — в центах).
| Область | Период | Где задаётся |
|---|---|---|
| Организация | Календарный месяц (UTC) | Costs › Budgets или настройки организации. |
| Проект | Календарный месяц (UTC) | Поле проекта Budget. |
| Агент | Календарный месяц (UTC) | Вкладка агента Budgets. |
| Задача | Всё время существования задачи | Поле задачи Budget в Details или при создании. |
Нужно право Manage budgets (budgets:manage).
Что происходит на лимите
| Достигнуто | Результат |
|---|---|
| 80 % | Предупреждение. Агентам предлагается сосредоточиться на самом важном. |
| 100 % | Жёсткая остановка. Агент, проект или задача приостанавливается и не начинает новых запусков. |
Жёсткая остановка создаёт бюджетную карточку для Budget owner организации. В карточке Raise limit повышает бюджет и позволяет работе продолжиться, а Keep paused оставляет её остановленной. С началом нового месяца месячные остановки снимаются автоматически.
Лимиты накладываются друг на друга: работа должна укладываться в каждый применимый к ней бюджет. Повышение бюджета агента не поможет, если лимит исчерпан и у его проекта.
Через API
# Set an agent's monthly budget to $50
curl -X PATCH "https://intelligence-api.veyra.so/api/agents/$AGENT_ID" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"budgetMonthlyCents": 5000}'
# Spend summary for the organization
curl "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/costs/summary" \
-H "Authorization: Bearer $VEYRA_API_KEY"См. раздел Расходы и бюджеты в справочнике API.