Zareian
fa56308a35
مهم‌ترین خواسته‌ی سینیور این بود که بسنجیم پاسخِ AI واقعاً یاد می‌دهد یا نه. برای سنجیدن، اول باید پاسخ‌ها قابلِ ردیابی می‌شدند. پرامپت‌ها پایه‌آگاه شدند: تا پیش از این «معلمِ دبستانی» برای پایه نهم هاردکد بود، هم در تولیدِ پاسخ و هم در vision — یعنی دانش‌آموزِ نهم لحنِ ابتدایی می‌گرفت. PROMPT_VERSION حالا روی هر پیام ذخیره می‌شود. هر پاسخ حاشیه‌نویسی می‌شود: مدل، نسخه‌ی پرامپت، پایه، collection، مقدارِ فیلتر، تعداد chunk، توکن، تأخیر و from_cache. فیدبک reason اختیاری گرفت تا لایک/دیسلایک بعداً قابلِ تحلیل باشد («بشه چک کرد کدوم بهتر بوده»). ai_feedback_report --by prompt_version نسبتِ رضایت را کنارِ مصرف/هزینه می‌گذارد. rag_eval سوال‌های واقعی را از مسیرِ واقعی می‌پرسد، با --retrieval-only برای اجرای ارزان. rag/services/lesson_context.py از lessonId تنها پایه و فصل را درمی‌آورد؛ normalize_grade_title هم اختلافِ «پایه نهم» در دیتابیس با «ریاضی نهم» در نامِ collection را می‌بندد — بدونِ آن مسیرِ gradeId بی‌سروصدا خالی برمی‌گشت. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
64 lines
3.5 KiB
Python
64 lines
3.5 KiB
Python
from rest_framework import serializers
|
|
|
|
|
|
class AskRequestSerializer(serializers.Serializer):
|
|
conversationId = serializers.CharField(required=False, allow_null=True, allow_blank=True)
|
|
lessonId = serializers.CharField(required=False, allow_null=True, allow_blank=True)
|
|
chapterId = serializers.CharField(required=False, allow_null=True, allow_blank=True)
|
|
gradeId = serializers.IntegerField(required=False, allow_null=True)
|
|
questionId = serializers.CharField(required=False, allow_null=True, allow_blank=True)
|
|
# metadataِ retrieval برای لایه‌ی RAG (اپ rag): برای زدن به دیتای واقعیِ
|
|
# کتاب‌ها در Qdrant باید subject (مثلاً «علوم تجربی») + gradeId + lessonNumber
|
|
# همگی مطابقِ دادهٔ موجود ارسال بشن؛ اگه نباشن، پاسخ به‌صورتِ تدریسِ عمومی
|
|
# (بدونِ استناد به کتاب) تولید می‌شه. در ادامه‌ی همون مکالمه لازم نیست
|
|
# دوباره فرستاده بشن (روی Conversation ذخیره می‌شن).
|
|
subject = serializers.CharField(required=False, allow_null=True, allow_blank=True)
|
|
# جزءِ «پایه» در نامِ collectionِ Qdrant (مثلاً «ششم»). اگه بیاد مستقیم
|
|
# استفاده می‌شه؛ اگه نه، از روی gradeId و content.Grade.title / نگاشتِ
|
|
# RAG_GRADE_TITLE_OVERRIDES ساخته می‌شه.
|
|
grade = serializers.CharField(required=False, allow_null=True, allow_blank=True)
|
|
lessonNumber = serializers.IntegerField(required=False, allow_null=True)
|
|
userQuestion = serializers.CharField()
|
|
stream = serializers.BooleanField(required=False, default=False)
|
|
|
|
|
|
class UsedChunkSerializer(serializers.Serializer):
|
|
title = serializers.CharField(allow_blank=True)
|
|
summary = serializers.CharField()
|
|
|
|
|
|
class AskResponseSerializer(serializers.Serializer):
|
|
conversationId = serializers.CharField()
|
|
messageId = serializers.CharField()
|
|
answer = serializers.CharField()
|
|
suggestedFollowUps = serializers.ListField(child=serializers.CharField())
|
|
remainingQuota = serializers.IntegerField()
|
|
# تکه‌های درسیِ بازیابی‌شده از Qdrant که پاسخ بر پایه‌شون ساخته شده؛
|
|
# خالی یعنی retrieval انجام نشده (نبودِ subject/lessonNumber یا خاموش‌بودنِ RAG).
|
|
usedChunks = UsedChunkSerializer(many=True, required=False, default=list)
|
|
# فقط وقتی DEBUG=True: از کدام collection/فصل چانک‌ها برداشته شد (بازبینیِ داخلی).
|
|
retrievalDebug = serializers.DictField(required=False)
|
|
|
|
|
|
class MessageSerializer(serializers.Serializer):
|
|
messageId = serializers.CharField()
|
|
role = serializers.CharField()
|
|
text = serializers.CharField()
|
|
|
|
|
|
class ConversationMessagesResponseSerializer(serializers.Serializer):
|
|
conversationId = serializers.CharField()
|
|
lessonId = serializers.CharField(allow_null=True)
|
|
messages = MessageSerializer(many=True)
|
|
|
|
|
|
class FeedbackRequestSerializer(serializers.Serializer):
|
|
isHelpful = serializers.BooleanField()
|
|
# اختیاری: «چرا». تنها چیزی که از خودِ 👍/👎 درنمی‌آید و برای اصلاحِ
|
|
# پرامپت واقعاً به کار می‌آید.
|
|
reason = serializers.CharField(max_length=300, required=False, allow_blank=True)
|
|
|
|
|
|
class FeedbackResponseSerializer(serializers.Serializer):
|
|
success = serializers.BooleanField()
|