0%

Strukturierte Ausgabe · Abschlussprojekt

Abschlussprojekt: Projekt: Aus einer Notiz Quizfragen machen

Dieses Projekt fügt das Kapitel zusammen. Gib ihm eine Kursnotiz, und es bittet das Modell um ein Quiz, validiert die Antwort, fragt bei einer ungültigen Antwort noch einmal und gibt das Quiz in einer Form aus, die ein Lernender bearbeiten kann:

>>> quiz = make_quiz(open("notes/03-lists.md", encoding="utf-8").read())
>>> print(format_quiz(quiz))
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

3. Which line makes an independent copy of scores?
   a) backup = scores.copy()
   b) backup = scores
   c) backup = scores.append(0)

Answers: 1c, 2b, 3a

Du baust zwei Funktionen: make_quiz, die ein gültiges QuizSet beschafft, und format_quiz, die daraus diesen Text macht.

Baue make_quiz

make_quiz(note_text, *, session=None) übernimmt die session=None-Nahtstelle aus Kapitel 1, damit die Prüfung deiner Arbeit eine Fake-Session übergeben kann, die vorbereitete Antworten zurückgibt. Übergib session=session an jeden Aufruf von send_body.

  1. body = quiz_request(note_text).

  2. text = answer_text(send_body(body, session=session)).

  3. Gib parse_quiz(text) zurück.

  4. Wenn Schritt 3 einen ValidationError auslöst, baue retry_request(body, text, error), sende es mit send_body und gib parse_quiz des Antworttexts zurück.

Fange nur ValidationError ab, und nur um parse_quiz herum. Eine Anfrage, die scheitert, etwa mit einem 500 vom Dienst, löst in send_body einen Fehler aus, bevor es überhaupt eine Antwort zum Korrigieren gibt; erneut mit Feedback zu einer ungültigen Antwort zu fragen, ergäbe keinen Sinn, also lass diesen Fehler beim Aufrufer ankommen. Wenn auch die Antwort auf den erneuten Versuch ungültig ist, kommt ihr ValidationError ebenfalls beim Aufrufer an, wie in Lektion 8 erklärt: ein erneuter Versuch, dann Schluss.

Eine Möglichkeit zu verhindern, dass der zweite ValidationError vom ersten except abgefangen wird: Gib innerhalb des try zurück und sende den erneuten Versuch danach:

try:
    return parse_quiz(text)
except ValidationError as error:
    retry = retry_request(body, text, error)

Die Zeile, die retry sendet, steht hinter der try-Anweisung, also fängt nichts ab, was sie auslöst.

Baue format_quiz

format_quiz(quiz) nimmt ein QuizSet entgegen und gibt das Quiz als einen String zurück, ohne Zeilenumbruch am Ende:

  • Nummeriere die Fragen ab 1 mit einem Zähler: Setze number = 0 vor der Schleife über quiz.questions und addiere am Anfang jedes Durchlaufs 1.

  • Für jede Frage eine Zeile f"{number}. {question.question}", dann eine Zeile pro Auswahlmöglichkeit, f" {letter}) {choice}", um drei Leerzeichen eingerückt. Die Buchstaben kommen nach Position aus "abcdefgh": Die erste Auswahlmöglichkeit bekommt a, die zweite b und so weiter.

  • Eine Leerzeile zwischen den Fragen.

  • Nach der letzten Frage eine Leerzeile, dann Answers: , gefolgt von einem Eintrag pro Frage, der Nummer und dem Buchstaben ihrer richtigen Auswahlmöglichkeit, etwa 1c, verbunden mit ", ".

Ein bequemer Weg zu den Buchstaben ist, "abcdefgh" auf die Anzahl der Auswahlmöglichkeiten zu kürzen, letters = "abcdefgh"[: len(question.choices)]. Dann ist letters[0] a und letters[question.answer_index] der richtige Buchstabe. Ein answer_index hinter der letzten Auswahlmöglichkeit löst dann einen IndexError aus, wie correct_choice in Lektion 4. Fang ihn nicht ab: Eine kaputte Frage soll nicht mit einer erfundenen Lösung ausgegeben werden.

