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,472 @@
+1
+00:00:00,000 --> 00:00:05,434
+Welkom bij de tweede handleiding van de reeks AI Agents met Dify voor school.
+
+2
+00:00:05,484 --> 00:00:10,206
+In handleiding 1 bouwde je een workflow, en jij bepaalde elke stap.
+
+3
+00:00:10,256 --> 00:00:11,702
+Nu bouw je een agent.
+
+4
+00:00:11,752 --> 00:00:20,676
+Die krijgt een doel, een instructie en een kennisbank met jouw eigen document, en beslist zelf wanneer hij daarin gaat zoeken.
+
+5
+00:00:20,726 --> 00:00:32,976
+Aan het eind heb je een chatbot met een eigen webadres die vragen over jouw document beantwoordt, met bronvermelding, en eerlijk zegt wanneer het antwoord er niet in staat.
+
+6
+00:00:33,776 --> 00:00:37,741
+Je hebt een document nodig dat de agent moet kennen.
+
+7
+00:00:37,791 --> 00:00:44,225
+Wij gebruiken een fictieve schoolgids van twee pagina's, die bij de handleiding zit.
+
+8
+00:00:44,275 --> 00:00:48,163
+Kies je een eigen document, let dan op drie dingen:
+
+9
+00:00:48,213 --> 00:00:54,879
+echte tekst en geen gescande afbeeldingen, geen persoonsgegevens, en liefst met kopjes.
+
+10
+00:00:54,929 --> 00:00:58,817
+Alles wat je uploadt, staat op de servers van Dify.
+
+11
+00:00:58,867 --> 00:01:01,287
+De handleiding heeft twee delen.
+
+12
+00:01:01,337 --> 00:01:05,120
+Eerst de kennisbank, dan de agent die erin zoekt.
+
+13
+00:01:05,920 --> 00:01:12,477
+Klik in het linkermenu op Knowledge en dan op Een gebruiksklare kennisbank maken.
+
+14
+00:01:12,527 --> 00:01:17,698
+Laat Import from file staan, klik op Browse en kies je document.
+
+15
+00:01:17,748 --> 00:01:18,808
+Klik op Next.
+
+16
+00:01:19,608 --> 00:01:23,264
+Nu komt de stap die de kwaliteit bepaalt.
+
+17
+00:01:23,314 --> 00:01:27,060
+Dify knipt je document in stukken, chunks.
+
+18
+00:01:27,110 --> 00:01:32,845
+De agent zoekt straks in die stukken, niet in het hele document.
+
+19
+00:01:32,895 --> 00:01:34,834
+Klik op Preview Chunk.
+
+20
+00:01:34,884 --> 00:01:42,065
+Zie je veel stukken van één regel, zoals 1 punt Lestijden, of een losse lestijd?
+
+21
+00:01:42,115 --> 00:01:45,138
+Dan knipt Dify op elke regeleinde.
+
+22
+00:01:45,188 --> 00:01:47,579
+Dat gebeurt vaak bij PDF's.
+
+23
+00:01:47,629 --> 00:01:49,387
+Hier zijn het er 46.
+
+24
+00:01:49,437 --> 00:01:54,408
+Een stuk van twaalf tekens kan geen vraag beantwoorden.
+
+25
+00:01:55,208 --> 00:02:01,709
+Klik in het veld Delimiter en vervang de inhoud door twee keer backslash n:
+
+26
+00:02:01,759 --> 00:02:05,989
+dan knipt Dify op een lege regel, dus per alinea.
+
+27
+00:02:06,039 --> 00:02:08,610
+Klik opnieuw op Preview Chunk.
+
+28
+00:02:08,660 --> 00:02:12,279
+Nu zijn het vier stukken met echte inhoud.
+
+29
+00:02:12,329 --> 00:02:14,200
+De rest laat je staan:
+
+30
+00:02:14,250 --> 00:02:19,878
+maximum chunk length 1024, overlap 50, index method High Quality.
+
+31
+00:02:19,928 --> 00:02:22,112
+Klik op Save and Process.
+
+32
+00:02:22,912 --> 00:02:26,275
+Bij twee pagina's duurt dit een paar seconden.
+
+33
+00:02:26,325 --> 00:02:34,289
+De status springt van Embedding Processing naar Embedding Completed, met een groen vinkje achter je bestand.
+
+34
+00:02:34,339 --> 00:02:39,904
+Klik op Go to document; je document staat in de lijst met status Available.
+
+35
+00:02:40,704 --> 00:02:43,375
+Klik in het linkermenu op Settings.
+
+36
+00:02:43,425 --> 00:02:49,437
+Geef de kennisbank een naam, Schoolgids Voorbeeldcollege, en een beschrijving.
+
+37
+00:02:49,487 --> 00:02:52,080
+Die beschrijving is niet voor jou.
+
+38
+00:02:52,130 --> 00:02:57,832
+De agent leest hem om te beslissen of hij deze kennisbank moet raadplegen.
+
+39
+00:02:57,882 --> 00:03:00,242
+Schrijf dus waar hij over gaat:
+
+40
+00:03:00,292 --> 00:03:13,300
+gebruik deze kennisbank voor vragen over de schoolregels van Het Voorbeeldcollege, lestijden, ziek melden, verzuim en verlof, huiswerk en toetsen, telefoons, mentoraat.
+
+41
+00:03:13,350 --> 00:03:16,848
+Scroll helemaal naar beneden en klik op Save.
+
+42
+00:03:17,648 --> 00:03:22,186
+Dit is het moment waarop je ziet wat een kennisbank doet.
+
+43
+00:03:22,236 --> 00:03:25,648
+Klik op Retrieval Testing en typ een vraag:
+
+44
+00:03:25,698 --> 00:03:28,787
+hoe laat moet ik mijn kind ziek melden?
+
+45
+00:03:28,837 --> 00:03:29,833
+Klik op Test.
+
+46
+00:03:29,883 --> 00:03:37,561
+Je krijgt geen antwoord, maar de stukken tekst die het beste bij je vraag passen, met een score.
+
+47
+00:03:37,611 --> 00:03:44,242
+Het stuk met de ziekmeldregels staat bovenaan met 0,86; de andere twee scoren laag.
+
+48
+00:03:44,292 --> 00:03:45,288
+Zo hoort het.
+
+49
+00:03:45,338 --> 00:03:50,168
+Staat het juiste stuk er niet bij, ga dan terug naar stap 2.
+
+50
+00:03:50,968 --> 00:03:51,803
+Nu deel B.
+
+51
+00:03:51,853 --> 00:03:58,791
+Klik op Studio, Create, Create from Blank, More basic app types, en kies Agent.
+
+52
+00:03:58,841 --> 00:03:59,234
+Naam:
+
+53
+00:03:59,284 --> 00:04:01,091
+Schoolgids-assistent.
+
+54
+00:04:01,141 --> 00:04:02,418
+Klik op Create.
+
+55
+00:04:02,468 --> 00:04:07,195
+Naast Orchestrate staat een oranje label Legacy Agent.
+
+56
+00:04:07,245 --> 00:04:11,088
+Schrik daar niet van; de agent werkt gewoon.
+
+57
+00:04:11,138 --> 00:04:19,984
+Dify bouwt aan een nieuwe manier om agents te maken, de Agent Console, en die komt in handleiding 4.
+
+58
+00:04:20,784 --> 00:04:28,815
+Ook hier staat het model standaard op gpt-5, en ook hier is dat vijf keer zo duur als nodig.
+
+59
+00:04:28,865 --> 00:04:33,432
+Klik rechtsboven op de modelnaam en kies gpt-5-mini.
+
+60
+00:04:34,232 --> 00:04:37,921
+Bij een workflow schreef je per stap een prompt.
+
+61
+00:04:37,971 --> 00:04:40,414
+Een agent krijgt één instructie:
+
+62
+00:04:40,464 --> 00:04:43,842
+wie hij is, wat hij mag en wat hij niet mag.
+
+63
+00:04:43,892 --> 00:04:45,400
+Typ in Instructions:
+
+64
+00:04:45,450 --> 00:04:55,216
+je bent de schoolgids-assistent van Het Voorbeeldcollege, je beantwoordt vragen van ouders en leerlingen over de schoolregels.
+
+65
+00:04:55,266 --> 00:04:56,462
+Dan vier regels.
+
+66
+00:04:56,512 --> 00:05:01,137
+Baseer je antwoord alleen op de schoolgids in je kennisbank.
+
+67
+00:05:01,187 --> 00:05:08,615
+Staat het antwoord er niet in, zeg dan eerlijk dat je het niet weet en verwijs naar de receptie.
+
+68
+00:05:08,665 --> 00:05:11,420
+Antwoord kort, maximaal vijf zinnen.
+
+69
+00:05:11,470 --> 00:05:14,146
+En noem waar het kan het hoofdstuk.
+
+70
+00:05:14,196 --> 00:05:17,652
+Die eerste twee regels zijn de belangrijkste.
+
+71
+00:05:17,702 --> 00:05:21,391
+Zonder die regels verzint hij er vrolijk op los.
+
+72
+00:05:21,441 --> 00:05:23,417
+De rest mag je veranderen:
+
+73
+00:05:23,467 --> 00:05:27,440
+de rol, de toon, u of je, Engels op Engelse vragen.
+
+74
+00:05:28,240 --> 00:05:34,158
+Klik bij Knowledge op Add, kies Schoolgids Voorbeeldcollege en klik op Add.
+
+75
+00:05:34,208 --> 00:05:37,072
+De kennisbank hangt nu aan de agent.
+
+76
+00:05:37,872 --> 00:05:40,058
+Rechts staat Debug and Preview:
+
+77
+00:05:40,108 --> 00:05:44,531
+een chatvenster om met de agent te praten voordat hij live is.
+
+78
+00:05:44,581 --> 00:05:46,335
+Stel twee soorten vragen:
+
+79
+00:05:46,385 --> 00:05:50,591
+een die in het document staat, en een die er niet in staat.
+
+80
+00:05:50,641 --> 00:05:51,024
+Eerst:
+
+81
+00:05:51,074 --> 00:05:55,641
+mijn dochter heeft een toets gemist, wanneer kan ze die inhalen?
+
+82
+00:05:55,691 --> 00:06:02,544
+Boven het antwoord verschijnt het label Used Knowledge, en in het antwoord staat het hoofdstuk.
+
+83
+00:06:03,344 --> 00:06:06,683
+Klik op Used Knowledge om het open te klappen.
+
+84
+00:06:06,733 --> 00:06:07,935
+Kijk bij Request:
+
+85
+00:06:07,985 --> 00:06:12,650
+daar staat de zoekopdracht die de agent zelf heeft geformuleerd.
+
+86
+00:06:12,700 --> 00:06:17,660
+Jij hebt hem niet gezegd dat hij moest zoeken, en ook niet waarnaar.
+
+87
+00:06:17,710 --> 00:06:23,628
+Hij besloot dat zelf, op basis van je vraag en de beschrijving van de kennisbank.
+
+88
+00:06:23,678 --> 00:06:27,656
+Dat is het verschil met de workflow van handleiding 1.
+
+89
+00:06:28,456 --> 00:06:29,869
+Dan de tweede vraag:
+
+90
+00:06:29,919 --> 00:06:32,796
+wat kost het schoolkamp van de brugklas?
+
+91
+00:06:32,846 --> 00:06:38,575
+De agent zegt dat het niet in de schoolgids staat en verwijst naar de receptie.
+
+92
+00:06:38,625 --> 00:06:42,014
+Dat komt door de tweede regel in je instructie.
+
+93
+00:06:42,064 --> 00:06:45,086
+Haal die regel weg en probeer het opnieuw:
+
+94
+00:06:45,136 --> 00:06:48,136
+dan krijg je een keurig verzonnen bedrag.
+
+95
+00:06:48,936 --> 00:06:51,039
+Klik rechtsboven op Publish.
+
+96
+00:06:51,089 --> 00:06:52,962
+Let op wat het menu zegt:
+
+97
+00:06:53,012 --> 00:06:59,346
+Latest Published, een paar minuten geleden, terwijl je nog niets gepubliceerd hebt.
+
+98
+00:06:59,396 --> 00:07:04,653
+Dify publiceert een Agent-app namelijk al bij het aanmaken, dus leeg.
+
+99
+00:07:04,703 --> 00:07:10,036
+De versie met jouw instructie en kennisbank staat onder Current Draft.
+
+100
+00:07:10,086 --> 00:07:15,624
+Sla je Publish Update over, dan opent de webapp een agent zonder kennis.
+
+101
+00:07:16,424 --> 00:07:18,288
+Klik op Publish Update.
+
+102
+00:07:18,338 --> 00:07:23,912
+De melding Success verschijnt en onder de knop staat nu Up to date.
+
+103
+00:07:24,712 --> 00:07:27,508
+Klik op Webapp openen en typ een vraag:
+
+104
+00:07:27,558 --> 00:07:31,158
+mag mijn zoon zijn telefoon gebruiken in de pauze?
+
+105
+00:07:31,208 --> 00:07:35,756
+Onder het antwoord staat Citations met de naam van je document.
+
+106
+00:07:35,806 --> 00:07:42,520
+Dat is de link die je aan een collega geeft; hij werkt zonder inloggen, ook op een telefoon.
+
+107
+00:07:43,320 --> 00:07:44,581
+De controlelijst:
+
+108
+00:07:44,631 --> 00:07:49,905
+staat de kennisbank op Available, met een handvol stukken per pagina?
+
+109
+00:07:49,955 --> 00:07:52,991
+Vindt Retrieval Testing het juiste stuk?
+
+110
+00:07:53,041 --> 00:07:56,308
+Staat er Used Knowledge boven het antwoord?
+
+111
+00:07:56,358 --> 00:07:59,008
+Zegt hij het als hij het niet weet?
+
+112
+00:07:59,058 --> 00:08:01,245
+En toont de webapp Citations?
+
+113
+00:08:01,295 --> 00:08:05,334
+Gaat het mis, dan is het meestal een van vier dingen:
+
+114
+00:08:05,384 --> 00:08:15,336
+de delimiter, een lege beschrijving van de kennisbank, de ontbrekende regel zeg dat je het niet weet, of Publish Update vergeten.
+
+115
+00:08:16,136 --> 00:08:24,279
+De handleiding, de schoolgids en de beelden staan in de repository; de agent staat live op udify punt app.
+
+116
+00:08:24,329 --> 00:08:30,075
+In de volgende video zetten we drie apps in elkaar voor schoolcommunicatie:
+
+117
+00:08:30,125 --> 00:08:34,404
+de Ouderbrief-assistent, Schoolnieuws en de Balie-stand.
+
+118
+00:08:34,454 --> 00:08:35,072
+Tot dan.
+