floe-guard — скилл
Счетчик и предохранитель расхода на ИИ-вызовы для Python и TypeScript: считает по вендорам и стопорит цикл на лимите.
- 289 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Команда `floe-guard push` по желанию отправляет оцененные события расхода в хостинговый Floe.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/floe-guardОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Команда `floe-guard push` по желанию отправляет оцененные события расхода в хостинговый Floe.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
floe-guard считает стоимость каждого вызова агента в момент его завершения: модель, распознавание и синтез речи, телефония, платные инструменты. Журнал расходов живет в процессе, без аккаунта и без телеметрии по умолчанию. Перед вызовом `guard.check()` сверяется с потолком в долларах и бросает `BudgetExceeded`, если следующий вызов его пробьет. После вызова `guard.record()` начисляет токены. Адаптеры есть для OpenAI, Anthropic, Gemini, CrewAI, LiteLLM, LangChain, LangGraph и голосовых Pipecat, LiveKit, Vapi, Retell. В репозитории лежат `SKILL.md` и `AGENTS.md`, по которым кодовый агент сам подключает защиту.
Для кого. Разработчики агентов и голосовых ботов, которым нужен жесткий потолок расходов и видимая стоимость каждого вызова.
Подходит, если
- Агент крутится в цикле, и его надо остановить раньше, чем вырастет счет.
- Голосовой бот на Pipecat, LiveKit, Vapi или Retell: стоимость звонка считают по этапам.
- Платные инструменты агента ставят под общий потолок через `reserve_tool()` и `settle_tool()`.
- Кодовому агенту поручают подключить защиту по `SKILL.md` без ручной правки.
Не подходит, если
- Нужен баланс или реальное списание: библиотека держит бюджет, но денег не хранит.
- Точная цена по договорным ставкам нужна без `rate card`: из коробки действуют публичные тарифы.
- Привязка расходов к клиентам и кампаниям нужна локально: она есть только в хостинговой версии Floe.
Пример запроса к агенту
Подключи floe-guard с потолком 5 долларов к вызовам OpenAI в этом проекте и покажи, что при превышении бросается `BudgetExceeded`.Ограничения
Встроенная карта держит публичные цены вендоров, поэтому ставка считается неподтвержденной, пока вы не задали собственный `rate card`. `record_tool()` учитывает расход уже после вызова и остановить его не может; заранее блокируют `reserve_tool()` и `settle_tool()`. Coverage Score и история за 7 дней требуют бесплатного ключа. `floe-guard push` отправляет только оцененные события расхода, без промптов.
Как отключить. Уберите `check()` и `record()` из кода и удалите пакет `floe-guard` через pip или npm. Журнал, выгруженный через `export_log()`, удаляйте отдельно.
Частые вопросы
Нужен ли аккаунт?
Нет. Журнал ведется в процессе без аккаунта и без телеметрии по умолчанию. Бесплатный ключ нужен только для Coverage Score и истории за 7 дней.
Чем `check()` отличается от `max_tokens`?
`max_tokens` и `max_rpm` ограничивают размер и частоту, а не доллары, поэтому дешевая модель в цикле все равно тратит бюджет. `check()` останавливает вызов по сумме.
Как задать собственные тарифы?
Создайте `rate card` со своими ставками. Он приоритетнее встроенной карты: порядок такой — переопределение вызова, ваш `rate card`, публичные цены, ошибка `UnpriceableLegError`.
Что уходит наружу при `floe-guard push`?
Только оцененные события расхода из JSONL-файла, выгруженного через `guard.export_log()`. Промпты и содержимое остаются в процессе.
Есть ли версия для TypeScript?
Да, `npm i floe-guard`: промежуточный слой для Vercel AI SDK и адаптеры LiveKit, Vapi, Retell. Набор адаптеров Python шире.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыЛокальный бинарник считает затраты на Claude Code, Codex и Cursor по токенам провайдера и ставит защитные правила агентам.
Скилл встраивает в Python-агента лимит расходов на весь прогон: проверка перед каждым вызовом модели останавливает лишние траты.
Скилл и хуки, которые удерживают кодового агента в рамках задачи и убирают лишнюю защиту, ненужные контрольные суммы и расползание объема
Локальная панель учета работы ИИ-агентов: токены, оценка стоимости, шаги, измененные файлы и проверки по задачам Claude Code, Codex, OpenCode
Плагин от Microsoft Research и UC Berkeley снижает стоимость сессий Claude Code, Codex и Copilot CLI по опыту прошлых сессий
Локальный прокси между агентом и API модели: сжимает диффы и логи, сохраняет префикс запроса стабильным для кеша промптов.
Коротко о README
Защита работает в процессе: сумма проверяется до вызова и начисляется после него. Для платных инструментов бронь суммы блокирует вызов заранее, а запись постфактум только учитывает расход.