Дайте на вашия AI агент сметководна книга
Превърнете задача в счетоводни книги, които можете да проверите. Дайте на вашия агент, работещ в shell, CLI инструмента bea, за да записва транзакции, да проверява работата си и да връща баланс, подкрепен от plain text.
Инсталирайте 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 USDPlain text. Ваш, за да го пазите.
Локални .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. Помолете агента си да провери счетоводната книга и да покаже заявката зад отговора си.
Задача за агента
You have shell access and the `bea` CLI installed. First run `bea --help` and read what it offers. Then, in a NEW empty demo directory (do not touch any existing ledger): 1) create a USD ledger opening Assets:Checking at 1000 on 2026-08-01; 2) add a 12.50 USD purchase narrated "Coffee" to Expenses:Dining on 2026-08-02; 3) run `bea check`; 4) report the Assets:Checking balance together with the exact BQL query you used. Expected result: 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 с предложени от агента категории, след което отговорете на въпрос за баланса от резултатите от заявката. Всяка съчетава подкана за агент с еквиваленти на командния ред и очаквани резултати.
Прочетете рецептите за агентиИзбирате между инструменти? Beancount.io е един от петте сравнени по едни и същи критерии за агентски работни потоци, с датирани източници.
Прочетете сравнението на петте инструментаНяколко неща, преди да започнете.
Вашите книги остават на вашата машина
Всяка команда по-долу работи с обикновени текстови .bean файлове в директория по ваш избор. Новите счетоводни файлове са частни за вашия потребител и всяко допълнение се валидира спрямо пълната книга преди файлът да бъде заменен — по подразбиране на локалния CLI път, неизвестна сметка или небалансирана транзакция е грешка с насоки, а файлът остава непокътнат.
Нужен ли ми е акаунт в Beancount.io?
Не за нищо на тази страница. Инсталирането на bea, създаването на локална книга, записването на покупки и проверката на салда работят без акаунт. Влизате само за незадължителните хостинг добавки: bea ask, MCP сървъра и хостинг книгите.
Инсталирането на CLI конфигурира ли моя AI агент?
Не. Инсталирането ви дава командата bea; вашият агент остава точно както е. Вие поставяте задачата по-горе в агента с шел достъп, който вече използвате, а зареждането на умения за агенти е отделна стъпка.
Напуска ли книгата ми моята машина?
Локалните команди работят с локални .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 връзкатаВашият агент може да води счетоводството. Вие можете да видите работата.
Започнете с локална счетоводна книга и един проверим резултат.