forked from hesabix/arc
268 lines
18 KiB
Markdown
268 lines
18 KiB
Markdown
# Tool Metadata Audit (Phase 4)
|
||
|
||
**تاریخ:** ۱۹ اوت ۲۰۲۶
|
||
**منبع:** parse سورس `AIFunction` + Tool Manifest
|
||
**تعداد:** ۱۸۰
|
||
|
||
> Phase 4 improves the quality and trustworthiness of the catalog; it does not improve retrieval yet.
|
||
|
||
## Completeness
|
||
|
||
```
|
||
total: 180
|
||
complete_metadata: 153
|
||
missing_permissions: 0
|
||
missing_side_effect: 0
|
||
missing_domain: 0
|
||
missing_capability: 0
|
||
missing_description: 0
|
||
missing_aliases: 107
|
||
missing_examples: 150
|
||
missing_search_text: 0
|
||
average_quality_score: 78.7
|
||
```
|
||
|
||
Aliases و Examples برای همهٔ ۱۸۰ اجباری نیستند. اجباری: domain, capability, side_effect, search_text, permission (یا سیاست صریح).
|
||
|
||
Description کوتاهِ قبلی بیشتر false-negative پارسر بود (`CREATE_INVOICE_DESCRIPTION` و مشابه). پارسر حالا ثابت‌های `*_DESCRIPTION` را resolve می‌کند. چهار توضیح واقعاً کوتاه (`delete_check`, `delete_workflow`, `get_bom_details`, `get_check_details`) بازنویسی هدفمند شدند.
|
||
|
||
Quality < 70 (عمدتاً بدون alias/example دم‌بلند، نه بدون permission):
|
||
|
||
`delete_expense_income, delete_product_attribute, delete_receipt_payment, delete_transfer, get_business_credit_settings, get_document_details, get_opening_balance, get_person_credit, get_product_attribute, get_project_summary, get_repair_order_details, get_warehouse_document_details, list_announcements, list_boms, list_cash_registers, list_credit_installment_plans, list_customer_club_tiers, list_fiscal_years, list_petty_cash, search_activity_logs, search_customer_club_rfm_persons, search_expense_income, search_projects, search_transfers, search_warranty_codes, update_product_attribute, validate_workflow_draft`
|
||
|
||
## Permission policies (۲۲ مورد خالی قبلی)
|
||
|
||
| Tool | Policy / Permission | دلیل |
|
||
|------|---------------------|------|
|
||
| query_business_data | handler | Permission per entity در handler |
|
||
| batch_query_business_data | handler | همان fan-in |
|
||
| list_queryable_fields | handler | کاتالوگ فیلد همان entityها |
|
||
| read_memory | self_scoped | حافظهٔ خود کاربر |
|
||
| upsert_memory_entry | self_scoped | mutation حافظهٔ خود کاربر |
|
||
| delete_memory_entry | self_scoped | حذف حافظهٔ خود کاربر |
|
||
| create_session_plan | agent_internal | state گفت‌وگو |
|
||
| list_session_todos | agent_internal | state گفت‌وگو |
|
||
| update_session_todo | agent_internal | state گفت‌وگو |
|
||
| spawn_subagent | agent_internal | orchestration |
|
||
| await_subagent | agent_internal | orchestration |
|
||
| cancel_subagent | agent_internal | orchestration |
|
||
| resolve_date_range | user_context | تبدیل تقویم، دادهٔ کسب‌وکار نیست |
|
||
| list_my_businesses | user_context | عضویت کاربر |
|
||
| list_announcements | user_context | اعلان سامانه برای کاربر |
|
||
| list_user_notifications | user_context | نوتیف کاربر |
|
||
| get_business_info | user_context | پروفایل کسب‌وکار نشست |
|
||
| get_wallet_overview | wallet.view | دادهٔ مالی پلتفرم |
|
||
| list_wallet_transactions | wallet.view | دادهٔ مالی پلتفرم |
|
||
| get_wallet_metrics | wallet.view | دادهٔ مالی پلتفرم |
|
||
| list_frequent_descriptions | invoices.read | شرح اسناد/فاکتور |
|
||
| invoke_business_connector | settings.view | HTTP خارجی / execute |
|
||
|
||
## Side effects
|
||
|
||
```
|
||
{'write': 28, 'none': 138, 'delete': 10, 'execute': 3, 'export': 1}
|
||
```
|
||
|
||
- `upsert_memory_entry`: write (دیگر none نیست)
|
||
- `test_workflow`: execute (اجرای sandbox؛ خطرناک‌تر از read)
|
||
- `invoke_business_connector`: execute (prefix invoke_)
|
||
- `export_business_data`: export
|
||
|
||
## Short descriptions
|
||
|
||
پس از resolve ثابت‌ها و بازنویسی چهار مورد ضعیف: **missing_description = 0** (آستانه ۱۶ کاراکتر). Descriptionها کورکورانه بازنویسی نشدند.
|
||
|
||
## Collisions (عمدی fan-in)
|
||
|
||
| خانواده | Toolها | تمایز |
|
||
|----------|--------|--------|
|
||
| فاکتور | search_invoices, get_invoice_details, query_business_data(entity=invoice), get_report | اختصاصی فاکتور در برابر fan-in |
|
||
| گزارش فروش | get_sales_report, get_report(report_type=…) | capability reports.sales در برابر reports.overview |
|
||
| شخص | search_persons, get_customer_info, query_business_data(entity=person) | لیست در برابر کارت مشتری |
|
||
|
||
## Machine-readable rows
|
||
|
||
هر ردیف: name, capability, namespace, side_effect, permission_status, policy, score, aliases_count, examples_count
|
||
|
||
```
|
||
adjust_customer_club_points customer_club.loyalty customer_club write assigned required 75 0 0
|
||
await_subagent agent.subagent agent none explicit_empty agent_internal 75 0 0
|
||
batch_query_business_data query.entity query none explicit_empty handler 75 0 0
|
||
cancel_subagent agent.subagent agent none explicit_empty agent_internal 75 0 0
|
||
create_account financial.account financial write assigned required 75 0 0
|
||
create_check financial.check financial write assigned required 85 3 0
|
||
create_expense_income financial.expense financial write assigned required 85 6 0
|
||
create_invoice financial.invoice financial write assigned required 95 3 2
|
||
create_lead crm.lead crm write assigned required 75 0 0
|
||
create_person people.person people write assigned required 95 3 1
|
||
create_product inventory.product inventory write assigned required 95 6 1
|
||
create_product_attribute inventory.product inventory write assigned required 75 0 0
|
||
create_receipt_payment financial.payment financial write assigned required 85 6 0
|
||
create_session_plan agent.plan agent none explicit_empty agent_internal 75 0 0
|
||
create_transfer financial.transfer financial write assigned required 85 2 0
|
||
create_warehouse_document inventory.warehouse inventory write assigned required 85 4 0
|
||
create_workflow automation.workflow automation write assigned required 95 3 1
|
||
delete_account financial.account financial delete assigned required 75 0 0
|
||
delete_check financial.check financial delete assigned required 75 0 0
|
||
delete_expense_income financial.expense financial delete assigned required 65 0 0
|
||
delete_invoice financial.invoice financial delete assigned required 95 2 1
|
||
delete_memory_entry agent.memory agent delete explicit_empty self_scoped 95 2 1
|
||
delete_person people.person people delete assigned required 95 2 1
|
||
delete_product_attribute inventory.product inventory delete assigned required 65 0 0
|
||
delete_receipt_payment financial.payment financial delete assigned required 65 0 0
|
||
delete_transfer financial.transfer financial delete assigned required 65 0 0
|
||
delete_workflow automation.workflow automation delete assigned required 75 0 0
|
||
execute_workflow automation.workflow automation execute assigned required 95 2 1
|
||
export_business_data reports.export reports export assigned required 95 3 1
|
||
get_account financial.account financial none assigned required 85 2 0
|
||
get_basalam_overview integration.basalam integration none assigned required 95 3 1
|
||
get_bom_details inventory.bom inventory none assigned required 75 0 0
|
||
get_business_credit_settings financial.credit financial none assigned required 65 0 0
|
||
get_business_dashboard reports.overview reports none assigned required 75 0 0
|
||
get_business_info platform.settings platform none explicit_empty user_context 75 0 0
|
||
get_cash_flow reports.cashflow reports none assigned required 85 3 0
|
||
get_check_details financial.check financial none assigned required 75 0 0
|
||
get_creditors_report reports.payables reports none assigned required 95 4 1
|
||
get_crm_summary crm.summary crm none assigned required 85 2 0
|
||
get_current_fiscal_year financial.fiscal financial none assigned required 75 2 0
|
||
get_customer_club_rfm_summary customer_club.loyalty customer_club none assigned required 75 2 0
|
||
get_customer_club_settings customer_club.loyalty customer_club none assigned required 85 3 0
|
||
get_customer_info people.person people none assigned required 75 0 0
|
||
get_deal_details crm.deal crm none assigned required 75 0 0
|
||
get_debtors_report reports.receivables reports none assigned required 95 4 1
|
||
get_document_details financial.document financial none assigned required 65 0 0
|
||
get_document_numbering_settings platform.settings platform none assigned required 75 0 0
|
||
get_financial_summary reports.financial reports none assigned required 85 2 0
|
||
get_inventory_status inventory.stock inventory none assigned required 95 4 1
|
||
get_inventory_valuation reports.inventory reports none assigned required 85 2 0
|
||
get_invoice_details financial.invoice financial none assigned required 95 3 2
|
||
get_invoices_count financial.invoice financial none assigned required 85 2 0
|
||
get_lead_details crm.lead crm none assigned required 75 0 0
|
||
get_lead_funnel_report reports.crm reports none assigned required 75 0 0
|
||
get_loan_facility financial.loan financial none assigned required 75 0 0
|
||
get_opening_balance financial.account financial none assigned required 65 0 0
|
||
get_person_balance people.person people none assigned required 75 0 0
|
||
get_person_credit financial.credit financial none assigned required 65 0 0
|
||
get_person_transactions financial.payment financial none assigned required 75 0 0
|
||
get_pipeline_report reports.crm reports none assigned required 75 0 0
|
||
get_product_attribute inventory.product inventory none assigned required 65 0 0
|
||
get_product_info inventory.product inventory none assigned required 85 2 0
|
||
get_product_kardex inventory.stock inventory none assigned required 95 3 1
|
||
get_project_summary misc.general misc none assigned required 65 0 0
|
||
get_purchase_report reports.purchases reports none assigned required 95 3 1
|
||
get_quick_sales_settings platform.settings platform none assigned required 75 0 0
|
||
get_repair_order_details misc.general misc none assigned required 65 0 0
|
||
get_report reports.overview reports none assigned required 95 3 2
|
||
get_report_template reports.templates reports none assigned required 75 0 0
|
||
get_report_template_scope_catalog reports.templates reports none assigned required 75 0 0
|
||
get_sales_report reports.sales reports none assigned required 100 5 2
|
||
get_tax_data_quality tax.moadian tax none assigned required 75 0 0
|
||
get_tax_settings tax.moadian tax none assigned required 85 3 0
|
||
get_wallet_metrics financial.wallet financial none assigned required 75 0 0
|
||
get_wallet_overview financial.wallet financial none assigned required 95 3 1
|
||
get_warehouse_document_details inventory.warehouse inventory none assigned required 65 0 0
|
||
get_warehouse_report reports.inventory reports none assigned required 75 0 0
|
||
get_warehouse_stock_summary inventory.stock inventory none assigned required 75 2 0
|
||
get_workflow automation.workflow automation none assigned required 75 0 0
|
||
get_workflow_component_schema automation.workflow automation none assigned required 75 0 0
|
||
get_workflow_design_rules automation.workflow automation none assigned required 75 0 0
|
||
get_workflow_execution_debug automation.workflow automation none assigned required 75 0 0
|
||
hscript_fix_script platform.hscript platform none assigned required 75 0 0
|
||
hscript_language_guide platform.hscript platform none assigned required 85 2 0
|
||
hscript_read_doc platform.hscript platform none assigned required 75 0 0
|
||
hscript_retrieve_docs platform.hscript platform none assigned required 75 0 0
|
||
hscript_run_preview platform.hscript platform none assigned required 75 0 0
|
||
hscript_search_docs platform.hscript platform none assigned required 85 3 0
|
||
hscript_validate_script platform.hscript platform none assigned required 75 0 0
|
||
invoke_business_connector integration.connector integration execute assigned required 95 2 1
|
||
list_accounts financial.account financial none assigned required 95 3 1
|
||
list_announcements platform.notifications platform none explicit_empty user_context 65 0 0
|
||
list_available_reports reports.overview reports none assigned required 85 2 0
|
||
list_bank_accounts financial.account financial none assigned required 75 0 0
|
||
list_basalam_dead_letter integration.basalam integration none assigned required 85 3 0
|
||
list_basalam_product_conflicts integration.basalam integration none assigned required 75 2 0
|
||
list_basalam_synced_invoices integration.basalam integration none assigned required 75 2 0
|
||
list_boms inventory.bom inventory none assigned required 65 0 0
|
||
list_business_notification_logs platform.notifications platform none assigned required 75 0 0
|
||
list_business_notification_templates platform.notifications platform none assigned required 75 0 0
|
||
list_business_plugins platform.marketplace platform none assigned required 85 2 0
|
||
list_business_users platform.settings platform none assigned required 75 0 0
|
||
list_cash_registers financial.account financial none assigned required 65 0 0
|
||
list_credit_installment_plans financial.credit financial none assigned required 65 0 0
|
||
list_currencies financial.currency financial none assigned required 85 3 0
|
||
list_currency_rates financial.currency financial none assigned required 75 0 0
|
||
list_customer_club_ledger customer_club.loyalty customer_club none assigned required 75 2 0
|
||
list_customer_club_tiers customer_club.loyalty customer_club none assigned required 65 0 0
|
||
list_distribution_routes misc.general misc none assigned required 75 0 0
|
||
list_fiscal_years financial.fiscal financial none assigned required 65 0 0
|
||
list_frequent_descriptions financial.document financial none assigned required 75 0 0
|
||
list_loan_facilities financial.loan financial none assigned required 75 0 0
|
||
list_marketplace_plugins platform.marketplace platform none assigned required 85 2 0
|
||
list_my_businesses platform.settings platform none explicit_empty user_context 75 0 0
|
||
list_payment_gateways financial.payment financial none assigned required 85 2 0
|
||
list_person_groups people.person people none assigned required 75 0 0
|
||
list_petty_cash financial.account financial none assigned required 65 0 0
|
||
list_price_list_items inventory.product inventory none assigned required 85 2 0
|
||
list_price_lists inventory.product inventory none assigned required 85 3 0
|
||
list_product_attributes inventory.product inventory none assigned required 75 0 0
|
||
list_queryable_fields query.meta query none explicit_empty handler 75 0 0
|
||
list_report_templates reports.templates reports none assigned required 85 3 0
|
||
list_session_todos agent.plan agent none explicit_empty agent_internal 75 0 0
|
||
list_user_notifications platform.notifications platform none explicit_empty user_context 75 0 0
|
||
list_wallet_transactions financial.wallet financial none assigned required 75 2 0
|
||
list_warehouse_locations inventory.warehouse inventory none assigned required 75 0 0
|
||
list_warehouse_placements inventory.warehouse inventory none assigned required 75 0 0
|
||
list_warehouses inventory.warehouse inventory none assigned required 75 2 0
|
||
list_woocommerce_orders integration.woocommerce integration none assigned required 85 3 0
|
||
list_woocommerce_products integration.woocommerce integration none assigned required 85 2 0
|
||
list_workflow_action_catalog automation.workflow automation none assigned required 75 0 0
|
||
list_workflow_builtin_nodes automation.workflow automation none assigned required 75 0 0
|
||
list_workflow_executions automation.workflow automation none assigned required 75 2 0
|
||
list_workflow_trigger_catalog automation.workflow automation none assigned required 75 0 0
|
||
list_workflows automation.workflow automation none assigned required 85 5 1
|
||
poll_workflow_execution automation.workflow automation none assigned required 75 0 0
|
||
publish_report_template reports.templates reports write assigned required 75 0 0
|
||
query_business_data query.entity query none explicit_empty handler 95 2 1
|
||
read_memory agent.memory agent none explicit_empty self_scoped 95 2 1
|
||
recalculate_customer_club_rfm customer_club.loyalty customer_club write assigned required 75 0 0
|
||
resolve_currency_rate financial.currency financial none assigned required 75 0 0
|
||
resolve_date_range query.meta query none explicit_empty user_context 85 3 0
|
||
search_activities crm.activity crm none assigned required 75 0 0
|
||
search_activity_logs platform.audit platform none assigned required 65 0 0
|
||
search_categories inventory.product inventory none assigned required 75 0 0
|
||
search_checks financial.check financial none assigned required 75 0 0
|
||
search_customer_club_rfm_persons customer_club.loyalty customer_club none assigned required 65 0 0
|
||
search_deals crm.deal crm none assigned required 85 3 0
|
||
search_documents financial.document financial none assigned required 75 0 0
|
||
search_expense_income financial.expense financial none assigned required 65 0 0
|
||
search_invoices financial.invoice financial none assigned required 100 6 2
|
||
search_leads crm.lead crm none assigned required 95 3 1
|
||
search_persons people.person people none assigned required 95 5 2
|
||
search_product_instances inventory.stock inventory none assigned required 75 0 0
|
||
search_production_documents inventory.production inventory none assigned required 75 0 0
|
||
search_products inventory.product inventory none assigned required 95 4 1
|
||
search_projects misc.general misc none assigned required 65 0 0
|
||
search_receipts_payments financial.payment financial none assigned required 85 4 0
|
||
search_repair_orders misc.general misc none assigned required 75 0 0
|
||
search_tax_workspace tax.moadian tax none assigned required 75 2 0
|
||
search_transfers financial.transfer financial none assigned required 65 0 0
|
||
search_warehouse_documents inventory.warehouse inventory none assigned required 75 0 0
|
||
search_warranty_codes misc.general misc none assigned required 65 0 0
|
||
set_default_report_template reports.templates reports write assigned required 75 0 0
|
||
spawn_subagent agent.subagent agent none explicit_empty agent_internal 75 0 0
|
||
test_workflow automation.workflow automation execute assigned required 75 0 0
|
||
update_account financial.account financial write assigned required 75 0 0
|
||
update_check financial.check financial write assigned required 75 0 0
|
||
update_customer_club_settings customer_club.loyalty customer_club write assigned required 75 0 0
|
||
update_expense_income financial.expense financial write assigned required 85 3 0
|
||
update_invoice financial.invoice financial write assigned required 95 2 1
|
||
update_person people.person people write assigned required 75 0 0
|
||
update_product inventory.product inventory write assigned required 85 4 0
|
||
update_product_attribute inventory.product inventory write assigned required 65 0 0
|
||
update_receipt_payment financial.payment financial write assigned required 85 3 0
|
||
update_session_todo agent.plan agent none explicit_empty agent_internal 75 0 0
|
||
update_transfer financial.transfer financial write assigned required 75 0 0
|
||
update_workflow automation.workflow automation write assigned required 75 0 0
|
||
upsert_memory_entry agent.memory agent write explicit_empty self_scoped 95 2 1
|
||
validate_workflow_draft automation.workflow automation none assigned required 65 0 0
|
||
```
|