Donnez un grand livre à votre agent IA
Transformez une tâche en livres que vous pouvez inspecter. Donnez à votre agent capable d'utiliser un shell la CLI bea pour enregistrer des transactions, vérifier son travail et renvoyer un solde adossé à du texte brut.
Installer bea
Choisissez votre installateur, puis vérifiez la version. Les livres locaux ne nécessitent pas de compte Beancount.io.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS ou Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDTexte brut. À vous.
Des fichiers .bean locaux que vous pouvez lire, diffuser et versionner avec Git.
Une vérification avant chaque modification.
Les ajouts par défaut de la CLI doivent être validés avant que votre grand livre soit remplacé.
Apportez l'agent que vous utilisez.
Un agent capable d'utiliser un shell, une tâche et des commandes que vous pouvez inspecter.
Ce dont vous avez besoin
Un terminal, une connexion réseau, et soit Homebrew, soit uv avec Python 3.12 ou plus récent. La tenue de livres locale ne nécessite aucun compte Beancount.io — celui-ci n'intervient que pour l'étape hébergée facultative ci-dessous.
bea --versionExemple vérifié avec bea 0.1.0 : la distribution Python est beancount-io et l'exécutable qu'elle installe est bea.
Une petite tâche. De vrais livres.
Commencez avec 1,000 USD. Enregistrez un café à 12.50 USD. Demandez à votre agent de vérifier le grand livre et d'afficher la requête derrière sa réponse.
Invite de tâche pour l'agent
Vous avez accès au shell et l'interface CLI `bea` est installée. Exécutez d'abord `bea --help` et lisez ce qu'elle propose. Ensuite, dans un NOUVEAU répertoire de démonstration vide (ne touchez à aucun grand livre existant) : 1) créez un grand livre en USD ouvrant Assets:Checking à 1000 le 2026-08-01 ; 2) ajoutez un achat de 12.50 USD narré "Café" à Expenses:Dining le 2026-08-02 ; 3) exécutez `bea check` ; 4) rapportez le solde de Assets:Checking avec la requête BQL exacte que vous avez utilisée. Résultat attendu : 987.50 USD.- Créer un nouveau grand livre de démonstration
- Enregistrer l'achat du café
- Vérifier les livres et interroger le solde
Résultat attendu : Assets:Checking contient 987.50 USD.
Exécutez-le vous-même, commande par commande
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"Mettez votre agent à l'épreuve.
Trois transactions bancaires. Un passage enregistré de l'agent. Téléchargez les mêmes entrées, reproduisez le résultat et inspectez ce qui s'est passé en cours de route.
Lire l'enregistrement de l'exécutionDonnées synthétiques, vérifiées avec bea 0.1.0. Un passage observé ; le journal complet inclut les échecs et les limitations.
Les entrées exactes du défi
Un grand livre de départ, un relevé bancaire et des règles de catégorisation.
Allez au-delà de la démo.
Deux recettes copiables s'appuient sur la démo ci-dessus : importez un CSV bancaire avec des catégories proposées par l'agent, puis répondez à une question de solde à partir de la sortie de requête. Chacune associe une invite d'agent aux équivalents CLI et aux résultats attendus.
Lire les recettes pour agentsVous hésitez entre plusieurs outils ? Beancount.io fait partie des cinq comparés selon les mêmes critères de flux de travail pour agents, avec des sources datées.
Lire la comparaison des cinq outilsQuelques points avant de commencer.
Vos livres restent sur votre machine
Chaque commande ci-dessous fonctionne sur des fichiers texte .bean dans un répertoire de votre choix. Les nouveaux fichiers de grand livre sont privés à votre utilisateur, et chaque ajout est validé par rapport au grand livre complet avant que le fichier ne soit remplacé — sur le chemin CLI local par défaut, un compte inconnu ou une transaction non équilibrée est une erreur avec des conseils, et le fichier est laissé intact.
Ai-je besoin d'un compte Beancount.io ?
Non pour tout ce qui figure sur cette page. Installer bea, créer un grand livre local, enregistrer des achats et vérifier les soldes fonctionnent sans compte. Vous ne vous connectez que pour les extras hébergés facultatifs : bea ask, le serveur MCP et les grands livres hébergés.
L'installation de la CLI configure-t-elle mon agent IA ?
Non. L'installation vous donne la commande bea ; votre agent reste exactement tel qu'il est. Vous collez la tâche ci-dessus dans l'agent compatible shell que vous utilisez déjà, et charger les compétences d'agent est une étape distincte en soi.
Mon grand livre quitte-t-il ma machine ?
Les commandes locales fonctionnent sur des fichiers .bean locaux et n'effectuent aucun appel réseau. Seules les commandes hébergées — bea cloud et bea ask, dont les appels de modèle passent par le proxy IA hébergé — communiquent avec les services Beancount.io.
Que se passe-t-il si mon agent écrit une entrée invalide ?
Sur le chemin CLI local par défaut, chaque ajout est vérifié par rapport au grand livre complet avant que le fichier ne soit remplacé. Un compte inconnu ou une transaction non équilibrée échoue avec des conseils et laisse votre fichier intact — demandez également à l'agent d'exécuter bea check après toute modification manuelle.
De quoi exactement bea ask a-t-il besoin ?
Deux choses en plus de cette page : l'extension de dépendance ask et des identifiants hébergés pour vous connecter. L'installation par défaut de bea omet intentionnellement les dépendances IA jusqu'à ce que vous les demandiez.
Connectez des outils hébergés quand vous en avez besoin
Les commandes CLI locales fonctionnent sans compte Beancount.io. L'aide IA hébergée et l'accès MCP sont des connexions distinctes et optionnelles.
bea ask répond à des questions sur un grand livre local via le service IA hébergé. Il nécessite l'extension ask — uv tool install 'beancount-io[ask]' — plus vos identifiants Beancount.io.
Le serveur MCP et les grands livres hébergés se connectent également avec votre compte Beancount.io pour autoriser l'accès. Commencez en local ; connectez l'hébergement uniquement si vous le souhaitez.
Les compétences d'agent pour Beancount vivent dans le dépôt du produit et se chargent dans votre agent séparément — l'installation de la CLI ne les installe ni ne les configure.
Explorez la connexion MCPVotre agent peut faire la comptabilité. Vous pouvez voir le travail.
Commencez avec un grand livre local et un résultat vérifiable.