feat: uitlegvideo bij elke handleiding (schermafbeeldingen, Nederlandse stem, ondertitels)

- video-script.md, video-*.mp4 en .srt in de acht mappen - README-sectie Video's en CHANGELOG Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-21 17:31:45 +02:00
parent 9c6a9c9a49
commit f134e29625
26 changed files with 5008 additions and 0 deletions
@@ -0,0 +1,468 @@
+1
+00:00:00,000 --> 00:00:05,155
+Welkom bij de vierde handleiding van de reeks AI Agents met Dify voor school.
+
+2
+00:00:05,205 --> 00:00:07,116
+Je bouwt de Toetsweekplanner:
+
+3
+00:00:07,166 --> 00:00:11,848
+een agent die met een leerling een studieplan voor de toetsweek maakt.
+
+4
+00:00:11,898 --> 00:00:22,529
+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:
+
+5
+00:00:22,579 --> 00:00:26,450
+een Excel-overzicht en een agendabestand voor de telefoon.
+
+6
+00:00:26,500 --> 00:00:30,236
+Dit is een ander soort bouwen dan in handleiding 1 en 3.
+
+7
+00:00:30,286 --> 00:00:33,210
+Daar zette je zelf de stappen achter elkaar.
+
+8
+00:00:33,260 --> 00:00:46,848
+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.
+
+9
+00:00:47,648 --> 00:00:49,109
+Vier dingen vooraf.
+
+10
+00:00:49,159 --> 00:00:58,491
+De Agent Console staat in het linkermenu onder Agents met het label bèta; schermen veranderen hier sneller dan elders.
+
+11
+00:00:58,541 --> 00:01:00,320
+Niet elk model kan het:
+
+12
+00:01:00,370 --> 00:01:06,760
+gpt-5 staat als Incompatibel, wij gebruiken gpt-5.4 via een eigen OpenAI-sleutel.
+
+13
+00:01:06,810 --> 00:01:10,099
+Een agent doet meer werk dan een workflow:
+
+14
+00:01:10,149 --> 00:01:17,891
+één compleet gesprek kostte in onze test zo'n tien cent, en op sandbox-credits tientallen credits.
+
+15
+00:01:17,941 --> 00:01:18,130
+En:
+
+16
+00:01:18,180 --> 00:01:25,256
+dit is een prototype met fictieve gegevens; echte leerlingen chatten niet met Dify-cloud.
+
+17
+00:01:26,056 --> 00:01:31,640
+Klik in het linkermenu op Agents, dan op Create en Create from Blank.
+
+18
+00:01:31,690 --> 00:01:32,212
+Vul in:
+
+19
+00:01:32,262 --> 00:01:39,397
+naam Toetsweekplanner, rol Studieplanner voor leerlingen onderbouw, en een beschrijving.
+
+20
+00:01:39,447 --> 00:01:40,672
+Klik op Create.
+
+21
+00:01:41,472 --> 00:01:43,467
+Je komt op Configureren.
+
+22
+00:01:43,517 --> 00:01:46,280
+Links het formulier van de agent:
+
+23
+00:01:46,330 --> 00:01:49,688
+model, prompt, skills, bestanden, tools.
+
+24
+00:01:49,738 --> 00:01:55,057
+Rechts een chatvenster met twee tabbladen, Bouwen en Voorbeeld.
+
+25
+00:01:55,107 --> 00:01:56,165
+Rechts staat:
+
+26
+00:01:56,215 --> 00:01:58,125
+bouw je agent via chat.
+
+27
+00:01:58,175 --> 00:02:06,477
+Dat werkt, maar het kost credits per bericht en je weet minder goed wat er in je instructie staat.
+
+28
+00:02:06,527 --> 00:02:11,640
+We vullen het formulier zelf in; dat is preciezer en gratis.
+
+29
+00:02:12,440 --> 00:02:17,131
+Bovenaan staat gpt-5 met een oranje label Incompatibel.
+
+30
+00:02:17,181 --> 00:02:24,459
+Klik op het modelveld, typ gpt-5.4 in het zoekveld en kies gpt-5.4 zonder toevoeging.
+
+31
+00:02:24,509 --> 00:02:26,183
+Het label verdwijnt.
+
+32
+00:02:26,233 --> 00:02:31,787
+Typ je mini in het zoekveld, dan krijg je alleen Gemini-modellen:
+
+33
+00:02:31,837 --> 00:02:36,528
+gpt-5-mini uit de andere handleidingen is er hier niet.
+
+34
+00:02:36,578 --> 00:02:44,768
+Gemini werkt ook en is goedkoper; voor de SOML-omgeving is dat zelfs de enige toegestane route.
+
+35
+00:02:45,568 --> 00:02:48,561
+Plak de instructie in het veld Prompt.
+
+36
+00:02:48,611 --> 00:02:52,244
+Vier delen, en die volgorde is niet toevallig.
+
+37
+00:02:52,294 --> 00:02:53,205
+Wie je bent:
+
+38
+00:02:53,255 --> 00:02:56,649
+de Toetsweekplanner, je-vorm, korte zinnen.
+
+39
+00:02:56,699 --> 00:02:58,090
+Wat je nodig hebt:
+
+40
+00:02:58,140 --> 00:03:07,779
+het rooster uit het bestand, de leermomenten, en per vak makkelijk, gemiddeld of moeilijk; stel deze vragen een voor een.
+
+41
+00:03:07,829 --> 00:03:08,900
+De planregels:
+
+42
+00:03:08,950 --> 00:03:22,513
+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.
+
+43
+00:03:22,563 --> 00:03:24,034
+En wat je oplevert:
+
+44
+00:03:24,084 --> 00:03:33,003
+een overzicht per dag in de chat, en twee bestanden uit de sandbox, studieplan punt xlsx en studieplan punt ics.
+
+45
+00:03:33,053 --> 00:03:35,725
+De laatste alinea zijn de grenzen:
+
+46
+00:03:35,775 --> 00:03:39,008
+geen cijfers, oordelen of voorspellingen.
+
+47
+00:03:39,058 --> 00:03:44,374
+De zin stel deze vragen een voor een is belangrijker dan hij lijkt.
+
+48
+00:03:44,424 --> 00:03:50,780
+Zonder die zin vuurt de agent alle vragen tegelijk af, en haakt een leerling af.
+
+49
+00:03:50,830 --> 00:03:53,392
+Het formulier slaat zichzelf op.
+
+50
+00:03:54,192 --> 00:03:55,677
+Scroll naar beneden:
+
+51
+00:03:55,727 --> 00:03:59,437
+Skills, Bestanden en Tools, elk met een knop Add.
+
+52
+00:03:59,487 --> 00:04:04,655
+Klik bij Bestanden op Add en upload toetsrooster voorbeeld punt csv:
+
+53
+00:04:04,705 --> 00:04:10,793
+zes toetsen van maandag 12 tot en met vrijdag 16 oktober, met per toets de stof.
+
+54
+00:04:10,843 --> 00:04:15,628
+Bestanden in dit vak staan voor de agent klaar in zijn sandbox.
+
+55
+00:04:15,678 --> 00:04:22,200
+Hij leest ze zelf als hij ze nodig heeft; in de instructie verwijs je er alleen naar.
+
+56
+00:04:23,000 --> 00:04:29,139
+De agent moet weten welke dag het vandaag is om vanaf vandaag te kunnen plannen.
+
+57
+00:04:29,189 --> 00:04:34,090
+Een taalmodel weet dat niet uit zichzelf; daar is een tool voor.
+
+58
+00:04:34,140 --> 00:04:39,659
+Klik bij Tools op Add, kies CurrentTime uit de lijst en klik op Add all.
+
+59
+00:04:39,709 --> 00:04:41,593
+Meer tools is niet beter.
+
+60
+00:04:41,643 --> 00:04:45,384
+Elke tool kost een stukje aandacht van het model.
+
+61
+00:04:45,434 --> 00:04:48,091
+Voor de planner is één tool genoeg.
+
+62
+00:04:48,141 --> 00:04:56,264
+Skills laat je leeg; dat zijn herbruikbare werkinstructies als zipbestand, en die heb je hier niet nodig.
+
+63
+00:04:57,064 --> 00:04:59,927
+Klik rechtsboven op Voorbeeld en typ:
+
+64
+00:04:59,977 --> 00:05:03,470
+hoi, ik wil een studieplan voor de toetsweek.
+
+65
+00:05:03,520 --> 00:05:10,162
+De agent leest het rooster uit het bestand, vat het samen en stelt zijn eerste vraag.
+
+66
+00:05:10,212 --> 00:05:12,131
+Boven het antwoord staat:
+
+67
+00:05:12,181 --> 00:05:14,464
+aan het nadenken, 8 seconden.
+
+68
+00:05:15,264 --> 00:05:17,095
+Geef de leermomenten op:
+
+69
+00:05:17,145 --> 00:05:25,640
+van woensdag 7 tot en met donderdag 15 oktober elke dag van vier tot zes, zaterdag niet, zondag twee blokken.
+
+70
+00:05:25,690 --> 00:05:30,578
+De agent herhaalt ze per dag en vraagt hoe moeilijk elk vak is.
+
+71
+00:05:30,628 --> 00:05:31,284
+Antwoord:
+
+72
+00:05:31,334 --> 00:05:40,584
+Nederlands makkelijk, wiskunde moeilijk, Engels makkelijk, geschiedenis gemiddeld, biologie gemiddeld, Frans moeilijk.
+
+73
+00:05:41,384 --> 00:05:45,795
+Nu gaat de agent aan het werk; dat duurt een halve minuut.
+
+74
+00:05:45,845 --> 00:05:55,332
+Het plan verschijnt per dag, en onderaan staan twee blauwe links, studieplan punt xlsx en studieplan punt ics, met de vraag:
+
+75
+00:05:55,382 --> 00:05:57,536
+wil je nog iets verschuiven?
+
+76
+00:05:58,336 --> 00:06:01,544
+Klik boven het antwoord op Aan het nadenken.
+
+77
+00:06:01,594 --> 00:06:05,173
+Er klappen twee regels Opdrachten uitgevoerd uit:
+
+78
+00:06:05,223 --> 00:06:09,172
+de momenten waarop de agent iets in zijn sandbox deed.
+
+79
+00:06:09,222 --> 00:06:10,505
+Klik op de eerste.
+
+80
+00:06:10,555 --> 00:06:22,502
+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.
+
+81
+00:06:22,552 --> 00:06:25,242
+Dit is het verschil met een workflow.
+
+82
+00:06:25,292 --> 00:06:27,019
+Jij hebt nergens gezegd:
+
+83
+00:06:27,069 --> 00:06:28,649
+schrijf een programma.
+
+84
+00:06:28,699 --> 00:06:40,497
+De agent heeft zelf bedacht dat een Excel-bestand maken het handigst gaat met een programmaatje, heeft dat geschreven, uitgevoerd, en de bestanden teruggegeven.
+
+85
+00:06:40,547 --> 00:06:43,682
+Gaat het mis, dan probeert hij het opnieuw.
+
+86
+00:06:43,732 --> 00:06:46,768
+Daarom kost hij meer en duurt hij langer.
+
+87
+00:06:47,568 --> 00:06:48,478
+Nog een vraag:
+
+88
+00:06:48,528 --> 00:06:57,668
+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?
+
+89
+00:06:57,718 --> 00:06:59,726
+De agent doet het niet zomaar.
+
+90
+00:06:59,776 --> 00:07:10,562
+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.
+
+91
+00:07:10,612 --> 00:07:14,197
+Hij stelt een alternatief voor en vraagt wat je wilt.
+
+92
+00:07:14,247 --> 00:07:18,861
+Wil je dat de leerling altijd het laatste woord heeft, voeg dan toe:
+
+93
+00:07:18,911 --> 00:07:24,192
+leg één keer uit waarom de regel er is, en doe daarna wat de leerling vraagt.
+
+94
+00:07:24,992 --> 00:07:28,676
+Klik onderaan het linkerpaneel op Update publiceren.
+
+95
+00:07:28,726 --> 00:07:32,122
+De knop wordt grijs met het vinkje Gepubliceerd.
+
+96
+00:07:32,172 --> 00:07:42,368
+Wijzig je later de instructie, dan verandert de webapp pas als je hier opnieuw op klikt; tot die tijd staat er Niet-gepubliceerde wijzigingen.
+
+97
+00:07:43,168 --> 00:07:46,935
+Klik in het linkermenu op Toegangspunt en open de webapp:
+
+98
+00:07:46,985 --> 00:07:51,957
+een leeg chatvenster met de naam van de agent, zoals een leerling hem ziet.
+
+99
+00:07:52,007 --> 00:07:56,560
+Typ een bericht om te controleren dat de gepubliceerde versie werkt.
+
+100
+00:07:57,360 --> 00:07:58,341
+Klik op Logs.
+
+101
+00:07:58,391 --> 00:08:03,577
+Elk gesprek via de webapp staat hier, met de eerste zin als titel.
+
+102
+00:08:03,627 --> 00:08:06,274
+Onder Monitoring staan de tellers:
+
+103
+00:08:06,324 --> 00:08:10,161
+berichten, gebruikers, gemiddelde gesprekslengte.
+
+104
+00:08:10,211 --> 00:08:10,716
+Let op:
+
+105
+00:08:10,766 --> 00:08:17,776
+gesprekken uit het tabblad Voorbeeld staan niet in Logs, alleen gesprekken via de webapp.
+
+106
+00:08:17,826 --> 00:08:22,824
+Wil je een testgesprek terugzien, doe de test dan in de webapp.
+
+107
+00:08:23,624 --> 00:08:24,989
+De controlelijst:
+
+108
+00:08:25,039 --> 00:08:26,737
+staat het model goed?
+
+109
+00:08:26,787 --> 00:08:29,400
+Leest de agent het rooster zelf?
+
+110
+00:08:29,450 --> 00:08:31,398
+Vraagt hij een voor een?
+
+111
+00:08:31,448 --> 00:08:37,224
+Komen er twee bestanden en staat er een script onder Aan het nadenken?
+
+112
+00:08:37,274 --> 00:08:41,386
+Spreekt hij tegen bij een verzoek tegen de regels?
+
+113
+00:08:41,436 --> 00:08:44,432
+En staat het webapp-gesprek in Logs?
+
+114
+00:08:45,232 --> 00:08:53,604
+De handleiding, het rooster en de beelden staan in de repository; de agent staat live op udify punt app.
+
+115
+00:08:53,654 --> 00:08:57,735
+In de volgende video bouwen we de Transcriptietool:
+
+116
+00:08:57,785 --> 00:09:00,326
+van een opname naar een verslag.
+
+117
+00:09:00,376 --> 00:09:01,024
+Tot dan.
+