dify-handleidingen/04-agent-console/video-script.md

titel: De Toetsweekplanner

ondertitel: Handleiding 4 · bouwen in de Agent Console: bestand, tool en sandbox

stem: nl-NL-FennaNeural

tempo: -5%

uitvoer: video-toetsweekplanner

reeks: Reeks AI Agents met Dify voor school

bron: git.lexconsultancy.nl/guido/dify-handleidingen

[titel] Welkom bij de vierde handleiding van de reeks AI Agents met Dify voor school. Je bouwt de Toetsweekplanner: een agent die met een leerling een studieplan voor de toetsweek maakt. Hij leest het rooster uit een bestand, vraagt wanneer de leerling kan leren en hoe moeilijk de vakken zijn, en levert een plan in de chat plus twee bestanden: een Excel-overzicht en een agendabestand voor de telefoon.

Dit is een ander soort bouwen dan in handleiding 1 en 3. Daar zette je zelf de stappen achter elkaar. In de Agent Console geef je alleen een instructie, bestanden en tools; de agent bepaalt zelf hoe hij de vraag aanpakt, schrijft zo nodig een programmaatje en maakt bestanden in een eigen Linux-sandbox.

[kaart: Lees dit eerst | De Agent Console is bèta: schermen en gedrag veranderen sneller dan de rest van Dify | Een model dat het aankan: gpt-5 staat als Incompatibel, wij gebruiken gpt-5.4 via een eigen sleutel | Een gesprek kost ongeveer 45.000 tokens, zo'n tien cent; op sandbox-credits is dat tientallen credits | Geen echte leerlingen in Dify-cloud; jij bent de leerling] Vier dingen vooraf. De Agent Console staat in het linkermenu onder Agents met het label bèta; schermen veranderen hier sneller dan elders. Niet elk model kan het: gpt-5 staat als Incompatibel, wij gebruiken gpt-5.4 via een eigen OpenAI-sleutel. Een agent doet meer werk dan een workflow: één compleet gesprek kostte in onze test zo'n tien cent, en op sandbox-credits tientallen credits. En: dit is een prototype met fictieve gegevens; echte leerlingen chatten niet met Dify-cloud.

[beeld: 04-agent-aanmaken-ingevuld.jpg | Stap 1. De agent aanmaken] Klik in het linkermenu op Agents, dan op Create en Create from Blank. Vul in: naam Toetsweekplanner, rol Studieplanner voor leerlingen onderbouw, en een beschrijving. Klik op Create.

[beeld: 05-configureren-nieuw.jpg | Stap 1. Het scherm Configureren] Je komt op Configureren. Links het formulier van de agent: model, prompt, skills, bestanden, tools. Rechts een chatvenster met twee tabbladen, Bouwen en Voorbeeld.

Rechts staat: bouw je agent via chat. Dat werkt, maar het kost credits per bericht en je weet minder goed wat er in je instructie staat. We vullen het formulier zelf in; dat is preciezer en gratis.

[beeld: 08-model-gekozen.jpg | Stap 2. Het model] Bovenaan staat gpt-5 met een oranje label Incompatibel. Klik op het modelveld, typ gpt-5.4 in het zoekveld en kies gpt-5.4 zonder toevoeging. Het label verdwijnt.

Typ je mini in het zoekveld, dan krijg je alleen Gemini-modellen: gpt-5-mini uit de andere handleidingen is er hier niet. Gemini werkt ook en is goedkoper; voor de SOML-omgeving is dat zelfs de enige toegestane route.

[beeld: 09-prompt-ingevuld.jpg | Stap 3. De instructie] Plak de instructie in het veld Prompt. Vier delen, en die volgorde is niet toevallig. Wie je bent: de Toetsweekplanner, je-vorm, korte zinnen. Wat je nodig hebt: het rooster uit het bestand, de leermomenten, en per vak makkelijk, gemiddeld of moeilijk; stel deze vragen een voor een.

De planregels: moeilijke vakken dubbel, elk vak minstens twee keer, blokken van 25 tot 45 minuten met pauze, de avond voor een toets alleen herhalen, niets buiten de opgegeven momenten. En wat je oplevert: een overzicht per dag in de chat, en twee bestanden uit de sandbox, studieplan punt xlsx en studieplan punt ics. De laatste alinea zijn de grenzen: geen cijfers, oordelen of voorspellingen.

De zin stel deze vragen een voor een is belangrijker dan hij lijkt. Zonder die zin vuurt de agent alle vragen tegelijk af, en haakt een leerling af. Het formulier slaat zichzelf op.

[beeld: 13-bestand-geupload.jpg | Stap 4. Het toetsrooster] Scroll naar beneden: Skills, Bestanden en Tools, elk met een knop Add. Klik bij Bestanden op Add en upload toetsrooster voorbeeld punt csv: zes toetsen van maandag 12 tot en met vrijdag 16 oktober, met per toets de stof.

Bestanden in dit vak staan voor de agent klaar in zijn sandbox. Hij leest ze zelf als hij ze nodig heeft; in de instructie verwijs je er alleen naar.

[beeld: 16-tool-toegevoegd.jpg | Stap 5. Een tool] De agent moet weten welke dag het vandaag is om vanaf vandaag te kunnen plannen. Een taalmodel weet dat niet uit zichzelf; daar is een tool voor. Klik bij Tools op Add, kies CurrentTime uit de lijst en klik op Add all.

Meer tools is niet beter. Elke tool kost een stukje aandacht van het model. Voor de planner is één tool genoeg. Skills laat je leeg; dat zijn herbruikbare werkinstructies als zipbestand, en die heb je hier niet nodig.

[beeld: 19-test-eerste-antwoord.jpg | Stap 6. Testen als leerling] Klik rechtsboven op Voorbeeld en typ: hoi, ik wil een studieplan voor de toetsweek. De agent leest het rooster uit het bestand, vat het samen en stelt zijn eerste vraag. Boven het antwoord staat: aan het nadenken, 8 seconden.

[beeld: 20-test-vakken-vraag.jpg | Stap 6. De leermomenten] Geef de leermomenten op: van woensdag 7 tot en met donderdag 15 oktober elke dag van vier tot zes, zaterdag niet, zondag twee blokken. De agent herhaalt ze per dag en vraagt hoe moeilijk elk vak is. Antwoord: Nederlands makkelijk, wiskunde moeilijk, Engels makkelijk, geschiedenis gemiddeld, biologie gemiddeld, Frans moeilijk.

[beeld: 22-test-plan-klaar.jpg | Stap 6. Het plan met twee bestanden] Nu gaat de agent aan het werk; dat duurt een halve minuut. Het plan verschijnt per dag, en onderaan staan twee blauwe links, studieplan punt xlsx en studieplan punt ics, met de vraag: wil je nog iets verschuiven?

[beeld: 24-opdracht-script.jpg | Stap 6. Wat de agent zelf deed] Klik boven het antwoord op Aan het nadenken. Er klappen twee regels Opdrachten uitgevoerd uit: de momenten waarop de agent iets in zijn sandbox deed. Klik op de eerste. Je ziet een Python-programma dat de agent zelf schreef, met daarin het rooster, de leermomenten en de regels, en dat het Excel-bestand en het agendabestand maakt.

Dit is het verschil met een workflow. Jij hebt nergens gezegd: schrijf een programma. De agent heeft zelf bedacht dat een Excel-bestand maken het handigst gaat met een programmaatje, heeft dat geschreven, uitgevoerd, en de bestanden teruggegeven. Gaat het mis, dan probeert hij het opnieuw. Daarom kost hij meer en duurt hij langer.

[beeld: 25-test-verschuiven.jpg | Stap 6. Houdt hij zich aan de regels?] Nog een vraag: op dinsdag, woensdag en donderdag heb ik van vier tot tien voor half vijf niks, kun je daar wiskunde en Frans nog een keer neerzetten?

De agent doet het niet zomaar. Hij wijst erop dat dinsdag de avond voor geschiedenis is en woensdag de avond voor biologie, en dat daar volgens de regels alleen herhaling van dat vak hoort. Hij stelt een alternatief voor en vraagt wat je wilt.

Wil je dat de leerling altijd het laatste woord heeft, voeg dan toe: leg één keer uit waarom de regel er is, en doe daarna wat de leerling vraagt.

[beeld: 26-gepubliceerd.jpg | Stap 7. Publiceren] Klik onderaan het linkerpaneel op Update publiceren. De knop wordt grijs met het vinkje Gepubliceerd. Wijzig je later de instructie, dan verandert de webapp pas als je hier opnieuw op klikt; tot die tijd staat er Niet-gepubliceerde wijzigingen.

[beeld: 29-webapp-gesprek.jpg | Stap 7. De webapp] Klik in het linkermenu op Toegangspunt en open de webapp: een leeg chatvenster met de naam van de agent, zoals een leerling hem ziet. Typ een bericht om te controleren dat de gepubliceerde versie werkt.

[beeld: 30-logs.jpg | Stap 8. Logs] Klik op Logs. Elk gesprek via de webapp staat hier, met de eerste zin als titel. Onder Monitoring staan de tellers: berichten, gebruikers, gemiddelde gesprekslengte.

Let op: gesprekken uit het tabblad Voorbeeld staan niet in Logs, alleen gesprekken via de webapp. Wil je een testgesprek terugzien, doe de test dan in de webapp.

[kaart: Controleren of het gelukt is | Het model staat op gpt-5.4 of Gemini, zonder het label Incompatibel | Het rooster staat onder Bestanden en de agent vat het samen zonder dat je het plakt | De agent stelt zijn vragen een voor een | Het plan komt met twee bestanden en onder Aan het nadenken staat een script | De agent spreekt tegen als een verzoek tegen de planregels ingaat | De webapp werkt en het gesprek staat in Logs] De controlelijst: staat het model goed? Leest de agent het rooster zelf? Vraagt hij een voor een? Komen er twee bestanden en staat er een script onder Aan het nadenken? Spreekt hij tegen bij een verzoek tegen de regels? En staat het webapp-gesprek in Logs?

[slot: Doel, bestanden en tools. De agent kiest de stappen.] De handleiding, het rooster en de beelden staan in de repository; de agent staat live op udify punt app. In de volgende video bouwen we de Transcriptietool: van een opname naar een verslag. Tot dan.