0%

Eindproject · oefening

Bouw quiz

De quiz is het meest afgeronde deel van de studieassistent. make_quiz uit hoofdstuk 9 stuurt het quizrequest via call_model, valideert het antwoord als QuizSet en vraagt nog één keer als het ongeldig is, en format_quiz uit hoofdstuk 4 maakt van een QuizSet genummerde vragen met keuzes met letters en een regel met de antwoorden. Het commando quiz heeft nog één ding nodig: de gebruiker noemt de notitie en kan om een aantal vragen vragen.

Eén wijziging in reliable.py

Open reliable.py en zoek make_quiz. Het is de functie uit hoofdstuk 9 met één wijziging, die je krijgt:

def make_quiz(note_text, *, client, budget, sleep, count=3):
    messages = [{"role": "system", "content": QUIZ_SYSTEM}, note_message(note_text, QUIZ_PROMPTS[count])]
    request = {"model": MODEL, "messages": messages, "response_format": QUIZ_FORMAT}

count is het aantal vragen, en QUIZ_PROMPTS in prompts.py bevat voor elk aantal van 1 tot 5 een vaste prompt, zoals Write two multiple-choice questions about the note below. Met een vaste prompt per aantal, in plaats van een getal in één zin, heeft het gescripte model voor elk daarvan een antwoord klaar. QUIZ_PROMPTS[3] is QUIZ_PROMPT zelf, dus een quiz met drie vragen stuurt precies wat hoofdstuk 4 tot en met 9 stuurden. De rest van make_quiz is ongewijzigd: hij werpt ValueError("The model sent no quiz text.") op bij een antwoord zonder tekst, en de ValidationError van een tweede ongeldig antwoord bereikt de aanroeper.

quiz_command

quiz_command(note_id, count, *, client, budget, sleep) geeft de quiz terug als tekst, of werpt een fout op:

  1. Controleer eerst de notitie-id. Als note_id niet in note_ids() staat, werp je FileNotFoundError(f"There is no note called {note_id}.") op, vóór elk request.

  2. Lees de notitie: text = read_note({"note_id": note_id}). read_note is de toolfunctie uit hoofdstuk 6, dus die krijgt een dictionary met argumenten.

  3. Geef format_quiz(make_quiz(text, client=client, budget=budget, sleep=sleep, count=count)) terug.

Vang niets af. Les 6 maakt van elke fout een exitcode.

Waarom controleer je de id zelf, als read_note al ValueError opwerpt voor een notitie die niet bestaat? Bij ask is een ontbrekende notitie een toolfout: het model vroeg erom, en de melding There is no note called 99-magic. Call list_notes to see the ids. gaat terug naar het model, dat het opnieuw kan proberen. Hier typte de gebruiker de id, dus het programma antwoordt de gebruiker direct, voordat het tokens uitgeeft. FileNotFoundError is de eigen fout van Python voor “dat bestand bestaat niet”, en die krijgt een eigen exitcode, 4, omdat het een typfout van de gebruiker is en geen mislukte run.

note_ids() leest tools.NOTES_DIR, die main met use_settings naar de juiste map laat wijzen. De controle van je werk laat hem wijzen naar een map met notities die je nog nooit hebt gezien.

Voer het uit

Als quiz_command geschreven is, voer je python stages.py uit. Het blok van les 4 vraagt om twee vragen over 03-lists en daarna om een quiz over 99-magic:

Lesson 4: quiz_command
--- 03-lists, 2 questions
1. For scores = [90, 72, 85], what is scores[-1]?
   a) 90
   b) 72
   c) 85

2. What does scores.append(60) return?
   a) The new list
   b) None
   c) 60

Answers: 1c, 2b
(tokens used: 448)
--- 99-magic
FileNotFoundError: There is no note called 99-magic.
Lesson 5: chat_command, typing two questions and then an empty line
Run stopped at the next function to build: chat_command is built in Lesson 5.

De twee vragen zijn de eerste twee van de quiz uit hoofdstuk 4: het gescripte model heeft voor elk aantal één voorbereid antwoord. De tweede aanroep stuurde geen request, omdat de id eerst werd gecontroleerd.

read_note werpt al een ValueError op voor een notitie die niet bestaat. Waarom controleert quiz_command eerst note_ids()?

Het quizantwoord is ongeldig, en het antwoord op de ene nieuwe poging van make_quiz ook. Wat doet quiz_command?

Opdracht

Schrijf in study_assistant.py quiz_command(note_id, count, *, client, budget, sleep):

  1. Als note_id niet in note_ids() staat, werp je FileNotFoundError(f"There is no note called {note_id}.") op, vóór elk request.

  2. Lees de notitie met text = read_note({"note_id": note_id}).

  3. Geef format_quiz(make_quiz(text, client=client, budget=budget, sleep=sleep, count=count)) terug.

Vang niets af: fouten uit make_quiz bereiken de aanroeper. Voer python stages.py uit om een quiz met twee vragen en een niet-bestaande notitie te zien, en controleer daarna je werk.