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,95 @@
+# titel: Tekst op niveau
+# ondertitel: Handleiding 1 · bouwen in Dify: van workflow naar agent
+# stem: nl-NL-FennaNeural
+# tempo: -5%
+# uitvoer: video-tekst-op-niveau
+# reeks: Reeks AI Agents met Dify voor school
+# bron: git.lexconsultancy.nl/guido/dify-handleidingen
+
+[titel]
+Welkom bij de eerste handleiding van de reeks AI Agents met Dify voor school. Je bouwt Tekst op niveau: een app die een tekst herschrijft voor een gekozen niveau en er drie begripsvragen bij maakt. Twee denkstappen achter elkaar, gepubliceerd als webpagina die zonder inloggen werkt.
+
+Het is de kleinste app uit de reeks, en de belangrijkste: hier leer je wat een workflow is. Vaste stappen, één invoer, één uitvoer, en jij bepaalt de volgorde.
+
+[kaart: Wat je nodig hebt | Een gratis account op cloud punt dify punt ai, de sandbox met 200 credits en 5 apps | De menu's zijn Nederlands, de knoppen in de app Engels | Een stukje tekst om te testen, zonder namen | Twintig minuten]
+Je hebt een gratis account nodig op cloud punt dify punt ai. Dat is de sandbox: tweehonderd credits en vijf apps. Die credits zijn eenmalig, niet per maand, dus we gaan er zuinig mee om.
+
+De menu's staan in het Nederlands, de knoppen in de app zijn Engels. Ik noem de Engelse namen zoals ze op je scherm staan.
+
+[beeld: screenshot-1789888233562-0.jpg | Voorbereiding. Studio]
+Log in. Je komt binnen in Studio: het overzicht van je apps. Linksboven staat je werkruimte met het label Sandbox en het aantal credits.
+
+[beeld: screenshot-1789888255498-3.jpg | Stap 1. Een nieuwe app]
+Klik rechtsboven op Create en kies Create from Blank. Je ziet eerst twee soorten: Workflow en Chatflow. Klik op More basic app types; nu verschijnen ook Chatbot, Agent en Text Generator. Dit is de knop die iedereen mist die een agent wil bouwen.
+
+Vandaag kiezen we Workflow: vaste stappen van invoer naar uitvoer.
+
+[beeld: screenshot-1789888261215-4.jpg | Stap 1. Naam]
+Vul de naam in: Tekst op niveau. Klik op Create.
+
+[beeld: screenshot-1789888280622-6.jpg | Stap 2. De startnode]
+Een workflow begint niet vanzelf. In het rechterpaneel kies je wat hem activeert. Klik op User Input. De node staat nu op het canvas, en rechts zie je Input Field met een plusje: daar maak je de velden die de gebruiker straks invult.
+
+[beeld: screenshot-1789888299055-8.jpg | Stap 3. Veld 1: de tekst]
+Klik op het plusje bij Input Field en klap Field Type open. Kies Paragraph. Vul in: Variable Name tekst, Label Name De tekst die je wilt aanpassen.
+
+Let op: zodra je de variabelenaam typt, vult Dify het labelveld automatisch met diezelfde naam. Maak dat veld eerst leeg voordat je je eigen label typt, anders krijg je tekst en label aan elkaar geplakt. Klik op Save.
+
+[beeld: screenshot-1789888356154-9.jpg | Stap 3. Veld 2: het niveau]
+Klik opnieuw op het plusje. Zet Field Type op Select. Variable Name niveau, Label Name Voor welk niveau. Klik vier keer op Add option en typ per vakje een optie: groep 7, brugklas, 3 havo, 5 vwo.
+
+Klik na elke nieuwe regel eerst in het lege vakje voordat je typt. Doe je dat niet, dan belandt je tekst nergens.
+
+Die vier niveaus zijn een voorbeeld. Zet er de niveaus in die jij voor je hebt: vmbo-basis 2, NT2 A2, of iets heel anders zoals collega, ouder, bestuurder. De optie is straks letterlijk het woord dat in de prompt terechtkomt.
+
+[beeld: screenshot-1789888361362-10.jpg | Stap 3. Beide velden]
+Klik op Save. Beide velden staan nu in de node.
+
+[beeld: screenshot-1789888376523-12.jpg | Stap 4. De eerste denkstap en het model]
+Klik rechts onder Next Step op Select Next Step en kies LLM. Dat is de denkstap.
+
+Zet meteen het model goed. De node staat standaard op gpt-5, en dat kost vijf credits per antwoord. gpt-5-mini kost er één. Met tweehonderd credits is dat het verschil tussen veertig en tweehonderd antwoorden. Klik op de modelnaam en kies gpt-5-mini.
+
+[beeld: screenshot-1789888390005-13.jpg | Stap 4. De prompt en de variabele]
+Klik in het veld System en typ de instructie: herschrijf de onderstaande tekst zodat een leerling van dit niveau hem kan lezen. Behoud alle inhoudelijke informatie. Verander geen vakbegrippen, maar leg ze uit in een bijzin. Schrijf korte zinnen.
+
+Dan een nieuwe regel: Niveau, dubbele punt. En nu het belangrijkste kunstje van Dify: typ een schuine streep. Er verschijnt een lijst met je invoervelden. Kies niveau. Accolades typen hoeft niet; Dify zet de variabele zelf neer.
+
+Nog een regel: Tekst, dubbele punt, schuine streep, en kies tekst.
+
+[beeld: screenshot-1789888404719-14.jpg | Stap 4. De eerste LLM-node, af]
+De prompt is compleet. Die instructie is de kern van je app. Wil je dat de tekst ook korter wordt, of dat moeilijke woorden vet worden en onderaan uitgelegd? Zeg dat letterlijk. Verander één ding per keer en test opnieuw; dan weet je wat welk effect heeft.
+
+[beeld: screenshot-1789888443889-15.jpg | Stap 5. De tweede denkstap]
+Scroll in het rechterpaneel naar beneden, klik op Select Next Step en kies opnieuw LLM. Model weer op gpt-5-mini. Typ in System: maak drie begripsvragen bij de onderstaande tekst. Vraag 1 over een feit, vraag 2 over de hoofdgedachte, vraag 3 laat de leerling iets toepassen. Geef geen antwoorden.
+
+Nieuwe regel, Tekst, dubbele punt, schuine streep. Nu staan er meer variabelen in de lijst: bovenaan de uitvoer van LLM 2, de node waar je in zit, en daaronder die van LLM, de vorige node. Kies text onder LLM. Dat is de herschreven tekst.
+
+Let op: kies je text onder LLM 2, dan maakt hij vragen bij de oorspronkelijke tekst, en dat merk je pas bij het testen.
+
+Hier zie je waar een workflow om draait: de tweede stap werkt met wat de eerste heeft gemaakt. Jij bepaalt die volgorde.
+
+[beeld: screenshot-1789888503770-17.jpg | Stap 6. Wat eruit komt]
+Klik op Select Next Step en kies Output. Klik op het plusje bij Output Variable en maak twee uitvoervariabelen: herschreven tekst, met als bron LLM text, en vragen, met als bron LLM 2 text.
+
+[beeld: screenshot-1789888525952-19.jpg | Stap 7. Testen]
+Klik rechtsboven op Test Run. Rechts verschijnt een paneel met je eigen invoervelden. Plak een stuk tekst, bijvoorbeeld de alinea over fotosynthese uit de handleiding, kies brugklas, en klik op Start Run.
+
+[beeld: screenshot-1789888571578-21.jpg | Stap 7. Het resultaat]
+Je ziet de nodes een voor een oplichten. Onder Result staat de uitkomst: de herschreven tekst en de drie vragen. Onder Detail en Tracing zie je per stap wat er gebeurd is en hoe lang het duurde.
+
+[beeld: screenshot-1789889800590-23.jpg | Stap 8. Publiceren]
+Zolang je niet publiceert, bestaat je app alleen voor jezelf. Klik rechtsboven op Publish, en in het menu nog een keer op Publish. Bovenaan verandert de status.
+
+Open het menu opnieuw: nu staat er Publish Update, en de grijze opties zijn actief. Onthoud dit: elke wijziging die je hierna maakt, moet je opnieuw publiceren met Publish Update. Anders blijft de link de oude versie tonen.
+
+[beeld: screenshot-1789889850420-26.jpg | Stap 8. De webapp]
+Klik op Webapp openen. Je app opent als gewone webpagina met een eigen adres. Die link werkt zonder inloggen, ook op een telefoon. Dat is de link die je aan een collega geeft.
+
+[kaart: Controleren of het gelukt is | Twee invoervelden: een tekstvak en een keuzelijst | Twee LLM-stappen op gpt-5-mini | De tweede stap gebruikt text van de eerste, niet van zichzelf | Test Run geeft herschreven tekst plus drie vragen | De webapp-link werkt in een privévenster]
+De controlelijst. Twee invoervelden? Beide denkstappen op gpt-5-mini? Gebruikt de tweede stap de uitvoer van de eerste? Geeft Test Run tekst plus vragen? En werkt de link in een privévenster, dus zonder dat je ingelogd bent?
+
+Gaat er iets mis, dan is het bijna altijd een van drie dingen: de variabele getypt in plaats van via de schuine streep gekozen, Publish vergeten, of gpt-5 laten staan.
+
+[slot: Jij bepaalt de volgorde. Dat is een workflow.]
+De handleiding en de beelden staan in de repository; de app zelf staat live op udify punt app. In de volgende video bouwen we een agent met een eigen kennisbank: de Schoolgids-assistent. Tot dan.
@@ -0,0 +1,516 @@
+1
+00:00:00,000 --> 00:00:05,739
+Welkom bij de eerste handleiding van de reeks AI Agents met Dify voor school.
+
+2
+00:00:05,789 --> 00:00:07,619
+Je bouwt Tekst op niveau:
+
+3
+00:00:07,669 --> 00:00:14,611
+een app die een tekst herschrijft voor een gekozen niveau en er drie begripsvragen bij maakt.
+
+4
+00:00:14,661 --> 00:00:21,002
+Twee denkstappen achter elkaar, gepubliceerd als webpagina die zonder inloggen werkt.
+
+5
+00:00:21,052 --> 00:00:25,287
+Het is de kleinste app uit de reeks, en de belangrijkste:
+
+6
+00:00:25,337 --> 00:00:27,769
+hier leer je wat een workflow is.
+
+7
+00:00:27,819 --> 00:00:32,856
+Vaste stappen, één invoer, één uitvoer, en jij bepaalt de volgorde.
+
+8
+00:00:33,656 --> 00:00:38,447
+Je hebt een gratis account nodig op cloud punt dify punt ai.
+
+9
+00:00:38,497 --> 00:00:39,899
+Dat is de sandbox:
+
+10
+00:00:39,949 --> 00:00:42,562
+tweehonderd credits en vijf apps.
+
+11
+00:00:42,612 --> 00:00:48,371
+Die credits zijn eenmalig, niet per maand, dus we gaan er zuinig mee om.
+
+12
+00:00:48,421 --> 00:00:53,858
+De menu's staan in het Nederlands, de knoppen in de app zijn Engels.
+
+13
+00:00:53,908 --> 00:00:58,184
+Ik noem de Engelse namen zoals ze op je scherm staan.
+
+14
+00:00:58,984 --> 00:00:59,558
+Log in.
+
+15
+00:00:59,608 --> 00:01:01,787
+Je komt binnen in Studio:
+
+16
+00:01:01,837 --> 00:01:04,104
+het overzicht van je apps.
+
+17
+00:01:04,154 --> 00:01:10,840
+Linksboven staat je werkruimte met het label Sandbox en het aantal credits.
+
+18
+00:01:11,640 --> 00:01:15,967
+Klik rechtsboven op Create en kies Create from Blank.
+
+19
+00:01:16,017 --> 00:01:18,197
+Je ziet eerst twee soorten:
+
+20
+00:01:18,247 --> 00:01:19,931
+Workflow en Chatflow.
+
+21
+00:01:19,981 --> 00:01:26,704
+Klik op More basic app types; nu verschijnen ook Chatbot, Agent en Text Generator.
+
+22
+00:01:26,754 --> 00:01:31,494
+Dit is de knop die iedereen mist die een agent wil bouwen.
+
+23
+00:01:31,544 --> 00:01:33,724
+Vandaag kiezen we Workflow:
+
+24
+00:01:33,774 --> 00:01:36,912
+vaste stappen van invoer naar uitvoer.
+
+25
+00:01:37,712 --> 00:01:39,454
+Vul de naam in:
+
+26
+00:01:39,504 --> 00:01:41,366
+Tekst op niveau.
+
+27
+00:01:41,416 --> 00:01:43,208
+Klik op Create.
+
+28
+00:01:44,008 --> 00:01:46,517
+Een workflow begint niet vanzelf.
+
+29
+00:01:46,567 --> 00:01:50,162
+In het rechterpaneel kies je wat hem activeert.
+
+30
+00:01:50,212 --> 00:01:51,636
+Klik op User Input.
+
+31
+00:01:51,686 --> 00:01:57,530
+De node staat nu op het canvas, en rechts zie je Input Field met een plusje:
+
+32
+00:01:57,580 --> 00:02:01,768
+daar maak je de velden die de gebruiker straks invult.
+
+33
+00:02:02,568 --> 00:02:07,359
+Klik op het plusje bij Input Field en klap Field Type open.
+
+34
+00:02:07,409 --> 00:02:08,590
+Kies Paragraph.
+
+35
+00:02:08,640 --> 00:02:09,165
+Vul in:
+
+36
+00:02:09,215 --> 00:02:14,334
+Variable Name tekst, Label Name De tekst die je wilt aanpassen.
+
+37
+00:02:14,384 --> 00:02:14,908
+Let op:
+
+38
+00:02:14,958 --> 00:02:22,047
+zodra je de variabelenaam typt, vult Dify het labelveld automatisch met diezelfde naam.
+
+39
+00:02:22,097 --> 00:02:30,827
+Maak dat veld eerst leeg voordat je je eigen label typt, anders krijg je tekst en label aan elkaar geplakt.
+
+40
+00:02:30,877 --> 00:02:31,944
+Klik op Save.
+
+41
+00:02:32,744 --> 00:02:35,050
+Klik opnieuw op het plusje.
+
+42
+00:02:35,100 --> 00:02:37,232
+Zet Field Type op Select.
+
+43
+00:02:37,282 --> 00:02:41,595
+Variable Name niveau, Label Name Voor welk niveau.
+
+44
+00:02:41,645 --> 00:02:46,482
+Klik vier keer op Add option en typ per vakje een optie:
+
+45
+00:02:46,532 --> 00:02:49,362
+groep 7, brugklas, 3 havo, 5 vwo.
+
+46
+00:02:49,412 --> 00:02:55,122
+Klik na elke nieuwe regel eerst in het lege vakje voordat je typt.
+
+47
+00:02:55,172 --> 00:02:59,136
+Doe je dat niet, dan belandt je tekst nergens.
+
+48
+00:02:59,186 --> 00:03:02,278
+Die vier niveaus zijn een voorbeeld.
+
+49
+00:03:02,328 --> 00:03:05,943
+Zet er de niveaus in die jij voor je hebt:
+
+50
+00:03:05,993 --> 00:03:12,488
+vmbo-basis 2, NT2 A2, of iets heel anders zoals collega, ouder, bestuurder.
+
+51
+00:03:12,538 --> 00:03:18,560
+De optie is straks letterlijk het woord dat in de prompt terechtkomt.
+
+52
+00:03:19,360 --> 00:03:20,775
+Klik op Save.
+
+53
+00:03:20,825 --> 00:03:24,544
+Beide velden staan nu in de node.
+
+54
+00:03:25,344 --> 00:03:30,762
+Klik rechts onder Next Step op Select Next Step en kies LLM.
+
+55
+00:03:30,812 --> 00:03:32,493
+Dat is de denkstap.
+
+56
+00:03:32,543 --> 00:03:34,862
+Zet meteen het model goed.
+
+57
+00:03:34,912 --> 00:03:41,423
+De node staat standaard op gpt-5, en dat kost vijf credits per antwoord.
+
+58
+00:03:41,473 --> 00:03:43,519
+gpt-5-mini kost er één.
+
+59
+00:03:43,569 --> 00:03:51,265
+Met tweehonderd credits is dat het verschil tussen veertig en tweehonderd antwoorden.
+
+60
+00:03:51,315 --> 00:03:54,960
+Klik op de modelnaam en kies gpt-5-mini.
+
+61
+00:03:55,760 --> 00:03:59,476
+Klik in het veld System en typ de instructie:
+
+62
+00:03:59,526 --> 00:04:06,254
+herschrijf de onderstaande tekst zodat een leerling van dit niveau hem kan lezen.
+
+63
+00:04:06,304 --> 00:04:09,266
+Behoud alle inhoudelijke informatie.
+
+64
+00:04:09,316 --> 00:04:14,120
+Verander geen vakbegrippen, maar leg ze uit in een bijzin.
+
+65
+00:04:14,170 --> 00:04:15,877
+Schrijf korte zinnen.
+
+66
+00:04:15,927 --> 00:04:17,635
+Dan een nieuwe regel:
+
+67
+00:04:17,685 --> 00:04:19,392
+Niveau, dubbele punt.
+
+68
+00:04:19,442 --> 00:04:22,823
+En nu het belangrijkste kunstje van Dify:
+
+69
+00:04:22,873 --> 00:04:24,748
+typ een schuine streep.
+
+70
+00:04:24,798 --> 00:04:28,430
+Er verschijnt een lijst met je invoervelden.
+
+71
+00:04:28,480 --> 00:04:29,434
+Kies niveau.
+
+72
+00:04:29,484 --> 00:04:34,455
+Accolades typen hoeft niet; Dify zet de variabele zelf neer.
+
+73
+00:04:34,505 --> 00:04:35,626
+Nog een regel:
+
+74
+00:04:35,676 --> 00:04:39,944
+Tekst, dubbele punt, schuine streep, en kies tekst.
+
+75
+00:04:40,744 --> 00:04:42,420
+De prompt is compleet.
+
+76
+00:04:42,470 --> 00:04:45,324
+Die instructie is de kern van je app.
+
+77
+00:04:45,374 --> 00:04:52,858
+Wil je dat de tekst ook korter wordt, of dat moeilijke woorden vet worden en onderaan uitgelegd?
+
+78
+00:04:52,908 --> 00:04:54,349
+Zeg dat letterlijk.
+
+79
+00:04:54,399 --> 00:05:00,520
+Verander één ding per keer en test opnieuw; dan weet je wat welk effect heeft.
+
+80
+00:05:01,320 --> 00:05:08,648
+Scroll in het rechterpaneel naar beneden, klik op Select Next Step en kies opnieuw LLM.
+
+81
+00:05:08,698 --> 00:05:10,768
+Model weer op gpt-5-mini.
+
+82
+00:05:10,818 --> 00:05:11,955
+Typ in System:
+
+83
+00:05:12,005 --> 00:05:16,196
+maak drie begripsvragen bij de onderstaande tekst.
+
+84
+00:05:16,246 --> 00:05:24,167
+Vraag 1 over een feit, vraag 2 over de hoofdgedachte, vraag 3 laat de leerling iets toepassen.
+
+85
+00:05:24,217 --> 00:05:25,948
+Geef geen antwoorden.
+
+86
+00:05:25,998 --> 00:05:30,188
+Nieuwe regel, Tekst, dubbele punt, schuine streep.
+
+87
+00:05:30,238 --> 00:05:33,580
+Nu staan er meer variabelen in de lijst:
+
+88
+00:05:33,630 --> 00:05:41,722
+bovenaan de uitvoer van LLM 2, de node waar je in zit, en daaronder die van LLM, de vorige node.
+
+89
+00:05:41,772 --> 00:05:43,418
+Kies text onder LLM.
+
+90
+00:05:43,468 --> 00:05:45,792
+Dat is de herschreven tekst.
+
+91
+00:05:45,842 --> 00:05:46,386
+Let op:
+
+92
+00:05:46,436 --> 00:05:55,799
+kies je text onder LLM 2, dan maakt hij vragen bij de oorspronkelijke tekst, en dat merk je pas bij het testen.
+
+93
+00:05:55,849 --> 00:05:59,191
+Hier zie je waar een workflow om draait:
+
+94
+00:05:59,241 --> 00:06:03,686
+de tweede stap werkt met wat de eerste heeft gemaakt.
+
+95
+00:06:03,736 --> 00:06:05,856
+Jij bepaalt die volgorde.
+
+96
+00:06:06,656 --> 00:06:10,066
+Klik op Select Next Step en kies Output.
+
+97
+00:06:10,116 --> 00:06:16,121
+Klik op het plusje bij Output Variable en maak twee uitvoervariabelen:
+
+98
+00:06:16,171 --> 00:06:22,832
+herschreven tekst, met als bron LLM text, en vragen, met als bron LLM 2 text.
+
+99
+00:06:23,632 --> 00:06:25,870
+Klik rechtsboven op Test Run.
+
+100
+00:06:25,920 --> 00:06:30,209
+Rechts verschijnt een paneel met je eigen invoervelden.
+
+101
+00:06:30,259 --> 00:06:39,568
+Plak een stuk tekst, bijvoorbeeld de alinea over fotosynthese uit de handleiding, kies brugklas, en klik op Start Run.
+
+102
+00:06:40,368 --> 00:06:43,344
+Je ziet de nodes een voor een oplichten.
+
+103
+00:06:43,394 --> 00:06:45,689
+Onder Result staat de uitkomst:
+
+104
+00:06:45,739 --> 00:06:48,639
+de herschreven tekst en de drie vragen.
+
+105
+00:06:48,689 --> 00:06:54,816
+Onder Detail en Tracing zie je per stap wat er gebeurd is en hoe lang het duurde.
+
+106
+00:06:55,616 --> 00:07:00,490
+Zolang je niet publiceert, bestaat je app alleen voor jezelf.
+
+107
+00:07:00,540 --> 00:07:05,979
+Klik rechtsboven op Publish, en in het menu nog een keer op Publish.
+
+108
+00:07:06,029 --> 00:07:08,320
+Bovenaan verandert de status.
+
+109
+00:07:08,370 --> 00:07:10,096
+Open het menu opnieuw:
+
+110
+00:07:10,146 --> 00:07:14,939
+nu staat er Publish Update, en de grijze opties zijn actief.
+
+111
+00:07:14,989 --> 00:07:15,908
+Onthoud dit:
+
+112
+00:07:15,958 --> 00:07:22,527
+elke wijziging die je hierna maakt, moet je opnieuw publiceren met Publish Update.
+
+113
+00:07:22,577 --> 00:07:26,048
+Anders blijft de link de oude versie tonen.
+
+114
+00:07:26,848 --> 00:07:28,664
+Klik op Webapp openen.
+
+115
+00:07:28,714 --> 00:07:33,246
+Je app opent als gewone webpagina met een eigen adres.
+
+116
+00:07:33,296 --> 00:07:37,657
+Die link werkt zonder inloggen, ook op een telefoon.
+
+117
+00:07:37,707 --> 00:07:41,440
+Dat is de link die je aan een collega geeft.
+
+118
+00:07:42,240 --> 00:07:43,641
+De controlelijst.
+
+119
+00:07:43,691 --> 00:07:45,177
+Twee invoervelden?
+
+120
+00:07:45,227 --> 00:07:47,908
+Beide denkstappen op gpt-5-mini?
+
+121
+00:07:47,958 --> 00:07:52,089
+Gebruikt de tweede stap de uitvoer van de eerste?
+
+122
+00:07:52,139 --> 00:07:54,906
+Geeft Test Run tekst plus vragen?
+
+123
+00:07:54,956 --> 00:08:00,880
+En werkt de link in een privévenster, dus zonder dat je ingelogd bent?
+
+124
+00:08:00,930 --> 00:08:06,171
+Gaat er iets mis, dan is het bijna altijd een van drie dingen:
+
+125
+00:08:06,221 --> 00:08:15,096
+de variabele getypt in plaats van via de schuine streep gekozen, Publish vergeten, of gpt-5 laten staan.
+
+126
+00:08:15,896 --> 00:08:23,331
+De handleiding en de beelden staan in de repository; de app zelf staat live op udify punt app.
+
+127
+00:08:23,381 --> 00:08:28,586
+In de volgende video bouwen we een agent met een eigen kennisbank:
+
+128
+00:08:28,636 --> 00:08:30,497
+de Schoolgids-assistent.
+
+129
+00:08:30,547 --> 00:08:31,184
+Tot dan.
+