به عامل هوش مصنوعی خود یک دفتر کل بدهید
یک کار را به دفترهایی تبدیل کنید که میتوانید بررسی کنید. ابزار خط فرمان bea را در اختیار عامل هوش مصنوعی خود با دسترسی به شل قرار دهید تا تراکنشها را ثبت کند، کارش را بررسی کند و موجودیای را برگرداند که پشتوانهاش متن ساده است.
نصب bea
نصبکنندهی خود را انتخاب کنید، سپس نسخه را بررسی کنید. کتابهای محلی به حساب Beancount.io نیاز ندارند.
uv · پایتون 3.12+
uv tool install beancount-ioHomebrew · مک یا لینوکس
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 با پایتون 3.12 یا جدیدتر. حسابداری محلی به حساب Beancount.io نیاز ندارد — آن فقط برای مرحله میزبانی اختیاری زیر وارد میشود.
bea --versionمثال تأیید شده با bea 0.1.0: توزیع پایتون 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 دلار دارد.
خودتان اجرا کنید، دستور به دستور
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 عامل هوش مصنوعی من را راهاندازی میکند؟
خیر. نصب به شما دستور bea را میدهد؛ عامل شما دقیقاً همانطور که هست باقی میماند. شما کار بالا را در عامل سازگار با شل که از قبل استفاده میکنید قرار میدهید، و بارگذاری مهارتهای عامل نیز مرحله جداگانهای است.
آیا دفتر کل من از دستگاه من خارج میشود؟
دستورات محلی روی فایلهای محلی .bean کار میکنند و هیچ تماس شبکهای برقرار نمیکنند. فقط دستورات میزبانی شده — bea cloud و bea ask، که فراخوانیهای مدل آنها از طریق پروکسی هوش مصنوعی میزبانی شده اجرا میشوند — با خدمات Beancount.io صحبت میکنند.
اگر عامل من یک ورودی اشتباه بنویسد چه اتفاقی میافتد؟
در مسیر پیشفرض CLI محلی، هر افزودنی قبل از جایگزینی فایل، در برابر کل دفتر کل بررسی میشود. یک حساب ناشناخته یا یک تراکنش نامتوازن با راهنمایی شکست میخورد و فایل شما را دستنخورده باقی میگذارد — همچنین از عامل بخواهید بعد از هر ویرایش دستی bea check را اجرا کند.
bea ask دقیقاً به چه چیزهایی نیاز دارد؟
دو چیز فراتر از این صفحه: افزونه وابستگی ask و اعتبارنامه میزبانی برای ورود. نصب پیشفرض bea عمداً وابستگیهای هوش مصنوعی را تا زمانی که از آنها درخواست نکنید، حذف میکند.
ابزارهای میزبانیشده را در صورت نیاز وصل کنید
دستورهای CLI محلی بدون حساب Beancount.io کار میکنند. کمک هوش مصنوعی میزبانیشده و دسترسی MCP اتصالات جداگانه و اختیاری هستند.
bea ask به سوالات درباره یک دفتر کل محلی از طریق سرویس هوش مصنوعی میزبانی شده پاسخ میدهد. به افزونه ask نیاز دارد — uv tool install 'beancount-io[ask]' — به علاوه اعتبارنامه Beancount.io شما.
سرور MCP و دفاتر میزبانی شده نیز با حساب Beancount.io شما برای مجوز دسترسی وارد میشوند. محلی شروع کنید؛ فقط در صورت تمایل، میزبانی را متصل کنید.
مهارتهای عامل برای Beancount در مخزن محصول قرار دارند و به طور جداگانه در عامل شما بارگذاری میشوند — نصب CLI آنها را نصب یا پیکربندی نمیکند.
اتصال MCP را کاوش کنیدعامل شما میتواند حسابداری را انجام دهد. شما میتوانید کار را ببینید.
با یک دفتر محلی و یک نتیجه قابل تأیید شروع کنید.