Files
Guido van Dijk f134e29625 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

469 lines
11 KiB
Plaintext

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.