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

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

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

گفتگو

گفتگوی draft (ویرایش انتخاب)

با انتخاب متن در پیش‌نویس، پیشنهاد ویرایش متن ساده می‌دهد؛ Core Slice و accept/reject را می‌سازد.

توضیح کامل

برای agent_key=draft تابع جریان draft (stream_draft_turn) اجرا می‌شود. ابزارهای مجاز معمول: get_section_text، search_draft_sections، propose_draft_edit. پیشنهاد ویرایش فقط متن ساده + instruction است و هرگز ProseMirror Slice از worker نمی‌آید. اگر selection نباشد یا ابزار مجاز نباشد، پیام راهنما برمی‌گردد نه پیشنهاد جعلی. Core با draft_edit_apply پیشنهاد را به part از نوع draft_edit_proposal تبدیل و روی accept اعمال می‌کند.

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

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

  • پیشنهاد فقط وقتی selection و ابزار propose_draft_edit مجاز است
  • متن پیشنهادی خالی یا بی‌معنی به‌عنوان پیشنهاد معتبر منتشر نشود
  • worker هیچ مختصات Slice یا schema ویرایشگر را اختراع نکند

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

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

  • is_tool_authorised قبل از propose_draft_edit
  • validate_tool_arguments آرگومان‌های instruction و text را بسنجد
  • بدون selection → پیام راهنما؛ نه tool_call جعلی
  • پس از accept در Core، بخش پیش‌نویس با قفل و rebase سازگار به‌روز شود (مسئولیت Core)

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

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

  • تابع جریان نوبت draft (stream_draft_turn)
  • تابع مجاز بودن ابزار (is_tool_authorised)
  • تابع اعتبارسنجی آرگومان ابزار (validate_tool_arguments)
  • سرویس اعمال پیشنهاد در Core (draft_edit_apply — خارج از این مخزن)

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

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

  • کلید عامل (agent_key = draft)
  • نام ابزار پیشنهاد ویرایش (propose_draft_edit)
  • پیوست انتخاب پیش‌نویس (ConversationAttachment selection)
  • نوع بخش پیشنهاد (draft_edit_proposal در Core)
  • پرچم فعال‌سازی ویرایش (DRAFT_EDIT_ENABLED در Core)

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

پیشنهاد ویرایش متنی (propose_draft_edit args)

tool_calls[propose_draft_edit].arguments

چطور: stream_draft_turn وقتی selection و ابزار مجاز باشند

ویژگی‌ها:

  • instruction + plain replacement text
  • بدون ProseMirror از worker

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

  • نبود selection → عدم tool_call ویرایش
  • ابزار غیرمجاز → پیام عدم دسترسی، نه پیشنهاد
  • آرگومان نامعتبر → validate_tool_arguments رد می‌کند