0%

Eindproject · eindproject

Eindproject: Eindproject: de studieassistent

Elke stap van study_assistant.py is afzonderlijk gecontroleerd, waarbij de versies van de controle de andere stappen vervingen. Deze les controleert het programma als geheel, zoals een gebruiker het tegenkomt, zonder dat er iets vervangen wordt. Er is geen nieuwe functie om te schrijven. Als alle eerdere lessen geslaagd zijn, zou het programma al moeten slagen; hier zorg je dat dat zeker is, en verhelp je wat de combinatie aan het licht brengt.

De checklist

Werk hem af in de Shell. Elk punt is een deel van de opdracht uit les 1.

  1. ask. Voer python study_assistant.py ask "How do I make an independent copy of a list?" uit. Je zou het antwoord moeten zien, een lege regel en Sources: 03-lists#4. Probeer daarna What is the capital of France?, dat Sources: none afdrukt, en Why should a default argument never be a list?, dat 05-functions#5 vermeldt.

  2. quiz. Voer python study_assistant.py quiz 03-lists uit, en daarna met --count 1 en --count 5. Het gescripte model heeft voor elk aantal van 03-lists een quiz klaar. Elke andere notitie krijgt van het gescripte model dezelfde vragen over lijsten; dat ligt aan het model, niet aan je code.

  3. chat. Voer python study_assistant.py chat uit, typ What does len() return?, druk op Enter, lees het antwoord en eindig met een lege regel.

  4. Elke exitcode. Voer python stages.py uit: het blok van les 6 laat het programma met elke code eindigen, onder de gescripte fouten tool-loop, broken-stream en rate-limit:2. Probeer daarna een te klein budget en een ontbrekende notitie, met echo $? na elk:

    $ 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. Gebruik. python study_assistant.py --help en python study_assistant.py quiz --help tonen de commando’s en opties. python study_assistant.py quiz 03-lists --count 9 is een gebruiksfout, code 2.

  6. De tests. Voer python -m pytest -q uit. De tests uit hoofdstuk 10 slagen nog steeds, omdat het eindproject dezelfde modules importeert die zij testen en daar niets aan verandert:

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

    De tijd zal iets verschillen.

Elke andere vraag die je aan ask stelt, krijgt de echo van het gescripte model, en die is geen JSON, dus ask vraagt nog één keer, krijgt weer de echo en eindigt met exitcode 1. Zo hoort het programma te werken: het gescripte model kent alleen de drie vragen in SCRIPTED_MODEL.md. Een live model, dat in hoofdstuk 12 wordt aangesloten, beantwoordt alles.

Wat de controle toevoegt

De controle van je werk voert elke regel uit les 2 tot en met 6 opnieuw uit, met drie verschillen:

  • Overal worden je eigen functies gebruikt. Niets wordt vervangen behalve waarmee het bestand begon: de imports, de constanten bovenaan en de vijf meegeleverde functies, die uit de eigen kopie van de controle komen.

  • De notities en vragen zijn nieuw voor je: een tijdelijke notitiemap met notities over sets, tuples en ranges, aan main meegegeven als notes_dir, en vragen die je code nog nooit heeft gezien.

  • Fouten worden in één run gecombineerd, zoals dat bij een echte dienst gebeurt: een rate limit midden in een agentstap; een ongeldig antwoord waarvan de corrigerende nieuwe poging niet in het budget past, wat eindigt met exitcode 3; een quiz waarvan het eerste antwoord ongeldig is, gevraagd met --count 2; en een chat waarvan het eerste request mislukt voordat er tekst binnenkomt, die opnieuw geprobeerd moet worden en het antwoord één keer moet afdrukken.

Als een controle faalt, noemt de melding het commando of de functie en de regel uit de opdracht die niet klopte, met één volgende stap.

Voer het uit

Voer python stages.py uit voor elk blok van les 2 tot en met les 8, en controleer daarna je werk.

Je stelt de studieassistent een vraag die niet in SCRIPTED_MODEL.md staat, en hij eindigt met exitcode 1. Wat zegt dat je?

In een gecombineerde controle is het eerste antwoord van ask ongeldig en past de corrigerende nieuwe poging niet in wat er van het budget over is. Hoe eindigt het programma?

Opdracht

Maak study_assistant.py af zodat het hele programma voldoet aan de opdracht uit les 1, met de exacte meldingen en uitvoerformaten van les 2 tot en met 6, en overal met je eigen functies. Werk de checklist in de les af: elk commando één keer in de , elke exitcode één keer, chat getypt, --help, en python -m pytest -q nog steeds groen. Controleer daarna je werk. De controle voert elke regel van les 2 tot en met 6 opnieuw uit op notities en vragen die je niet hebt gezien, plus fouten die in één run gecombineerd zijn.