255 lines
9.0 KiB
Python
255 lines
9.0 KiB
Python
import os
|
||
from typing import List
|
||
from openai import OpenAI
|
||
from sqlalchemy.orm import Session
|
||
from . import models
|
||
from .curriculum import QUESTIONS, SKILLS
|
||
from .program_content import get_lesson
|
||
|
||
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
|
||
|
||
|
||
SYSTEM_PROMPT = """
|
||
Tu es Professeur TOP, un professeur virtuel français pour enfants de 8 à 12 ans.
|
||
Règles :
|
||
- Tu parles toujours en français simple et chaleureux.
|
||
- Tu donnes des explications très courtes, puis un mini exemple.
|
||
- Tu tiens compte du niveau de l'élève et de ses faiblesses indiquées dans le contexte.
|
||
- Tu n'inventes pas la progression : elle est fournie dans le contexte.
|
||
- Tu encourages sans infantiliser.
|
||
- Quand l'élève se trompe, tu expliques calmement puis proposes une question très simple.
|
||
- Tu enseignes principalement le programme national français niveau primaire/cycle 3.
|
||
""".strip()
|
||
|
||
TURN_TAKING_PROMPT = """
|
||
Consignes de rythme oral:
|
||
- Fais des tours de parole courts: 1 a 3 phrases maximum, sauf demande explicite.
|
||
- Termine souvent par une question ou une consigne courte pour laisser l'enfant parler.
|
||
- Ne fais pas de longs monologues: une idee a la fois.
|
||
- Si l’élève t’interrompt, arrête-toi, écoute son message, puis reprends seulement si c’est utile.
|
||
- Si l'interruption semble accidentelle ou hors sujet, reponds tres brievement puis continue.
|
||
""".strip()
|
||
|
||
TTS_PROFILES = [
|
||
{
|
||
"id": "rigolote",
|
||
"label": "Rigolote",
|
||
"description": "La plus joueuse et cartoon.",
|
||
"voice": "coral",
|
||
"speed": 1.08,
|
||
"instructions": (
|
||
"Parle en français avec une énergie joyeuse, malicieuse et très expressive. "
|
||
"Tu es Professeur TOP, un professeur amusant, chaleureux et un peu théâtral. "
|
||
"Le ton doit rester clair pour un enfant, avec des intonations souriantes, "
|
||
"des fins de phrases dynamiques et une diction très vivante."
|
||
),
|
||
},
|
||
{
|
||
"id": "petillante",
|
||
"label": "Pétillante",
|
||
"description": "Enjouée, dynamique et encourageante.",
|
||
"voice": "shimmer",
|
||
"speed": 1.03,
|
||
"instructions": (
|
||
"Parle en français avec une voix lumineuse, motivante et positive. "
|
||
"Tu es Professeur TOP: enthousiaste, rassurant et très engageant, "
|
||
"sans caricature excessive. Garde une diction nette et chaleureuse."
|
||
),
|
||
},
|
||
{
|
||
"id": "douce",
|
||
"label": "Douce",
|
||
"description": "Calme, rassurante et patiente.",
|
||
"voice": "sage",
|
||
"speed": 0.98,
|
||
"instructions": (
|
||
"Parle en français avec une voix douce, calme et très rassurante. "
|
||
"Tu es Professeur TOP dans une version posée, bienveillante et patiente. "
|
||
"Le rythme est fluide, jamais pressé, avec une intonation apaisante."
|
||
),
|
||
},
|
||
{
|
||
"id": "sobre",
|
||
"label": "Sobre",
|
||
"description": "La plus neutre et sérieuse.",
|
||
"voice": "alloy",
|
||
"speed": 1.0,
|
||
"instructions": (
|
||
"Parle en français avec une voix claire, naturelle et sobre. "
|
||
"Tu es Professeur TOP dans une version très lisible, professionnelle et mesurée. "
|
||
"Reste chaleureux, mais sans effet théâtral."
|
||
),
|
||
},
|
||
]
|
||
|
||
|
||
def seed_skills(db: Session) -> None:
|
||
for skill in SKILLS:
|
||
existing = db.query(models.Skill).filter(models.Skill.code == skill["code"]).first()
|
||
if not existing:
|
||
db.add(models.Skill(**skill))
|
||
db.commit()
|
||
|
||
|
||
def ensure_student_mastery(db: Session, student: models.Student) -> None:
|
||
all_skills = db.query(models.Skill).all()
|
||
for skill in all_skills:
|
||
found = (
|
||
db.query(models.StudentSkillMastery)
|
||
.filter_by(student_id=student.id, skill_id=skill.id)
|
||
.first()
|
||
)
|
||
if not found:
|
||
db.add(models.StudentSkillMastery(student_id=student.id, skill_id=skill.id))
|
||
db.commit()
|
||
|
||
|
||
def get_student_context(db: Session, student_id: int) -> str:
|
||
student = db.query(models.Student).filter_by(id=student_id).first()
|
||
mastery = (
|
||
db.query(models.StudentSkillMastery, models.Skill)
|
||
.join(models.Skill, models.Skill.id == models.StudentSkillMastery.skill_id)
|
||
.filter(models.StudentSkillMastery.student_id == student_id)
|
||
.all()
|
||
)
|
||
recent_messages = (
|
||
db.query(models.Message)
|
||
.filter_by(student_id=student_id)
|
||
.order_by(models.Message.created_at.desc())
|
||
.limit(6)
|
||
.all()
|
||
)
|
||
|
||
assignment = db.query(models.StudentProgramAssignment).filter_by(student_id=student_id).first()
|
||
lesson = get_lesson(assignment.lesson_id) if assignment else None
|
||
|
||
lines: List[str] = [
|
||
f"Élève: {student.first_name}, {student.age} ans, classe {student.grade}.",
|
||
"Progression par compétence:",
|
||
]
|
||
if lesson:
|
||
lines.append(
|
||
f"Leçon programme sélectionnée par le professeur: {lesson['title']} ({lesson['subject']}, {lesson['grade']})."
|
||
)
|
||
for mastery_row, skill in mastery:
|
||
lines.append(
|
||
f"- {skill.label}: score={mastery_row.mastery_score:.1f}, confiance={mastery_row.confidence:.2f}, preuves={mastery_row.evidence_count}"
|
||
)
|
||
lines.append("Historique récent:")
|
||
for message in reversed(recent_messages):
|
||
lines.append(f"- {message.role}: {message.content}")
|
||
return "\n".join(lines)
|
||
|
||
|
||
def build_llm_reply(db: Session, student_id: int, user_message: str) -> str:
|
||
context = get_student_context(db, student_id)
|
||
response = client.responses.create(
|
||
model="gpt-4.1-mini",
|
||
input=[
|
||
{"role": "system", "content": SYSTEM_PROMPT},
|
||
{"role": "system", "content": TURN_TAKING_PROMPT},
|
||
{
|
||
"role": "user",
|
||
"content": f"Contexte pédagogique:\n{context}\n\nMessage de l'élève:\n{user_message}",
|
||
},
|
||
],
|
||
temperature=0.7,
|
||
)
|
||
return response.output_text.strip()
|
||
|
||
|
||
def list_tts_profiles() -> list[dict]:
|
||
return [
|
||
{
|
||
"id": profile["id"],
|
||
"label": profile["label"],
|
||
"description": profile["description"],
|
||
}
|
||
for profile in TTS_PROFILES
|
||
]
|
||
|
||
|
||
def synthesize_speech(text: str, profile_id: str) -> bytes:
|
||
clean_text = text.strip()
|
||
if not clean_text:
|
||
raise ValueError("Texte à synthétiser manquant")
|
||
|
||
profile = next((item for item in TTS_PROFILES if item["id"] == profile_id), None)
|
||
if not profile:
|
||
raise ValueError("Profil de voix inconnu")
|
||
|
||
response = client.audio.speech.create(
|
||
model="gpt-4o-mini-tts",
|
||
voice=profile["voice"],
|
||
input=clean_text[:4096],
|
||
instructions=profile["instructions"],
|
||
response_format="mp3",
|
||
speed=profile["speed"],
|
||
)
|
||
return response.content
|
||
|
||
|
||
def transcribe_audio(filename: str, audio_bytes: bytes, content_type: str | None = None) -> str:
|
||
file_payload = (filename, audio_bytes, content_type or "application/octet-stream")
|
||
transcript = client.audio.transcriptions.create(
|
||
model="gpt-4o-mini-transcribe",
|
||
file=file_payload,
|
||
language="fr",
|
||
prompt=(
|
||
"Transcris uniquement en français. "
|
||
"Le locuteur est un enfant qui repond a un exercice scolaire. "
|
||
"Les phrases peuvent etre tres courtes, par exemple: nous chantons, je lis, 8 plus 5."
|
||
),
|
||
)
|
||
return (getattr(transcript, "text", "") or "").strip()
|
||
|
||
|
||
def pick_next_skill(db: Session, student_id: int) -> models.Skill:
|
||
weakest = (
|
||
db.query(models.StudentSkillMastery)
|
||
.filter_by(student_id=student_id)
|
||
.order_by(models.StudentSkillMastery.mastery_score.asc())
|
||
.first()
|
||
)
|
||
return db.query(models.Skill).filter_by(id=weakest.skill_id).first()
|
||
|
||
|
||
def evaluate_answer(db: Session, student_id: int, skill_code: str, answer: str):
|
||
q = QUESTIONS[skill_code]
|
||
normalized_student = answer.strip().lower()
|
||
normalized_expected = q["expected_answer"].strip().lower()
|
||
correct = normalized_student == normalized_expected
|
||
|
||
skill = db.query(models.Skill).filter_by(code=skill_code).first()
|
||
mastery = (
|
||
db.query(models.StudentSkillMastery)
|
||
.filter_by(student_id=student_id, skill_id=skill.id)
|
||
.first()
|
||
)
|
||
|
||
if correct:
|
||
mastery.mastery_score = min(100.0, mastery.mastery_score + 8)
|
||
mastery.confidence = min(1.0, mastery.confidence + 0.15)
|
||
feedback = q["feedback_ok"]
|
||
else:
|
||
mastery.mastery_score = max(0.0, mastery.mastery_score - 6)
|
||
mastery.confidence = min(1.0, mastery.confidence + 0.1)
|
||
feedback = q["feedback_ko"]
|
||
|
||
mastery.evidence_count += 1
|
||
|
||
db.add(
|
||
models.AssessmentAttempt(
|
||
student_id=student_id,
|
||
skill_code=skill_code,
|
||
question=q["question"],
|
||
expected_answer=q["expected_answer"],
|
||
student_answer=answer,
|
||
is_correct=1 if correct else 0,
|
||
feedback=feedback,
|
||
)
|
||
)
|
||
db.commit()
|
||
db.refresh(mastery)
|
||
return correct, feedback, mastery.mastery_score
|