Geben Sie Ihrem KI-Agenten ein Hauptbuch
Verwandeln Sie eine Aufgabe in Bücher, die Sie prüfen können. Geben Sie Ihrem shell-fähigen Agenten die bea-CLI, um Transaktionen zu erfassen, seine Arbeit zu überprüfen und einen Saldo zurückzugeben, der auf Klartext basiert.
bea installieren
Wählen Sie Ihren Installer und prüfen Sie dann die Version. Lokale Bücher benötigen kein Beancount.io-Konto.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS oder Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDKlartext. Gehört Ihnen.
Lokale .bean-Dateien, die Sie lesen, diffen und mit Git versionieren können.
Eine Prüfung vor jeder Änderung.
Standardmäßige CLI-Ergänzungen müssen validiert werden, bevor Ihr Hauptbuch ersetzt wird.
Bringen Sie den Agenten mit, den Sie nutzen.
Ein shell-fähiger Agent, eine Aufgabe und Befehle, die Sie prüfen können.
Was Sie benötigen
Ein Terminal, eine Netzwerkverbindung und entweder Homebrew oder uv mit Python 3.12 oder neuer. Für lokale Buchhaltung ist kein Beancount.io-Konto erforderlich – das kommt nur bei dem optionalen gehosteten Schritt unten ins Spiel.
bea --versionBeispiel verifiziert mit bea 0.1.0: Die Python-Distribution ist beancount-io und das ausführbare Programm, das sie installiert, ist bea.
Eine kleine Aufgabe. Echte Bücher.
Starten Sie mit 1,000 USD. Erfassen Sie einen Kaffee für 12.50 USD. Bitten Sie Ihren Agenten, das Hauptbuch zu prüfen und die Abfrage hinter seiner Antwort zu zeigen.
Agentenaufgaben-Prompt
Sie haben Shell-Zugriff und die `bea`-CLI installiert. Führen Sie zuerst `bea --help` aus und lesen Sie, was es bietet. Erstellen Sie dann in einem NEUEN leeren Demo-Verzeichnis (berühren Sie kein vorhandenes Hauptbuch): 1) ein USD-Hauptbuch, das Assets:Checking am 2026-08-01 mit 1000 eröffnet; 2) fügen Sie am 2026-08-02 einen Kauf für 12.50 USD mit dem Vermerk "Kaffee" zu Expenses:Dining hinzu; 3) führen Sie `bea check` aus; 4) melden Sie den Saldo von Assets:Checking zusammen mit der genauen BQL-Abfrage, die Sie verwendet haben. Erwartetes Ergebnis: 987.50 USD.- Ein neues Demo-Hauptbuch erstellen
- Den Kaffeekauf erfassen
- Die Bücher prüfen und den Saldo abfragen
Erwartetes Ergebnis: Assets:Checking enthält 987.50 USD.
Führen Sie es selbst aus, Befehl für Befehl
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"Stellen Sie Ihren Agenten auf die Probe.
Drei Banktransaktionen. Ein aufgezeichneter Agentenlauf. Laden Sie dieselben Eingaben herunter, reproduzieren Sie das Ergebnis und prüfen Sie, was unterwegs passiert ist.
Die aufgezeichnete Ausführung lesenSynthetische Daten, verifiziert mit bea 0.1.0. Ein beobachteter Lauf; der vollständige Datensatz enthält Fehler und Einschränkungen.
Die genauen Herausforderungseingaben
Ein Start-Hauptbuch, ein Kontoauszug und Kategorisierungsregeln.
Gehen Sie über die Demo hinaus.
Zwei kopierbare Rezepte bauen auf der obigen Demo auf: Importieren Sie eine Bank-CSV mit vom Agenten vorgeschlagenen Kategorien und beantworten Sie dann eine Saldenfrage aus der Abfrageausgabe. Jedes paart einen Agenten-Prompt mit CLI-Äquivalenten und erwarteten Ergebnissen.
Die Agentenrezepte lesenSie stehen vor der Wahl zwischen Tools? Beancount.io ist eines von fünf, die nach denselben Agenten-Workflow-Kriterien verglichen wurden, mit datierten Quellen.
Lesen Sie den Vergleich der fünf Tools.Ein paar Dinge, bevor Sie beginnen.
Ihre Bücher bleiben auf Ihrem Rechner
Jeder Befehl unten funktioniert mit Klartext-.bean-Dateien in einem von Ihnen gewählten Verzeichnis. Neue Hauptbuchdateien sind für Ihren Benutzer privat, und jede Ergänzung wird vor dem Ersetzen der Datei gegen das vollständige Hauptbuch validiert – auf dem standardmäßigen lokalen CLI-Pfad ist ein unbekanntes Konto oder eine unausgeglichene Transaktion ein Fehler mit Anleitung, und die Datei bleibt unberührt.
Benötige ich ein Beancount.io-Konto?
Nicht für irgendetwas auf dieser Seite. Das Installieren von bea, das Erstellen eines lokalen Hauptbuchs, das Erfassen von Käufen und das Prüfen von Salden funktionieren alle ohne Konto. Sie melden sich nur für die optionalen gehosteten Extras an: bea ask, den MCP-Server und gehostete Hauptbücher.
Richtet die Installation der CLI meinen KI-Agenten ein?
Nein. Die Installation gibt Ihnen den bea-Befehl; Ihr Agent bleibt genau so, wie er ist. Sie fügen die obige Aufgabe in den Shell-fähigen Agenten ein, den Sie bereits verwenden, und das Laden von Agentenfähigkeiten ist ein separater Schritt für sich.
Verlässt mein Hauptbuch meinen Rechner?
Lokale Befehle arbeiten mit lokalen .bean-Dateien und tätigen keine Netzwerkaufrufe. Nur die gehosteten Befehle – bea cloud und bea ask, deren Modellaufrufe über den gehosteten KI-Proxy laufen – kommunizieren mit Beancount.io-Diensten.
Was passiert, wenn mein Agent einen falschen Eintrag schreibt?
Auf dem standardmäßigen lokalen CLI-Pfad wird jede Ergänzung gegen das vollständige Hauptbuch geprüft, bevor die Datei ersetzt wird. Ein unbekanntes Konto oder eine unausgeglichene Transaktion schlägt mit Anleitung fehl und lässt Ihre Datei unberührt – lassen Sie den Agenten nach jeder manuellen Bearbeitung auch bea check ausführen.
Was genau benötigt bea ask?
Zwei Dinge über diese Seite hinaus: das ask-Abhängigkeits-Extra und gehostete Anmeldeinformationen zum Anmelden. Die Standardinstallation von bea lässt die KI-Abhängigkeiten absichtlich weg, bis Sie sie anfordern.
Verbinden Sie gehostete Tools, wenn Sie sie benötigen
Lokale CLI-Befehle funktionieren ohne Beancount.io-Konto. Gehostete KI-Hilfe und MCP-Zugriff sind separate, optionale Verbindungen.
bea ask beantwortet Fragen zu einem lokalen Hauptbuch über den gehosteten KI-Dienst. Es benötigt das ask-Extra – uv tool install 'beancount-io[ask]' – sowie Ihre Beancount.io-Anmeldeinformationen.
Der MCP-Server und gehostete Hauptbücher melden sich ebenfalls mit Ihrem Beancount.io-Konto an, um den Zugriff zu autorisieren. Beginnen Sie lokal; verbinden Sie Hosting nur, wenn Sie es möchten.
Agentenfähigkeiten für Beancount befinden sich im Produkt-Repository und werden separat in Ihren Agenten geladen – die Installation der CLI installiert oder konfiguriert sie nicht.
MCP-Verbindung erkundenIhr Agent kann die Buchhaltung übernehmen. Sie können die Arbeit sehen.
Starten Sie mit einem lokalen Hauptbuch und einem verifizierbaren Ergebnis.