← بازگشت به صفحه اصلی
Quality

کیفیت پر شدن بخش‌ها

روی هر بخش کلیک کنید تا ببینید از نظر کیفیت به دنبال چه هستیم، چطور رسیدن به آن را می‌سنجیم، و فهرست توابع/متغیرها (توضیح فارسی و نام انگلیسی در پرانتز) به‌همراه فیلدهای پرشونده را مرور کنید. گروه‌ها: استخراج، پیشینه، ادعا، توصیف، بازنویسی میراث، گفتگو (discover/draft)، و Office Action.

Office Action

بسته پاسخ اظهارنظر

run_office_action_response خروجی ساخت‌یافته + markdown فارسی را با validate_office_action_state می‌سنجد.

توضیح کامل

ورود عمومی تابع اجرای پاسخ اظهارنظر (run_office_action_response) است. عامل با allowlist فاز (OfficeActionWorkflowPhase) ابزار می‌زند؛ ابزارهای قطعی ingest/validate/finalize جدا از LLM هستند. قبل از finalize، اعتبارسنج حالت (validate_office_action_state) قواعد CHECKED_RULES را اعمال می‌کند: پوشش پاسخ به ایرادها، نگاشت اصلاحات، وجود ادعاهای ذکرشده، اسناد استنادی در رجیستری، عدم جعل محل منبع، ادعاهای بدون تغییر عین متن، وابستگی ادعا، سازگاری پاسخ و اصلاح، ترتیب اجباری بخش‌ها، زبان فارسی بدون نشت داخلی، لنگر patch غیرادعایی، اصلاح نقشه دستی، و تناقض طبقه‌بندی. HITL در فاز await_strategy_approval با checkpoint قابل resume است.

از نظر کیفیت به دنبال چه هستیم؟

جملات مفهومی؛ هر شناسه با نام فارسی و سپس نام انگلیسی در پرانتز.

  • هر ایراد قابل‌اقدام پاسخ یا وضعیت صریح داشته باشد؛ بدون ISSUE_UNANSWERED
  • اصلاحات ادعا پشتیبانی‌شده و بدون شکستن وابستگی باشند
  • markdown فارسی بدون نشت شناسه داخلی و بدون الگوی ضدزبان باشد
  • نتیجه مثبت کاذب برای ایراد حل‌نشده تولید نشود (no_false_resolution)

چطور مطمئن می‌شویم رسیده‌ایم؟

نشانه رسیدن: توضیح فارسی و سپس متغیر، تابع یا کد انگلیسی در پرانتز.

  • validate_office_action_state بدون severity=error برای finalize سخت
  • validate_unchanged_claims_exact و validate_claim_dependencies پاس شوند
  • check_response_language نشت و الگوی زبان را رد کند
  • validate_classification_contradictions تناقض طبقه‌بندی را بگیرد
  • agent_key=office_action در conversation نامعتبر بماند (جدا از این package)

توابع و نقاط ورود

هر مورد: توضیح فارسی و سپس نام انگلیسی در پرانتز.

  • تابع اجرای پاسخ اظهارنظر (run_office_action_response)
  • تابع اعتبارسنجی حالت (validate_office_action_state)
  • تابع بررسی زبان پاسخ (check_response_language)
  • تابع اعتبارسنجی ادعاهای بدون تغییر (validate_unchanged_claims_exact)
  • تابع اعتبارسنجی وابستگی ادعا (validate_claim_dependencies)
  • تابع اعتبارسنجی پشتیبانی اصلاح (validate_amendment_support)
  • تابع تناقض طبقه‌بندی (validate_classification_contradictions)
  • تابع رندر markdown فارسی پاسخ (render_response_markdown_fa)

متغیرها، فیلدها و تنظیمات

هر مورد: توضیح فارسی و سپس شناسه انگلیسی در پرانتز.

  • نسخه طرحواره دامنه (schema_version = office_action_response.v1)
  • فاز گردش‌کار (OfficeActionWorkflowPhase)
  • فهرست قواعد بررسی‌شده (CHECKED_RULES)
  • کد ایراد بدون پاسخ (ISSUE_UNANSWERED)
  • وضعیت ایراد (IssueStatus)
  • نتیجه دامنه (OfficeActionResponseResult)
  • checkpoint قابل serialize برای resume (resume_checkpoint)
  • پرچم نیاز به تأیید استراتژی (require_strategy_approval)

چه چیزهایی پر می‌شوند؟

نتیجه پاسخ (OfficeActionResponseResult)

OfficeActionResponseResult

چطور: run_office_action_response پس از validate و assemble

ویژگی‌ها:

  • markdown_fa ده بخشی فارسی
  • outcome و warnings ساخت‌یافته

مسائل اعتبارسنجی (validation.issues)

OfficeActionValidation.issues[]

چطور: validate_office_action_state روی OfficeActionAgentState

ویژگی‌ها:

  • severity برابر error یا warning
  • کدهای CHECKED_RULES

کنترل‌های کیفیت

  • پوشش ایرادها (issue_resolution_coverage)
  • ادعاهای بدون تغییر عین متن (unchanged_claims_exact)
  • زبان فارسی بدون نشت (persian_no_internal_leaks)
  • عدم حل کاذب ایراد (no_false_resolution)
  • ترتیب اجباری بخش‌های پاسخ (mandatory_section_order)

نکات

  • progress فعلی فقط سه نقطه (start / pause / done) دارد؛ برای SSE آینده باید روی phase advance غنی شود
  • مستند wiring: docs/OFFICE_ACTION_AGENT_ARCHITECTURE.md