Wenn du die Zeilen jeder Frage in einer Liste sammelst und mit "\n" verbindest und dann die Fragen mit "\n\n" verbindest, bekommst du die Leerzeilen, ohne sie zu zählen.

Ausführen

Führe python structured.py aus. Die Demonstration macht ein Quiz aus notes/03-lists.md und gibt es aus. Danach ruft sie make_quiz("give me broken json") auf. note_message setzt diesen Text zwischen die Notiz-Tags, und das geskriptete Modell beantwortet genau diesen Prompt beim ersten Mal absichtlich falsch, dein make_quiz muss also erneut fragen, bevor es ein gültiges Quiz bekommt:

The quiz for notes/03-lists.md:
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

3. Which line makes an independent copy of scores?
   a) backup = scores.copy()
   b) backup = scores
   c) backup = scores.append(0)

Answers: 1c, 2b, 3a
A quiz whose first reply is invalid:
1. What does len() return?
   a) The number of items
   b) The last item
   c) The first item

Answers: 1a

Das zweite Quiz erscheint nur, wenn der erneute Versuch funktioniert hat; ohne ihn würde der ValidationError der ersten Antwort den Lauf mit einem Traceback beenden. Die anderen Fälle kann die Demonstration dir nicht zeigen, denk sie also durch, bevor du deine Arbeit prüfst: Eine gültige erste Antwort braucht genau eine Anfrage; eine zweite ungültige Antwort muss einen Fehler auslösen und darf nicht noch einmal versucht werden; eine gescheiterte Anfrage darf überhaupt nicht erneut versucht werden. Die Prüfung deiner Arbeit probiert jeden dieser Fälle mit einer Fake-Session aus, zusammen mit Quizzen aus einer Frage und mit vier Auswahlmöglichkeiten. Wenn du nicht weiterkommst, frag Monty nach jeweils einem Fall.

Wie es weitergeht

make_quiz und format_quiz machen aus jeder Notiz ein geprüftes, druckbares Quiz, und die ganze Arbeit ist von Hand erledigt: der Anfrage-Body, der JSON-Modus, das Schema im Prompt, die Validierung und der erneute Versuch. Kapitel 5 verlagert das auf den openai-Client, dessen Parse-Hilfsfunktion ein strenges, aus QuizSet gebautes Schema sendet und die Antwort für dich validiert. Weil du jeden Schritt selbst gebaut hast, weißt du, was er tut.

In make_quiz scheitert die erste Anfrage mit einem 500 vom Dienst. Was soll passieren?

Eine Frage hat vier Auswahlmöglichkeiten und answer_index 3. Welchen Eintrag bekommt sie in der Lösungszeile, wenn sie Frage 2 ist?

Aufgabe

Ersetze in structured.py die unfertigen Rümpfe von make_quiz(note_text, *, session=None) und format_quiz(quiz).

make_quiz:

  • body = quiz_request(note_text), dann text = answer_text(send_body(body, session=session)).

  • Gib parse_quiz(text) zurück. Wenn das einen ValidationError auslöst, sende retry_request(body, text, error) einmal mit derselben Session und gib parse_quiz des Antworttexts zurück.

  • Ein zweiter ValidationError und jeder Fehler aus send_body kommen beim Aufrufer an.

format_quiz gibt einen String zurück, ohne Zeilenumbruch am Ende:

  • für jede Frage, nummeriert ab 1: f"{number}. {question.question}", wobei question ein Element von quiz.questions ist, dann eine Zeile pro Auswahlmöglichkeit, f" {letter}) {choice}" (drei Leerzeichen), mit den Buchstaben a, b, c und so weiter, nach Position aus "abcdefgh" genommen;

  • eine Leerzeile zwischen den Fragen;

  • dann eine Leerzeile und Answers: , gefolgt von der Nummer und dem richtigen Buchstaben jeder Frage, etwa 1c, verbunden mit ", ".

Führe python structured.py aus, um zwei Quizze zu sehen, das zweite nach einem erneuten Versuch, und prüfe dann deine Arbeit.