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

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

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

گفتگو

گفتگوی discover

طبقه‌بندی دامنه، پاسخ دانش پتنت، و توصیه بسته گردش‌کار فقط از فهرست packages ارسال‌شده Core.

توضیح کامل

هندلر نوبت گفتگو (ConversationTurnHandler) رویداد درخواست نوبت (ConversationTurnRequested) را مصرف می‌کند و برای agent_key=discover تابع جریان discover (stream_discover_turn) را صدا می‌زند. منطق دامنه از package landing_chat است: پاک‌سازی ورودی (scrub_user_message)، ارزیابی دامنه (evaluate_scope)، طبقه‌بندی، بازیابی دانش، و توصیه بسته (recommend_packages). توصیه فقط اگر کلید در packages مجاز Core باشد (assert_workflow_key_allowed) و ابزار recommend_workflow_package در available_tools باشد. خروجی متنی، recommendation_part و در صورت نیاز follow_up است؛ citation با URL به‌عنوان source_id مجاز نیست.

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

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

  • پاسخ خارج از دامنه با پیام ایستا باشد، نه توهم محصول
  • توصیه بسته فقط از packages منتشرشده Core باشد
  • دانش پتنت بدون شناسه خارجی غیرقابل‌حل و بدون افشای credential باشد
  • agent ناشناخته به شکست unsupported_agent (غیرقابل retry) منجر شود

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

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

  • assert_workflow_key_allowed قبل از recommendation_part پاس شود؛ وگرنه توصیه نیاید
  • ابزار recommend_workflow_package فقط وقتی در available_tools است فراخوانی شود (is_tool_authorised)
  • validate_tool_arguments آرگومان‌های tool را قبل از انتشار رد کند
  • رویدادهای stream (progress/delta/tool-call) مشورتی‌اند؛ منبع حقیقت پس از reconnect پیام‌های persistشده Core است

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

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

  • هندلر نوبت گفتگو (ConversationTurnHandler.handle_requested)
  • تابع جریان نوبت discover (stream_discover_turn)
  • تابع ارزیابی دامنه (evaluate_scope)
  • تابع پاک‌سازی پیام کاربر (scrub_user_message)
  • تابع توصیه بسته‌ها (recommend_packages)
  • تابع تضمین کلید مجاز بسته (assert_workflow_key_allowed)
  • تابع اعتبارسنجی آرگومان ابزار (validate_tool_arguments)

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

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

  • کلید عامل (agent_key = discover)
  • بسته زمینه گفتگو (ConversationContextBundle)
  • فهرست packages مجاز Core (packages)
  • ابزارهای مجاز نوبت (available_tools)
  • دسته درخواست (RequestCategory)
  • بخش توصیه بسته (recommendation_part)
  • کد شکست عامل پشتیبانی‌نشده (unsupported_agent)
  • صف درخواست نوبت (conversation.turn.requested)

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

پاسخ متنی و بخش‌ها (parts)

ConversationTurnCompleted.parts[]

چطور: stream_discover_turn → text / recommendation / follow_up

ویژگی‌ها:

  • recommendation.rank همیشه توسط worker پر می‌شود
  • بدون citation با URL به‌عنوان source_id

فراخوانی ابزار توصیه (tool_calls)

tool_calls[recommend_workflow_package]

چطور: فقط اگر در available_tools و workflow_key در packages باشد

ویژگی‌ها:

  • acceptance test در inbox Core برای کلید خارج از فهرست

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

  • خارج از دامنه → STATIC_OUT_OF_SCOPE_RESPONSE_FA بدون LLM محصولی
  • کلید بسته خارج از packages → عدم انتشار recommendation
  • agent_key نامعتبر → ConversationTurnFailed (unsupported_agent)

نکات

  • scripts/conversation_harness فقط برای توسعه است و معیار کیفیت محصول نیست