Бюджеты и расходы

Смотрите стоимость каждого запуска, задавайте бюджеты для организации, проектов, агентов и отдельных задач и узнайте, что происходит на 80 и 100 %.

Veyra Docs TeamОбновлено 2 мин чтенияВерсия 2 · История

Каждый запуск сохраняет свою стоимость. Бюджеты ограничивают расходы до того, как они произойдут, а не после: когда лимит исчерпан, работа приостанавливается, пока человек не решит продолжить.

Откуда берутся расходы

Каждый запуск сообщает провайдера, модель, токены и стоимость. 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

curl
# 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.

БюджетыРасходыУправление