Дайте вашему ИИ-агенту бухгалтерскую книгу
Превратите задачу в книги, которые можно проверить. Дайте вашему агенту, умеющему работать с командной строкой, CLI bea для записи транзакций, проверки работы и получения баланса, подкреплённого обычным текстом.
Установка bea
Выберите установщик, затем проверьте версию. Локальным книгам не нужна учётная запись Beancount.io.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS или Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDОбычный текст. Он остаётся у вас.
Локальные .bean-файлы, которые можно читать, сравнивать и версионировать с помощью Git.
Проверка перед каждым изменением.
Стандартные дополнения CLI должны быть проверены, прежде чем ваша учётная книга будет заменена.
Возьмите того агента, которого используете.
Агент, умеющий работать с командной строкой, одна задача и команды, которые можно проверить.
Что вам нужно
Терминал, сетевое соединение и либо Homebrew, либо uv с Python 3.12 или новее. Для локального ведения книг учетная запись Beancount.io не нужна — она понадобится только для необязательного шага с хостингом ниже.
bea --versionПример проверен с bea 0.1.0: дистрибутив Python — beancount-io, а исполняемый файл, который он устанавливает, — bea.
Одна небольшая задача. Настоящие книги.
Начните с 1,000 USD. Запишите кофе за 12.50 USD. Попросите агента проверить учётную книгу и показать запрос, лежащий в основе его ответа.
Промпт задачи агента
У вас есть доступ к shell и установлен CLI `bea`. Сначала запустите `bea --help` и прочитайте, что он предлагает. Затем в НОВОЙ пустой демонстрационной директории (не трогайте существующие книги): 1) создайте книгу в USD, открыв Assets:Checking на 1000 2026-08-01; 2) добавьте покупку на 12.50 USD с описанием "Coffee" в Expenses:Dining 2026-08-02; 3) запустите `bea check`; 4) сообщите баланс Assets:Checking вместе с точным BQL-запросом, который вы использовали. Ожидаемый результат: 987.50 USD.- Создайте новую демонстрационную учётную книгу
- Запишите покупку кофе
- Проверьте книги и запросите баланс
Ожидаемый результат: Assets:Checking содержит 987.50 USD.
Выполните сами, команда за командой
bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
cd demo-books
bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
bea check
bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"Проверьте своего агента на прочность.
Три банковские транзакции. Одна записанная сессия агента. Скачайте те же исходные данные, воспроизведите результат и посмотрите, что произошло по ходу дела.
Читать записанный запускСинтетические данные, проверенные с помощью bea 0.1.0. Один наблюдённый запуск; полная запись включает сбои и ограничения.
Точные входные данные вызова
Стартовая учётная книга, банковская выписка и правила категоризации.
Идите дальше демо.
Два копируемых рецепта основаны на демо выше: импортируйте банковский CSV с предложенными агентом категориями, затем ответьте на вопрос о балансе по выводу запроса. Каждый сочетает промпт агента с эквивалентами CLI и ожидаемыми результатами.
Читать рецепты для агентовВыбираете между инструментами? Beancount.io — один из пяти, сравнённых по одним и тем же критериям агентских рабочих процессов, с указанием дат источников.
Прочитать сравнение пяти инструментовНесколько вещей перед началом.
Ваши книги остаются на вашей машине
Каждая команда ниже работает с текстовыми файлами .bean в выбранном вами каталоге. Новые файлы книг являются приватными для вашего пользователя, и каждое добавление проверяется на соответствие полной книге перед заменой файла — на стандартном локальном пути CLI неизвестный счет или несбалансированная транзакция являются ошибкой с пояснением, и файл остается нетронутым.
Нужна ли мне учетная запись Beancount.io?
Нет, для всего на этой странице. Установка bea, создание локальной книги, запись покупок и проверка балансов работают без учетной записи. Вы входите только для необязательных hosted дополнений: bea ask, MCP-сервера и hosted книг.
Настраивает ли установка CLI моего ИИ-агента?
Нет. Установка дает вам команду bea; ваш агент остается как есть. Вы вставляете задачу выше в агента с поддержкой shell, которым уже пользуетесь, а загрузка навыков агента — отдельный шаг.
Покидает ли моя книга мою машину?
Локальные команды работают с локальными файлами .bean и не совершают сетевых вызовов. Только hosted команды — bea cloud и bea ask, чьи вызовы моделей проходят через hosted AI прокси, — общаются с сервисами Beancount.io.
Что произойдет, если мой агент запишет плохую запись?
На стандартном локальном пути CLI каждое добавление проверяется на соответствие полной книге перед заменой файла. Неизвестный счет или несбалансированная транзакция завершаются ошибкой с пояснением и оставляют ваш файл нетронутым — также попросите агента запустить bea check после любой ручной правки.
Что именно нужно для bea ask?
Две вещи помимо этой страницы: дополнительный пакет ask и hosted учетные данные для входа. Стандартная установка bea намеренно опускает зависимости ИИ, пока вы их не запросите.
Подключайте облачные инструменты, когда они нужны
Локальные команды CLI работают без учётной записи Beancount.io. Облачная ИИ-помощь и доступ MCP — это отдельные, необязательные подключения.
bea ask отвечает на вопросы о локальной книге через hosted AI сервис. Для этого нужен дополнительный пакет ask — uv tool install 'beancount-io[ask]' — плюс ваши учетные данные Beancount.io.
MCP-сервер и hosted книги также входят в систему с вашей учетной записью Beancount.io для авторизации доступа. Начните с локального; подключайте хостинг только если хотите.
Навыки агента для Beancount находятся в репозитории продукта и загружаются в вашего агента отдельно — установка CLI не устанавливает и не настраивает их.
Изучите подключение MCPВаш агент может вести бухгалтерию. Вы видите результат работы.
Начните с локальной учётной книги и одного проверяемого результата.