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

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

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

ادعانامه

پیش‌نویس ادعاها

از زمینه اختراع و نتیجه جستجوی پیشینه، ادعانامه فارسی ساخت‌یافته و markdown تولید می‌کند.

توضیح کامل

تابع تولید ادعا (run_claims_generation) عامل ادعانامه را اجرا می‌کند. لایه‌های grounding، prose و claims ساخته می‌شوند؛ متن کامل فارسی (full_text_fa) مرجع نیست و همیشه از فیلدهای ساخت‌یافته بازتولید می‌شود. قبل از finalize نرم، جمع‌آوری مسائل کیفیت ادعا (collect_quality_issues در quality_retry) کدهایی مانند وابسته بیش‌ازحد فشرده (dependent_overpacked_fallback) و والد اشتباه جزء (wrong_parent_component) را بررسی می‌کند. اعتبارسنجی لایه‌ها با validate_claim_layers انجام می‌شود. خروجی خالی یا validation.is_valid نابرابر true به‌عنوان خطا (CLAIMS_GENERATION_ERROR) منتشر می‌شود.

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

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

  • ادعاهای فارسی ساخت‌یافته با وابستگی درست و اتصال grounding به اجزا و ویژگی‌ها تولید شوند
  • نثر از فیلدهای ساخت‌یافته بازتولید شود، نه از متن کامل فارسی دلخواه (full_text_fa)
  • پرچم معتبر بودن اعتبارسنجی (validation.is_valid) برای انتشار تکمیل‌شده (completed) الزامی باشد

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

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

  • لایه ادعاها (claims) و Markdown فارسی (markdown_fa) غیرخالی با نسخه طرحواره ادعا (schema_version=claims.v2) باشند
  • تابع اعتبارسنجی لایه‌های ادعا (validate_claim_layers) و retry کیفیت (quality_retry) بدون کدهای بحرانی باقی‌مانده در مجموعه کدهای retry کیفیت (QUALITY_RETRY_CODES) تمام شوند
  • خالی بودن ادعاها (claims) یا معتبر نبودن (is_valid≠true) به خطای تولید ادعا (CLAIMS_GENERATION_ERROR) منجر شود نه رویداد تکمیل‌شده (completed)
  • در نوبت ابزار بومی (native tool turn)، narration جعلی tool در تست‌های مربوط رد شود

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

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

  • تابع تولید ادعانامه (run_claims_generation)
  • تابع اعتبارسنجی لایه‌های ادعا (validate_claim_layers)
  • تابع اعتبارسنجی مجموعه ادعا (validate_claim_set)
  • تابع جمع‌آوری مسائل کیفیت قبل از finalize (collect_quality_issues در quality_retry)
  • تشخیص narration جعلی tool در native tool turn (fake tool narration detection)

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

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

  • نسخه طرحواره ادعا (schema_version = claims.v2)
  • لایه grounding (grounding_claims)
  • لایه نثر ساخت‌یافته (claim_prose)
  • لایه ادعاهای نهایی (claims)
  • Markdown فارسی ادعانامه (markdown_fa)
  • نتیجه اعتبارسنجی (validation)
  • پرچم معتبر بودن (validation.is_valid)
  • کدهای retry کیفیت (QUALITY_RETRY_CODES)
  • نوع وابستگی مستقل یا وابسته (ClaimDependencyKind)
  • شناسه‌های جزء پشتیبان (supporting_component_ids)
  • نتیجه اجرا: completed_valid / completed_with_issues / failed (outcome)

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

ادعای grounding (grounding_claims)

grounding_claims[]

چطور: ابزارهای agent روی اجزا و ویژگی‌های زمینه اختراع

ویژگی‌ها:

  • supporting_component_ids و elementها
  • وابستگی independent یا dependent

نثر و ادعاها (claim_prose / claims)

claim_prose[] | claims[]

چطور: ترکیب از فیلدهای ساخت‌یافته؛ full_text_fa مرجع نیست

ویژگی‌ها:

  • نثر فارسی همیشه از structured fields بازتولید می‌شود
  • schema_version برابر claims.v2

Markdown فارسی (markdown_fa)

markdown_fa

چطور: رندر از لایه claims

ویژگی‌ها:

  • قابل دانلود به‌صورت فایل .claims.md

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

  • retry کیفیت برای dependent_overpacked_fallback و wrong_parent_component
  • claims خالی یا is_valid نابرابر true → CLAIMS_GENERATION_ERROR (non-retryable)
  • رد narration جعلی tool call در native tool turn

نکات

  • مسیر محصول: core-api outbox → draft.claims.requested → این worker → ClaimsDraftCompleted inline → inbox Core؛ نوشتن claims_draft.json و بخش ProseMirror بر عهده Core است (ADR-0014)