0%

Abschlussprojekt · Übung

quiz bauen

Das Quiz ist der fertigste Teil des Lernassistenten. make_quiz aus Kapitel 9 sendet die Quiz-Anfrage über call_model, validiert die Antwort als QuizSet und fragt noch einmal, wenn sie ungültig ist, und format_quiz aus Kapitel 4 macht aus einem QuizSet nummerierte Fragen mit Antwortmöglichkeiten mit Buchstaben und eine Zeile mit den Lösungen. Der Befehl quiz braucht noch eine Sache: Die Person nennt die Notiz und kann eine Anzahl von Fragen verlangen.

Eine Änderung in reliable.py

Öffne reliable.py und suche make_quiz. Es ist die Funktion aus Kapitel 9 mit einer Änderung, die vorgegeben ist:

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 ist die Anzahl der Fragen, und QUIZ_PROMPTS in prompts.py enthält einen festen Prompt für jede Anzahl von 1 bis 5, etwa Write two multiple-choice questions about the note below. Ein fester Prompt pro Anzahl, statt einer Zahl, die in einen Satz eingesetzt wird, bedeutet, dass das geskriptete Modell für jeden davon eine Antwort bereit hat. QUIZ_PROMPTS[3] ist QUIZ_PROMPT selbst, also sendet ein Quiz mit drei Fragen genau das, was die Kapitel 4 bis 9 gesendet haben. Der Rest von make_quiz ist unverändert: Es löst ValueError("The model sent no quiz text.") bei einer Antwort ohne Text aus, und der ValidationError einer zweiten ungültigen Antwort erreicht den Aufrufer.

quiz_command

quiz_command(note_id, count, *, client, budget, sleep) gibt das Quiz als Text zurück oder löst einen Fehler aus:

  1. Prüfe zuerst die Notiz-ID. Wenn note_id nicht in note_ids() steht, löse FileNotFoundError(f"There is no note called {note_id}.") aus, vor jeder Anfrage.

  2. Lies die Notiz: text = read_note({"note_id": note_id}). read_note ist die Tool-Funktion aus Kapitel 6, also nimmt sie ein Dictionary mit Argumenten.

  3. Gib format_quiz(make_quiz(text, client=client, budget=budget, sleep=sleep, count=count)) zurück.

Fang nichts ab. Lektion 6 macht aus jedem Fehler einen Exit-Code.

Warum prüfst du die ID selbst, wenn read_note bei einer nicht existierenden Notiz schon einen ValueError auslöst? In ask ist eine fehlende Notiz ein Tool-Fehler: Das Modell hat sie angefordert, und die Meldung There is no note called 99-magic. Call list_notes to see the ids. geht an das Modell zurück, das es erneut versuchen kann. Hier hat die Person die ID eingetippt, also antwortet das Programm ihr direkt, bevor es Tokens ausgibt. FileNotFoundError ist Pythons eigener Fehler für „diese Datei gibt es nicht“, und er bekommt einen eigenen Exit-Code, 4, weil es ein Tippfehler der Person ist, kein fehlgeschlagener Lauf.

note_ids() liest tools.NOTES_DIR, das main mit use_settings auf den richtigen Ordner setzen wird. Die Prüfung deiner Arbeit setzt es auf einen Ordner mit Notizen, die du nie gesehen hast.

Ausführen

Wenn quiz_command geschrieben ist, führe python stages.py aus. Der Block von Lektion 4 verlangt zwei Fragen zu 03-lists und dann ein Quiz zu 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.

Die zwei Fragen sind die ersten beiden aus dem Quiz von Kapitel 4: Das geskriptete Modell hat für jede Anzahl eine vorbereitete Antwort. Der zweite Aufruf hat keine Anfrage gesendet, weil die ID zuerst geprüft wurde.

read_note löst bei einer nicht existierenden Notiz schon einen ValueError aus. Warum prüft quiz_command zuerst note_ids()?

Die Quiz-Antwort ist ungültig, und die Antwort auf den einen erneuten Versuch von make_quiz auch. Was macht quiz_command?

Aufgabe

Schreib in study_assistant.py die Funktion quiz_command(note_id, count, *, client, budget, sleep):

  1. Wenn note_id nicht in note_ids() steht, löse vor jeder Anfrage FileNotFoundError(f"There is no note called {note_id}.") aus.

  2. Lies die Notiz mit text = read_note({"note_id": note_id}).

  3. Gib format_quiz(make_quiz(text, client=client, budget=budget, sleep=sleep, count=count)) zurück.

Fang nichts ab: Fehler aus make_quiz erreichen den Aufrufer. Führe python stages.py aus, um ein Quiz mit zwei Fragen und eine nicht existierende Notiz zu sehen, und prüfe dann deine Arbeit.