Strukturierte Ausgabe · Übung
Ein Pydantic-Modell schreiben
QuizQuestion beschreibt eine Frage. Eine Antwort enthält ein ganzes Quiz: ein Objekt mit einer Liste questions, wie QUIZ_SYSTEM verlangt. In dieser Lektion schreibst du das Modell für dieses Objekt, QuizSet, in derselben Form, die du in Lektion 4 gelesen hast.
Schreibe QuizSet
In quiz_models.py steht unter QuizQuestion der Platzhalter:
# Lesson 5: replace the next line with your QuizSet model.
QuizSet = None
Ersetze beide Zeilen durch ein Modell. Kopiere die Klassenzeile von QuizQuestion, ändere den Namen und gib dem Modell ein Feld, questions, dessen Hint eine Liste von QuizQuestion ist:
class QuizSet(BaseModel):
questions: list[QuizQuestion]
list[QuizQuestion] verwendet ein Modell in einem anderen: Ein QuizSet enthält eine Liste, und jedes Element dieser Liste ist eine QuizQuestion. Setze QuizSet hinter QuizQuestion, damit ein Leser QuizQuestion vor dem Modell kennenlernt, das es verwendet. In Python-Versionen vor 3.14 ist diese Reihenfolge Pflicht: Der Hint wird ausgewertet, wenn die Klassenzeile läuft, und QuizQuestion muss dann schon existieren.
Gib dem Feld keinen Standardwert. Ohne Standardwert ist das Feld Pflicht, eine Antwort ganz ohne questions ist also kein gültiges Quiz.
Verschachtelte Dictionaries werden zu Modellen
Hier ist die ganze Datei, wie sie aussehen wird, gefolgt von einem Quiz, das aus einfachen Dictionaries gebaut wird:
from pydantic import BaseModel
class QuizQuestion(BaseModel):
question: str
choices: list[str]
answer_index: int
class QuizSet(BaseModel):
questions: list[QuizQuestion]
quiz = QuizSet(
questions=[
{"question": "What does len([]) return?", "choices": ["0", "None"], "answer_index": 0},
{"question": "Which brackets make a list?", "choices": ["()", "[]", "{}"], "answer_index": 1, "hint": "square"},
]
)
print(type(quiz.questions[1]).__name__)
print(quiz.questions[1].choices)
print(quiz.questions[1].model_dump())
QuizQuestion
['()', '[]', '{}']
{'question': 'Which brackets make a list?', 'choices': ['()', '[]', '{}'], 'answer_index': 1}
Du hast Dictionaries übergeben, und QuizSet hat jedes davon in eine QuizQuestion umgewandelt, weil der Hint des Feldes sagt, dass die Elemente genau das sind. Deshalb liest sich quiz.questions[1].choices durchgehend mit Punkten. type(...).__name__ gibt den Namen des Typs eines Werts aus, hier QuizQuestion, nicht dict.
Sieh dir das zweite Dictionary an: Es hat einen Schlüssel, den das Modell nicht deklariert, "hint". Standardmäßig ignoriert Pydantic Schlüssel, die es nicht kennt, deshalb zeigt model_dump() nur die drei Felder. Eine Antwort des Sprachmodells kann zusätzliche Schlüssel enthalten, und dein Programm bekommt sie nie zu sehen.
Wenn ein Element keine QuizQuestion werden kann, zum Beispiel weil sein answer_index "first" ist, scheitert das Erstellen des QuizSet mit einem Fehler, der das Problem benennt. Um diesen Fehler geht es in Lektion 6.
Ausführen
Führe python structured.py aus. Die Demonstration baut ein QuizSet aus zwei Dictionaries, gibt es aus und gibt den Typ seiner zweiten Frage aus:
A QuizSet built from dictionaries:
QuizSet(questions=[QuizQuestion(question='What does len([]) return?', choices=['0', 'None'], answer_index=0), QuizQuestion(question='Which brackets make a list?', choices=['()', '[]', '{}'], answer_index=1)])
quiz.questions[1] is a QuizQuestion
The JSON reply, validated by parse_quiz:
Run stopped at the next function to build: parse_quiz is built in Lesson 6.
QuizSet ist die Form, um die es im ganzen Kapitel geht. Die Antwort, die das Sprachmodell sendet, ist JSON-Text, und Lektion 6 macht aus diesem Text in einem Schritt ein QuizSet oder sagt dir genau, warum das nicht geht.
QuizSet hat das Feld questions: list[QuizQuestion]. Du erstellst QuizSet(questions=[{"question": "Q?", "choices": ["a", "b"], "answer_index": 0}]). Was ist quiz.questions[0]?
Eine Frage in einer Antwort hat einen zusätzlichen Schlüssel, "difficulty": "easy", den QuizQuestion nicht deklariert. Was macht Pydantic standardmäßig damit?
Aufgabe
Ersetze in quiz_models.py die Zeile QuizSet = None durch ein Pydantic-Modell namens QuizSet:
schreibe seine Klassenzeile so wie die von
QuizQuestion, mit(BaseModel);gib ihm genau ein Feld,
questions, dessen Hint eine Liste vonQuizQuestionist.
Lass QuizQuestion unverändert und gib dem Feld keinen Standardwert. Führe python structured.py aus, um ein aus Dictionaries gebautes QuizSet zu sehen, und prüfe dann deine Arbeit.