Надайте вашому AI-агенту бухгалтерську книгу
Перетворіть задачу на книги, які можна перевірити. Дайте своєму агенту з доступом до shell 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-команди за замовчуванням мають пройти валідацію, перш ніж ваша книга буде замінена.
Приведіть агента, якого ви використовуєте.
Агент з доступом до shell, одне завдання та команди, які ви можете перевірити.
Що вам потрібно
Термінал, мережеве з'єднання та 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, створення локальної книги, запис покупок і перевірка балансів працюють без облікового запису. Ви входите лише для необов'язкових хостингових функцій: bea ask, MCP-сервер і хостингові книги.
Чи налаштовує встановлення CLI мого AI-агента?
Ні. Встановлення дає вам команду bea; ваш агент залишається як є. Ви вставляєте завдання вище у вашого агента з підтримкою shell, а завантаження навичок агента — окремий крок.
Чи залишає моя книга мою машину?
Локальні команди працюють з локальними файлами .bean і не роблять мережевих викликів. Лише хостингові команди — bea cloud і bea ask, чиї виклики моделей проходять через хостинговий AI-проксі — спілкуються з сервісами Beancount.io.
Що станеться, якщо мій агент запише поганий запис?
На типовому локальному шляху CLI кожне додавання перевіряється на відповідність повній книзі перед заміною файлу. Невідомий рахунок або незбалансована транзакція завершується помилкою з підказками та залишає ваш файл недоторканим — також попросіть агента запустити bea check після будь-якого ручного редагування.
Що саме потрібно для bea ask?
Дві речі, окрім цієї сторінки: додатковий пакет залежностей ask і хостингові облікові дані для входу. Типове встановлення bea навмисно пропускає AI-залежності, поки ви їх не попросите.
Підключіть хостинговані інструменти, коли вони вам потрібні
Локальні CLI-команди працюють без акаунта Beancount.io. Хостингована AI-допомога та MCP-доступ є окремими, опціональними з'єднаннями.
bea ask відповідає на питання про локальну книгу через хостинговий AI-сервіс. Для цього потрібен додатковий пакет ask — uv tool install 'beancount-io[ask]' — плюс ваші облікові дані Beancount.io.
MCP-сервер і хостингові книги також входять за допомогою вашого облікового запису Beancount.io для авторизації доступу. Почніть локально; підключайте хостинг лише якщо хочете.
Навички агента для Beancount знаходяться в репозиторії продукту та завантажуються у вашого агента окремо — встановлення CLI не встановлює та не налаштовує їх.
Дослідіть MCP-з'єднанняВаш агент може вести бухгалтерію. Ви можете бачити роботу.
Почніть із локальною книгою та одним перевірюваним результатом.