پرش به مطلب اصلی

بازخورد و گزارش مشکل کاربر

Gratis AI Agent v1.5.0 یک سیستم داخلی برای دریافت بازخورد و گزارش مشکل معرفی کرده است که به کاربران نهایی اجازه می‌دهد پاسخ‌های غیرمفید را علامت‌گذاری کرده و مشکلات را مستقیماً از رابط چت گزارش دهند. این سیستم شامل مدیریت رضایت (consent management)، یک دستور گزارش‌دهی خودکار، و طبقه‌بندی اولیه (triage) با کمک هوش مصنوعی در بک‌اند است.

دکمه "انگشت پایین" (Thumbs-Down Button)​

هر پیامی که توسط دستیار هوش مصنوعی ارسال می‌شود، یک دکمه انگشت پایین (👎) نمایش می‌دهد. وقتی کاربر روی آن کلیک می‌کند، می‌تواند پاسخی را به عنوان غیرمفید یا نادرست علامت‌گذاری کند.

  • این دکمه هنگام نگه داشتن ماوس (hover) در کنار هر پیام دستیار ظاهر می‌شود.
  • کلیک روی آن، پنجره رضایت بازخورد (Feedback Consent Modal) را باز می‌کند.
  • بازخورد با رشته مکالمه و پیام خاص مرتبط می‌شود.

هنگامی که کاربر روی دکمه انگشت پایین کلیک می‌کند، قبل از ارسال هرگونه داده‌ای، یک پنجره رضایت ظاهر می‌شود. این پنجره:

  • توضیح می‌دهد که چه اطلاعاتی جمع‌آوری خواهد شد (بخش از مکالمه، زمینه مرورگر).
  • از کاربر می‌خواهد که تأیید کند با اشتراک‌گذاری این داده‌ها موافق است.
  • یک فیلد متنی آزاد برای کاربر فراهم می‌کند تا توضیح دهد چه مشکلی پیش آمده است.
  • گزینه لغو (Cancel) را برای بستن پنجره بدون ارسال، ارائه می‌دهد.

تا زمانی که کاربر به صراحت تأیید نکند، هیچ بازخوردی ثبت نخواهد شد.

بنر بازخورد پرامپت خودکار (Auto-Prompt Feedback Banner)​

در پایان یک مکالمه، دستیار ممکن است یک بنر بازخورد پرامپت خودکار نمایش دهد؛ این یک پیام غیرمزاحم است که می‌پرسد آیا جلسه مفید بوده است یا خیر.

این بنر بر اساس طول مکالمه و معیارهای هوشمند (heuristics) نتیجه، به صورت خودکار ظاهر می‌شود. این بنر به همان جریان بازخورد دکمه انگشت پایین لینک دارد. کاربران می‌توانند بنر را بدون ارائه بازخورد، رد کنند.

دستور اسلش /report-issue​

کاربران می‌توانند با تایپ کردن /report-issue در ورودی چت، مستقیماً جریان بازخورد را فعال کنند. این دستور:

  • بلافاصله پنجره رضایت بازخورد (Feedback Consent Modal) را باز می‌کند.
  • فیلد توضیحات را با اطلاعاتی درباره مکالمه جاری پر می‌کند.
  • به کاربران اجازه می‌دهد قبل از ارسال، جزئیات بیشتری اضافه کنند.

دستور /report-issue در تمام حالت‌های چت (در خط، ویجت شناور، تمام صفحه) در دسترس است.

طبقه‌بندی اولیه با کمک هوش مصنوعی (AI-Assisted Triage)​

بازخورد ارسالی به یک لایه طبقه‌بندی اولیه هوش مصنوعی هدایت می‌شود که:

  • گزارش را دسته‌بندی می‌کند (خطای واقعی، پاسخ غیرمفید، محتوای نامناسب و غیره).
  • فراداده (metadata) مرتبط مکالمه را ضمیمه می‌کند.
  • خلاصه طبقه‌بندی اولیه را به نقطه پایانی بازخورد (Feedback Endpoint) پیکربندی شده ارسال می‌کند (به Settings > Advanced مراجعه کنید).

این کار با نمایش مسائل حیاتی در اولویت، زمان بازبینی دستی را کاهش می‌دهد.

Settings > Advanced​

برای فعال کردن بک‌اند بازخورد، فیلدهای زیر را در مسیر Gratis AI Agent → Settings → Advanced پیکربندی کنید:

FieldDescription
Feedback Endpoint URLآدرسی که درخواست‌های POST حاوی محموله‌های بازخورد (JSON) را دریافت می‌کند.
Feedback API Keyتوکن Bearer که در هدر Authorization برای احراز هویت ارسال بازخوردها ارسال می‌شود.

برای غیرفعال کردن جمع‌آوری بازخورد، هر دو فیلد را خالی بگذارید. دکمه‌های بازخورد فردی همچنان برای کاربران قابل مشاهده هستند، اما ارسال‌ها به مقصد فرستاده نخواهند شد.

نکته

نقطه پایانی بازخورد باید یک بدنه JSON با حداقل فیلدهای message_id، conversation_id، feedback_text و triage_category بپذیرد. برای ساختار مورد انتظار، به مستندات ارائه‌دهنده نقطه پایانی خود مراجعه کنید.