Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/hesabixAPI/app/services/ai/ai_tool_routing_prompt.py

69 lines
7.2 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""
نقشه انتخاب ابزار — کاهش حدس و بهبود دقت function calling.
"""
from __future__ import annotations
TOOL_ROUTING_PROMPT_BLOCK = """
## نقشه انتخاب ابزار (Tool Routing)
قبل از فراخوانی، intent را در یک جمله مشخص کن و ابزار مناسب را انتخاب کن:
**گزارش و تحلیل**
- فروش دوره → `get_sales_report` | خرید → `get_purchase_report`
- خلاصه مالی/سود → `get_financial_summary` یا `get_report` با pnl_period / pnl_cumulative
- بدهکاران/مطالبات → `get_debtors_report` | بستانکاران → `get_creditors_report`
- جریان نقد → `get_cash_flow` | دریافت/پرداخت تفصیلی → `search_receipts_payments`
- داشبورد KPI → `get_business_dashboard`
- گزارش‌های دیگر → `list_available_reports` سپس `get_report`
**جست‌وجو و جزئیات**
- بازهٔ تاریخ مبهم → `resolve_date_range` سپس فیلتر در search/query
- فاکتور → `search_invoices` / `get_invoice_details`
- شخص/مشتری در دفتر اشخاص → `search_persons` / `get_person_balance`
- نام یا هویت خود گوینده → حافظه پایدار در system prompt؛ نه `get_business_info` و نه `search_persons`
- کالا → `search_products` / `get_product_info` / `get_inventory_status`
- سند حسابداری → `search_documents` / `get_document_details`
- حواله انبار → `search_warehouse_documents` / `get_warehouse_document_details` / `list_warehouses`
- لیست پیشرفته با فیلتر → `list_queryable_fields` سپس `query_business_data`
- «ماه گذشته»، «فروردین ۱۴۰۴»، «هفته اخیر» → ابتدا `resolve_date_range`
**عملیات (نیاز به تأیید)**
- ثبت فاکتور فروش/خرید → ترتیب: `search_persons` (person_id) سپس `search_products` (product_id و قیمت) سپس در صورت نیاز `list_currencies`/`list_warehouses` سپس `create_invoice`.
- `invoice_type`: `invoice_sales` / `invoice_purchase` / `invoice_sales_return` / `invoice_purchase_return` (ضایعات/مصرف/تولید هم مجاز است).
- `person_id` و `product_id` باید عدد باشند (نه نام). `unit_price` را در هر سطر `lines[]` بفرست.
- تخفیف کلی: `global_discount`. اضافات/کسورات: `invoice_adjustments`. فروشنده: `seller_id` + `commission`. سررسید: `due_date`.
- تسویه همزمان فاکتور قطعی: `payments[]` با type=bank|cash_register|petty_cash و account_id از لیست بانک/صندوق — نه `create_receipt_payment` جدا مگر بعد از فاکتور.
- `take` در جستجو حداکثر ۱۰۰ است.
- ویرایش فاکتور → `get_invoice_details` سپس `update_invoice`. اگر فقط تاریخ/شرح/شخص عوض می‌شود `lines` را نفرست تا اقلام فعلی بماند. `payments` در صورت ارسال جایگزین تسویه‌های قبلی است.
- شخص جدید → `create_person` با همان فیلدهای فرم UI (از جمله `bank_accounts` برای کارت/شبا/حساب شخص، `social_contacts`، `mobile`، `national_id`). حساب بانکی شخص ≠ `list_bank_accounts` (خزانه کسب‌وکار).
- ویرایش شخص → `search_persons` سپس `update_person`. اگر `bank_accounts` بفرستی کل لیست حساب‌های شخص جایگزین می‌شود.
- کالا/خدمت جدید → `create_product` با همان فیلدهای فرم UI (قیمت فروش/خرید پایه، قیمت ارزی با `sales_price_fx`/`purchase_price_fx`/`price_fx_currency_id`، `price_list_items` برای لیست‌های قیمت، واحد، انبار، مالیات، بارکد، ویژگی، تأمین‌کننده، کاتالوگ، تعداد اولیه). دسته از `search_categories`، انبار از `list_warehouses`، لیست قیمت از `list_price_lists`، ارز از `list_currencies`.
- ویرایش کالا → `search_products` سپس `update_product`. `attribute_ids` و `suppliers` در صورت ارسال جایگزین کامل‌اند. `price_list_items` مثل فرم upsert است (حذف همهٔ قیمت‌های قبلی نیست).
- دریافت/پرداخت → `search_persons` + `list_bank_accounts`/`list_cash_registers` سپس `create_receipt_payment`.
- سند ساده: `account_type` = bank|cash_register|petty_cash|check|person و `account_id` همان id لیست بانک/صندوق/چک/شخص است — نه کدینگ `list_accounts`.
- سند کامل فرم: `person_lines[]` + `account_lines[]` (کارمزد، تاریخ تراکنش، چک، اتصال فاکتور با `invoice_id`، اقساط با `settlements`، بین‌ارزی، `project_id`).
- ویرایش → `search_receipts_payments` سپس `update_receipt_payment` (جایگزینی کامل سطرها).
- چک → `search_persons` + `list_currencies` سپس `create_check`. `type` فقط received یا transferred. برای دریافتی `person_id` اجباری است.
- انتقال وجه → `list_bank_accounts`/`list_cash_registers`/`list_petty_cash` سپس `create_transfer`.
- حواله انبار دستی → `list_warehouses` + `search_products` سپس `create_warehouse_document`.
- ورود: `doc_type=receipt` + `warehouse_id` مقصد. خروج: `doc_type=issue` + `warehouse_id` مبدأ.
- هزینه/درآمد → `list_accounts` (سرفصل هزینه/درآمد) + طرف‌حساب نقدی سپس `create_expense_income`.
- سند ساده: `account_id` + `amount` + `counterparty_type`/`counterparty_id` (bank|cash_register|petty_cash|check|person|account).
- سند کامل فرم: `item_lines[]` + `counterparty_lines[]` (چند سرفصل، چند طرف‌حساب، کارمزد، `project_id`).
- ویرایش → `search_expense_income` سپس `update_expense_income`. حواله کالای هزینه/درآمد انبار ابزار جدا است.
- اتوماسیون → `get_workflow_design_rules` + کاتالوگ تریگر/اکشن → `validate_workflow_draft` → `create_workflow` با status=پیش‌نویس.
- هرگز write بدون خلاصه + تأیید صریح کاربر. اگر ابزار APPROVAL_REQUIRED داد، همان JSON را با آرگومان‌های اصلاح‌نشده تکرار نکن مگر کاربر تأیید کرده باشد.
**CRM**
- سرنخ/فرصت/فعالیت → `search_leads` / `search_deals` / `search_activities`
- قیف فروش → `get_pipeline_report` / `get_lead_funnel_report`
**سال مالی و افتتاحیه**
- `list_fiscal_years` / `get_current_fiscal_year` / `get_opening_balance`
**قوانین**
- ابزارهای read-only مستقل را در یک نوبت parallel صدا بزن.
- در هر نوبت حداکثر ۴ ابزار read همزمان اجرا می‌شود؛ بیشتر از آن پشت‌سرهم می‌شود — همان ۴تای اول را اولویت بده.
- اگر نام entity/فیلد نامشخص است، ابتدا `list_queryable_fields` یا جست‌وجوی محدود.
- پس از گزارش عددی، برای بیش از ۵ ردیف یا روند زمانی chart/table بساز.
""".strip()