Files
dify-handleidingen/08-chatflow-studiecoach/video-studiecoach.srt
T
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

709 lines
16 KiB
Plaintext

1
00:00:00,000 --> 00:00:06,391
Welkom bij de achtste en laatste handleiding van de reeks AI Agents met Dify voor school.
2
00:00:06,441 --> 00:00:10,299
Tot nu toe ging het over de organisatie van de school.
3
00:00:10,349 --> 00:00:11,891
Deze gaat over de les.
4
00:00:11,941 --> 00:00:16,378
Je bouwt een Studiecoach biologie voor 3 havo, thema Ecologie:
5
00:00:16,428 --> 00:00:27,667
een chat waarmee een leerling de stof kan doorvragen, de planning kan checken en hulp kan vragen bij opdrachten, zonder dat de coach de antwoorden voorzegt.
6
00:00:27,717 --> 00:00:35,772
En als een leerling iets persoonlijks schrijft, gaat het bericht naar de docent, die antwoordt in dezelfde chat.
7
00:00:35,822 --> 00:00:37,704
Dat is een mens in de lus.
8
00:00:38,504 --> 00:00:41,553
Daarvoor gebruik je de appvorm Chatflow:
9
00:00:41,603 --> 00:00:45,737
het workflow-canvas dat je kent, maar dan als gesprek.
10
00:00:45,787 --> 00:00:47,519
Drie dingen zijn nieuw.
11
00:00:47,569 --> 00:00:52,555
De Question Classifier herkent wat voor vraag een leerling stelt.
12
00:00:52,605 --> 00:00:56,196
Memory zorgt dat de coach het gesprek onthoudt.
13
00:00:56,246 --> 00:01:03,246
En Human Input stopt de workflow, mailt de docent, en gaat verder met wat de docent invult.
14
00:01:03,296 --> 00:01:04,176
Vier routes:
15
00:01:04,226 --> 00:01:13,136
uitleg uit de lesbrief, een hint bij een opdracht, de planning uit de studiewijzer, en persoonlijk, naar de docent.
16
00:01:13,936 --> 00:01:16,968
Bij de handleiding zitten drie documenten:
17
00:01:17,018 --> 00:01:24,451
de lesbrief, de studiewijzer met de afspraken, en een echte open module van VO-content onder CC BY-SA.
18
00:01:24,501 --> 00:01:26,066
Die licentie betekent:
19
00:01:26,116 --> 00:01:33,476
je mag het gebruiken en bewerken, als je de bron noemt en je bewerking onder dezelfde licentie deelt.
20
00:01:33,526 --> 00:01:39,616
Vervang je dit door je eigen vak, let dan op met methodemateriaal van een uitgever.
21
00:01:40,416 --> 00:01:40,903
Deel A.
22
00:01:40,953 --> 00:01:47,889
Maak een kennisbank met de lesbrief en de studiewijzer, in de sandbox één bestand per keer.
23
00:01:47,939 --> 00:01:53,032
Zet de delimiter op twee keer backslash n en klik op Preview Chunk:
24
00:01:53,082 --> 00:02:01,093
de lesbrief valt uiteen in veertien stukken van ongeveer duizend tekens, elk een alinea met echte inhoud.
25
00:02:01,143 --> 00:02:02,448
Save and Process.
26
00:02:03,248 --> 00:02:04,197
Bij Settings:
27
00:02:04,247 --> 00:02:13,876
naam Biologie 3 havo ecologie, en een beschrijving die de begrippen uit de lesbrief en de afspraken uit de studiewijzer noemt.
28
00:02:13,926 --> 00:02:21,224
Maximaal 400 tekens; is hij langer, dan krijg je Modified unsuccessfully, zonder uitleg waarom.
29
00:02:22,024 --> 00:02:29,558
Voeg met Add file de Stercollectie-module toe, weer met de delimiter op twee keer backslash n.
30
00:02:29,608 --> 00:02:32,512
Drie documenten, allemaal Available.
31
00:02:33,312 --> 00:02:33,897
Deel B.
32
00:02:33,947 --> 00:02:38,433
Studio, Create, Create from Blank, kaart Chatflow.
33
00:02:38,483 --> 00:02:41,972
Dify zet alvast een standaardflow neer:
34
00:02:42,022 --> 00:02:44,149
User Input, LLM, Answer.
35
00:02:44,199 --> 00:02:50,137
Die twee blokken passen niet in ons plan; verwijder Answer en LLM.
36
00:02:50,187 --> 00:02:55,762
Alleen User Input blijft over, en de invoer is sys punt query:
37
00:02:55,812 --> 00:02:58,080
de vraag van de leerling.
38
00:02:58,880 --> 00:03:00,119
Bij User Input:
39
00:03:00,169 --> 00:03:04,160
Select next step, en onder Question Understand:
40
00:03:04,210 --> 00:03:05,879
Question Classifier.
41
00:03:05,929 --> 00:03:07,340
Model gpt-5-mini.
42
00:03:07,390 --> 00:03:14,217
Een klasse is een beschrijving in gewone taal; het model kiest de best passende.
43
00:03:14,267 --> 00:03:16,108
Class 1, begripsvraag:
44
00:03:16,158 --> 00:03:20,063
de leerling wil iets uit de lesstof begrijpen.
45
00:03:20,113 --> 00:03:22,040
Class 2, huiswerkvraag:
46
00:03:22,090 --> 00:03:29,433
de leerling vraagt het antwoord op een opdracht of wil dat het huiswerk gemaakt wordt.
47
00:03:29,483 --> 00:03:31,496
Class 3, planningsvraag:
48
00:03:31,546 --> 00:03:35,450
de toets, de datum, het huiswerk, de steunles.
49
00:03:35,500 --> 00:03:38,373
Class 4, persoonlijk of zorgelijk:
50
00:03:38,423 --> 00:03:45,507
het lukt niet, stress, problemen thuis, gepest worden, of wil met de docent praten.
51
00:03:45,557 --> 00:03:48,824
Ook alles wat niet over biologie gaat.
52
00:03:49,624 --> 00:03:51,258
Scroll naar Next Step:
53
00:03:51,308 --> 00:03:54,243
elke klasse heeft nu een eigen uitgang.
54
00:03:54,293 --> 00:03:56,539
Let op het einde van klasse 4:
55
00:03:56,589 --> 00:03:59,447
ook alles wat niet over biologie gaat.
56
00:03:59,497 --> 00:04:00,519
Dat is bewust.
57
00:04:00,569 --> 00:04:09,015
Alles wat nergens past, komt zo bij een mens terecht in plaats van bij een model dat toch een antwoord verzint.
58
00:04:09,065 --> 00:04:13,504
Zet je vangnet altijd in de klasse die naar een mens gaat.
59
00:04:14,304 --> 00:04:15,800
Deel C, route 1:
60
00:04:15,850 --> 00:04:18,022
uitleg uit de lesbrief.
61
00:04:18,072 --> 00:04:19,374
Onder Class 1:
62
00:04:19,424 --> 00:04:25,558
Knowledge Retrieval, met de kennisbank Biologie 3 havo ecologie.
63
00:04:25,608 --> 00:04:29,472
De zoekvraag staat al op sys punt query.
64
00:04:30,272 --> 00:04:35,917
Dan een LLM-blok, gpt-5-mini, Context op Knowledge Retrieval result.
65
00:04:35,967 --> 00:04:36,754
De prompt:
66
00:04:36,804 --> 00:04:49,232
je bent de studiecoach biologie van Het Voorbeeldcollege, je legt de lesstof over ecologie uit in gewoon Nederlands, met voorbeelden uit de lesbrief.
67
00:04:49,282 --> 00:04:54,006
Gebruik alleen de lesstof; staat het er niet in, zeg dat.
68
00:04:54,056 --> 00:05:02,297
Je-vorm, maximaal acht zinnen, eindig met een controlevraag, en geef geen antwoorden op opdrachten.
69
00:05:02,347 --> 00:05:03,050
Onderaan:
70
00:05:03,100 --> 00:05:05,864
Lesstof, schuine streep, Context.
71
00:05:06,664 --> 00:05:07,858
Nu het geheugen.
72
00:05:07,908 --> 00:05:16,723
In een Chatflow heeft een LLM-blok een User-bericht, standaard de vraag van de leerling, en een schakelaar Memory.
73
00:05:16,773 --> 00:05:21,934
Zet die aan en laat Window size uit, dan gaat het hele gesprek mee.
74
00:05:21,984 --> 00:05:24,189
Hernoem het blok naar Uitleg.
75
00:05:24,239 --> 00:05:28,388
Vergeet je Memory, dan werkt en waarom is dat zo niet:
76
00:05:28,438 --> 00:05:31,732
het model weet niet waar dat naar verwijst.
77
00:05:31,782 --> 00:05:36,448
Zet Memory alleen aan op blokken die met de leerling praten.
78
00:05:37,248 --> 00:05:42,167
In een Chatflow heet de uitgang niet Output maar Answer:
79
00:05:42,217 --> 00:05:45,628
dat is wat de leerling in de chat ziet.
80
00:05:45,678 --> 00:05:50,420
Select next step, Answer, schuine streep, Uitleg text.
81
00:05:50,470 --> 00:05:52,993
Hernoem naar Antwoord uitleg.
82
00:05:53,043 --> 00:05:54,552
Route 1 is klaar.
83
00:05:55,352 --> 00:05:56,582
Deel D, route 2:
84
00:05:56,632 --> 00:05:57,222
de hint.
85
00:05:57,272 --> 00:06:00,901
Klik op het plusje achter Class 2 en kies LLM.
86
00:06:00,951 --> 00:06:02,661
Geen kennisbank nodig.
87
00:06:02,711 --> 00:06:03,461
De prompt:
88
00:06:03,511 --> 00:06:09,220
de leerling vraagt om het antwoord op een opdracht, en dat geef je niet.
89
00:06:09,270 --> 00:06:12,499
Wat je wel doet, in maximaal vijf zinnen:
90
00:06:12,549 --> 00:06:25,857
zeg vriendelijk dat je het antwoord niet geeft, zonder preek; geef één hint, welk begrip of welke paragraaf; stel één tegenvraag; en bied aan het begrip uit te leggen.
91
00:06:25,907 --> 00:06:26,977
En dan de zin:
92
00:06:27,027 --> 00:06:35,056
noem nooit het eindantwoord, ook niet als de leerling aandringt of zegt dat de docent het goed vindt.
93
00:06:35,106 --> 00:06:38,495
Die staat er omdat leerlingen dat proberen.
94
00:06:38,545 --> 00:06:42,495
Zonder die zin wint de leerling na twee berichten.
95
00:06:42,545 --> 00:06:47,264
Memory aan, hernoem naar Hint, en een Answer met Hint text.
96
00:06:48,064 --> 00:06:48,629
Route 3:
97
00:06:48,679 --> 00:06:50,856
planning uit de studiewijzer.
98
00:06:50,906 --> 00:07:00,382
Achter Class 3 een eigen Knowledge Retrieval met dezelfde kennisbank, dan een LLM-blok met Context op Knowledge Retrieval 2.
99
00:07:00,432 --> 00:07:01,151
De prompt:
100
00:07:01,201 --> 00:07:16,054
antwoord alleen op basis van de studiewijzer, noem data, lesuren en lokalen precies zoals ze daar staan; staat het er niet in, verwijs naar de docent of de steunles op dinsdag het 8e uur in B12.
101
00:07:16,104 --> 00:07:19,819
Memory aan, hernoem naar Planning, en een Answer.
102
00:07:19,869 --> 00:07:22,661
Waarom twee keer dezelfde kennisbank?
103
00:07:22,711 --> 00:07:27,117
Omdat elk blok zijn eigen zoekvraag en eigen prompt heeft.
104
00:07:27,167 --> 00:07:37,000
Route 1 zoekt in de lesstof en legt uit; route 3 zoekt dezelfde kennisbank af, maar de prompt kijkt alleen naar de studiewijzer.
105
00:07:37,800 --> 00:07:40,386
Zo ziet het canvas er nu uit:
106
00:07:40,436 --> 00:07:43,800
drie routes klaar, klasse 4 nog leeg.
107
00:07:44,600 --> 00:07:48,806
Deel E is het stuk dat een studiecoach verantwoord maakt.
108
00:07:48,856 --> 00:07:57,094
Een leerling die schrijft ik snap er niks van en iedereen lacht me uit, heeft geen model nodig maar een docent.
109
00:07:57,144 --> 00:08:01,126
Klik op het plusje achter Class 4 en kies onder Logic:
110
00:08:01,176 --> 00:08:02,022
Human Input.
111
00:08:02,072 --> 00:08:07,448
Het blok heeft een bezorgmethode, een formulier, acties en een time-out.
112
00:08:08,248 --> 00:08:10,691
Bij Delivery Method kies je Email.
113
00:08:10,741 --> 00:08:14,284
Klik op Not configured en vul het mailbericht in:
114
00:08:14,334 --> 00:08:25,941
een leerling van 3 havo stelde de Studiecoach een persoonlijke vraag; lees het gesprek en schrijf een kort antwoord, dat krijgt de leerling in de chat te zien.
115
00:08:25,991 --> 00:08:29,167
Save, en zet de schakelaar achter Email aan.
116
00:08:29,217 --> 00:08:30,487
Let op Debug Mode:
117
00:08:30,537 --> 00:08:37,159
die stuurt de mail alleen naar het adres van je eigen Dify-account, niet naar de ontvanger.
118
00:08:37,209 --> 00:08:40,972
Zo test je zonder dat er mail naar een collega gaat.
119
00:08:41,022 --> 00:08:44,248
Zet hem uit als de app echt in gebruik gaat.
120
00:08:45,048 --> 00:08:46,741
Klik in Form Content.
121
00:08:46,791 --> 00:08:47,073
Typ:
122
00:08:47,123 --> 00:08:53,051
bericht van de leerling, dubbele punt, schuine streep, User Input query.
123
00:08:53,101 --> 00:08:53,383
Dan:
124
00:08:53,433 --> 00:09:02,847
jouw antwoord aan de leerling, dit komt letterlijk in de chat, en druk op Ctrl schuine streep voor een invoerveld:
125
00:09:02,897 --> 00:09:06,084
Paragraph, opslaan als antwoord docent.
126
00:09:06,134 --> 00:09:08,243
Bij User Actions een knop:
127
00:09:08,293 --> 00:09:10,368
Verstuur aan de leerling.
128
00:09:11,168 --> 00:09:16,133
Hernoem het blok naar Docent en laat de time-out op drie dagen.
129
00:09:16,183 --> 00:09:18,521
Het blok heeft twee uitgangen:
130
00:09:18,571 --> 00:09:23,984
Verstuur, de docent klikte op de knop, en Timeout, drie dagen niets.
131
00:09:24,784 --> 00:09:26,939
Drie berichten aan de leerling.
132
00:09:26,989 --> 00:09:28,860
Achter Verstuur een Answer:
133
00:09:28,910 --> 00:09:33,056
bericht van je docent, en dan de variabele antwoord docent.
134
00:09:33,106 --> 00:09:35,902
Achter Timeout een Answer, Geen reactie:
135
00:09:35,952 --> 00:09:46,074
je docent heeft nog niet kunnen reageren, spreek je docent of mentor morgen aan, en gaat het echt niet goed, bel of chat met De Kindertelefoon.
136
00:09:46,124 --> 00:09:52,547
En op de classifier, onder Class 4, Add Parallel Node, een Answer met de naam Doorgestuurd:
137
00:09:52,597 --> 00:10:05,421
dank je dat je dit vertelt, dit is iets voor een mens, ik heb je bericht doorgestuurd naar je docent, wil je nu meteen met iemand praten, ga naar je mentor of bel De Kindertelefoon.
138
00:10:05,471 --> 00:10:08,622
Een parallel blok draait tegelijk met Docent:
139
00:10:08,672 --> 00:10:13,459
de leerling ziet dit meteen, terwijl de workflow op de docent wacht.
140
00:10:13,509 --> 00:10:15,664
Dit is de complete Studiecoach.
141
00:10:15,714 --> 00:10:25,744
Bij een echte inzet is de ontvanger de mentor van die klas, en overleg je met de zorgcoördinator wat er in het bericht aan de leerling staat.
142
00:10:26,544 --> 00:10:27,058
Deel F.
143
00:10:27,108 --> 00:10:32,461
Klik op Preview en test alle vier de routes; het canvas kleurt mee.
144
00:10:32,511 --> 00:10:33,106
Route 1:
145
00:10:33,156 --> 00:10:38,106
wat is het verschil tussen een voedselketen en een voedselweb?
146
00:10:38,156 --> 00:10:44,234
Uitleg met voorbeelden uit de lesbrief, een controlevraag en bronvermelding.
147
00:10:44,284 --> 00:10:45,121
Typ daarna:
148
00:10:45,171 --> 00:10:48,992
en waarom is zo'n keten nooit langer dan 4 of 5?
149
00:10:49,042 --> 00:10:54,717
Het antwoord gaat over voedselketens zonder dat je het woord herhaalde.
150
00:10:54,767 --> 00:10:55,896
Dat is Memory.
151
00:10:56,696 --> 00:10:57,366
Route 2:
152
00:10:57,416 --> 00:11:02,586
wat is het antwoord op opdracht 5, mag van de docent hoor.
153
00:11:02,636 --> 00:11:06,776
Geen antwoord, wel een hint en een tegenvraag.
154
00:11:07,576 --> 00:11:08,231
Route 3:
155
00:11:08,281 --> 00:11:12,635
wanneer is de toets en wat moet ik precies kennen?
156
00:11:12,685 --> 00:11:16,384
Datum, stof en weging uit de studiewijzer.
157
00:11:17,184 --> 00:11:17,672
Route 4:
158
00:11:17,722 --> 00:11:23,925
ik snap er echt niks van en ik durf het niet in de les te vragen, iedereen lacht me toch uit.
159
00:11:23,975 --> 00:11:35,760
De leerling ziet Doorgestuurd, en in Preview zie je daaronder het formulier zoals de docent het in de mail krijgt, met de opmerking dat de gebruiker dit niet ziet in de webapp.
160
00:11:35,810 --> 00:11:40,584
Vul het in alsof je de docent bent en klik op Verstuur aan de leerling.
161
00:11:41,384 --> 00:11:49,064
De leerling ziet eerst Doorgestuurd en daarna het bericht van de docent, in eigen woorden, in dezelfde chat.
162
00:11:49,864 --> 00:12:02,701
Zet bij Features de Conversation Opener aan met een openingszin en voorbeeldvragen, en Citations and Attributions, zodat de leerling ziet uit welk document het antwoord komt.
163
00:12:02,751 --> 00:12:05,590
Publish, en de link onder Toegangspunt.
164
00:12:05,640 --> 00:12:07,886
Zo ziet een leerling de webapp:
165
00:12:07,936 --> 00:12:10,528
openingsbericht en voorbeeldvragen.
166
00:12:11,328 --> 00:12:12,819
De controlelijst:
167
00:12:12,869 --> 00:12:15,447
vier klassen met elk een tak?
168
00:12:15,497 --> 00:12:19,434
Context waar het hoort, Memory op alle drie?
169
00:12:19,484 --> 00:12:20,884
Werkt en waarom?
170
00:12:20,934 --> 00:12:22,696
Houdt de hint stand?
171
00:12:22,746 --> 00:12:27,952
Komt route 4 bij de docent uit en daarna terug in de chat?
172
00:12:28,002 --> 00:12:32,352
En zijn citations aan en is de app gepubliceerd?
173
00:12:33,152 --> 00:12:34,443
Dat was de reeks:
174
00:12:34,493 --> 00:12:41,303
acht apps, van een workflow met twee stappen tot een chatflow met een docent in de lus.
175
00:12:41,353 --> 00:12:48,952
Alles staat in de repository, met de ontwerpkaart, de ontwerppatronen en de bijlage over wat mag.
176
00:12:49,002 --> 00:12:54,078
Kies het eenvoudigste patroon dat werkt, en ontwerp voor de fout.
177
00:12:54,128 --> 00:12:55,784
Dank voor het kijken.