0%

Abschlussprojekt · Abschlussprojekt

Abschlussprojekt: Abschlussprojekt: Der Lernassistent

Jede Etappe von study_assistant.py wurde für sich geprüft, wobei die Versionen der Prüfung für die anderen Etappen an die Stelle deiner eigenen getreten sind. Diese Lektion prüft das Programm als Ganzes, so wie ein Mensch ihm begegnet, ohne etwas zu ersetzen. Es gibt keine neue Funktion zu schreiben. Wenn jede frühere Lektion bestanden wurde, sollte das Programm schon bestehen; hier stellst du das sicher und behebst, was erst im Zusammenspiel sichtbar wird.

Die Checkliste

Arbeite sie in der Shell ab. Jeder Punkt gehört zur Aufgabe aus Lektion 1.

  1. ask. Führe python study_assistant.py ask "How do I make an independent copy of a list?" aus. Du solltest die Antwort sehen, eine Leerzeile und Sources: 03-lists#4. Probiere dann What is the capital of France?, das Sources: none ausgibt, und Why should a default argument never be a list?, das 05-functions#5 zitiert.

  2. quiz. Führe python study_assistant.py quiz 03-lists aus, dann mit --count 1 und --count 5. Das geskriptete Modell hat für jede Anzahl bei 03-lists ein Quiz bereit. Jede andere Notiz bekommt vom geskripteten Modell dieselben Fragen zu Listen; das liegt am Modell, nicht an deinem Code.

  3. chat. Führe python study_assistant.py chat aus, tippe What does len() return?, drück Enter, lies die Antwort und beende mit einer leeren Zeile.

  4. Jeder Exit-Code. Führe python stages.py aus: Der Block von Lektion 6 lässt das Programm mit jedem Code enden, unter den geskripteten Fehlern tool-loop, broken-stream und rate-limit:2. Probiere dann ein zu kleines Budget und eine fehlende Notiz aus, jeweils mit echo $? danach:

    $ python study_assistant.py --budget 500 ask "How do I make an independent copy of a list?"
    Error: The budget ran out before agent step 1.
    $ echo $?
    3
    
  5. Usage. python study_assistant.py --help und python study_assistant.py quiz --help zeigen die Befehle und Optionen. python study_assistant.py quiz 03-lists --count 9 ist ein Bedienungsfehler, Code 2.

  6. Die Tests. Führe python -m pytest -q aus. Die Tests aus Kapitel 10 bestehen weiterhin, weil das Abschlussprojekt dieselben Module importiert, die sie testen, und keines davon ändert:

    $ python -m pytest -q
    ...........................                                              [100%]
    27 passed in 0.79s
    

    Die Zeit wird ein wenig abweichen.

Jede andere Frage, die du in ask eintippst, bekommt das Echo des geskripteten Modells, das kein JSON ist. ask fragt also noch einmal, bekommt wieder das Echo und endet mit Exit-Code 1. So funktioniert das Programm richtig: Das geskriptete Modell kennt nur die drei Fragen in SCRIPTED_MODEL.md. Ein Live-Modell, das Kapitel 12 anbindet, beantwortet alles.

Was die Prüfung hinzufügt

Die Prüfung deiner Arbeit führt jede Regel aus den Lektionen 2 bis 6 erneut aus, mit drei Unterschieden:

  • Durchgehend werden deine eigenen Funktionen verwendet. Ersetzt wird nur, womit die Datei angefangen hat: die Importe, die Konstanten oben und die fünf vorgegebenen Funktionen, die aus der eigenen Kopie der Prüfung stammen.

  • Die Notizen und Fragen sind neu für dich: ein temporärer Notizordner mit Notizen über Sets, Tupel und Ranges, der main als notes_dir übergeben wird, und Fragen, die dein Code nie gesehen hat.

  • Fehler werden in einem Lauf kombiniert, so wie sie bei einem echten Dienst auftreten: ein Ratenlimit mitten in einem Agentenschritt; eine ungültige Antwort, deren korrigierender erneuter Versuch nicht ins Budget passt, was mit Exit-Code 3 endet; ein Quiz, dessen erste Antwort ungültig ist, angefordert mit --count 2; und ein Chat, dessen erste Anfrage scheitert, bevor Text ankommt, und der erneut versucht werden und seine Antwort genau einmal ausgeben muss.

Wenn eine Prüfung fehlschlägt, nennt ihre Meldung den Befehl oder die Funktion und die Regel aus der Aufgabe, die nicht eingehalten wurde, mit einem nächsten Schritt.

Ausführen

Führe python stages.py für alle Blöcke von Lektion 2 bis Lektion 8 aus und prüfe dann deine Arbeit.

Du stellst dem Lernassistenten eine Frage, die nicht in SCRIPTED_MODEL.md steht, und er endet mit Exit-Code 1. Was sagt dir das?

In einer kombinierten Prüfung ist die erste Antwort von ask ungültig, und ihr korrigierender erneuter Versuch passt nicht in das restliche Budget. Wie endet das Programm?

Aufgabe

Stelle study_assistant.py fertig, sodass das ganze Programm die Aufgabe aus Lektion 1 erfüllt, mit den exakten Meldungen und Ausgabeformaten aus den Lektionen 2 bis 6 und durchgehend mit deinen eigenen Funktionen. Arbeite die Checkliste in der Lektion ab: jeden Befehl einmal im , jeden Exit-Code einmal, chat getippt, --help und python -m pytest -q weiterhin grün. Prüfe dann deine Arbeit. Die Prüfung führt jede Regel aus den Lektionen 2 bis 6 erneut aus, mit Notizen und Fragen, die du nicht gesehen hast, und zusätzlich mit Fehlern, die in einem Lauf kombiniert sind.