Guido van Dijk
909eca8067
- QR (segno) in beelden/, met bijschrift Alle vier de reeksen - BRON wijst naar de overzichtspagina in plaats van een enkele repository - pptx en notitieversies opnieuw gebouwd Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Dify-handleidingen
Stap-voor-stap handleidingen, bijlagen en een workshop over het bouwen van AI-agents in Dify voor het onderwijs. Gemaakt door LeX Consultancy B.V. voor AI Netwerk Limburg en de Experimenteerruimte ICT SOML. Alle voorbeelden spelen op Het Voorbeeldcollege (fictief); schermen vastgelegd op Dify cloud, 20 september 2026.
Licentie: CC BY-SA 4.0 (documenten, dia's, beelden) en MIT (scripts), zie LICENSE.md. Eigenaar en contact: Guido van Dijk, guido@l-e-x.nl, guido@ai-netwerk-limburg.nl.
Inhoud
| Map | Titel | Voor wie | Omvang |
|---|---|---|---|
| 01-workflow | Bouwen in Dify: van workflow naar agent | Beginners | 22 pp. |
| 02-agent-kennisbank | Bouwen in Dify: een agent met eigen kennisbank | Beginners, vervolg op 01 | 22 pp. |
| 03-schoolcommunicatie | Dify voor schoolcommunicatie: ouderbrief, schoolnieuws, balie | Teams communicatie | 36 pp. |
| 04-agent-console | Bouwen in de Agent Console: de Toetsweekplanner (agent met bestand, tool en sandbox) | Mentoren, Experimenteerruimte | 27 pp. |
| 05-transcriptietool | Bouwen in Dify: van opname naar verslag | Secties, teams | 31 pp. |
| 06-inclusief-lesmateriaal | Bouwen in de Agent Console: de Lesmateriaal-check (UDL, eigen tools voor open leermateriaal en SLO-leerdoelen) | Docenten, ondersteuningscoördinatoren | 31 pp. |
| 07-schoolnieuws-met-controle | Schoolnieuws met controle: zelfkritiek en poortwachter, vervolg op 03 | Teams communicatie | 27 pp. |
| 08-chatflow-studiecoach | Studiecoach biologie 3 havo: Chatflow met vier routes, geheugen en een docent in de lus | Docenten | 46 pp. |
| 00-workshop | Draaiboek van de workshop AI Agents met Dify (2,5 uur): voorbereiding, programma, werkvormen, valkuilen per blok, het vergelijkingsblok met Copilot, ChatGPT en Gemini, noodplannen, veelgestelde vragen en drie bijlagen | Begeleiders | 18 pp. |
| 00-presentatie | Presentatie bij de workshop: PDF, bron van de dia's en sprekersnotities | Begeleiders | 26 dia's |
| 00-lezing | Korte presentatie (20 min): wat een AI-agent is en wat niet, voor een teamvergadering of bestuur; platformonafhankelijk, geen laptops nodig | Iedereen die het moet uitleggen | 12 dia's |
| 00-sessie | Sessie van 2 x een uur: inhoud, interactie, onze acht voorbeelden live, en daarna je eigen project op de ontwerpkaart; bouwen mag, hoeft niet | Gemengd publiek, festival of netwerkbijeenkomst | 23 dia's |
| 00-ontwerppatronen | Vijf ontwerppatronen voor AI-agents en hoe je ze in Dify bouwt | Iedereen | 5 pp. |
| 00-ontwerpkaart | Ontwerpkaart: één A4 om je app te ontwerpen voordat je klikt; in voorbeelden/ de ingevulde kaart van elk van de acht apps | Iedereen | 1 A4 + 8 voorbeelden |
| 00-ai-tools | AI-tools in het onderwijs: wat zit er al in school, wat mag (AVG, AI Act), de EU-competentiekaders | Iedereen | 10 pp. |
| 00-zelf-hosten | Dify zelf hosten: de Community Edition met Docker op Windows, Mac en Linux, en wat er bijkomt op een schoolserver | ICT, nieuwsgierige bouwers | 9 pp. |
Elke handleiding heeft per stap een groen kader "Zelf kiezen" (wat je vervangt door eigen materiaal, stijl of prompt) en een slothoofdstuk "Maak hem van jou" met aanpaspunten, opdrachten en een checklist.
Waarvoor is welke app
Elke handleiding bouwt één app. Dit is waar ze voor bedoeld zijn en wanneer je welke kiest.
| App | Wat hij doet | Voor wie | Soort | Kies deze als |
|---|---|---|---|---|
| Tekst op niveau (01) | Herschrijft een tekst naar een gekozen doelgroep of taalniveau | Docenten, communicatie | Workflow | Je wilt leren wat een workflow is: vaste stappen, één invoer, één uitvoer |
| Schoolgids-assistent (02) | Beantwoordt vragen van ouders en leerlingen uit de schoolgids, met bronvermelding | Balie, mentoren, ouders | Agent met kennisbank | Je hebt een document waar steeds dezelfde vragen over komen |
| Ouderbrief-assistent (03) | Schrijft een ouderbrief in de stijl van de school, op basis van de schrijfwijzer | Teams, teamleiders | Agent met kennisbank | Brieven moeten in één toon en één opmaak, door verschillende mensen |
| Schoolnieuws (03 en 07) | Maakt van één bericht drie versies: website, ouderapp en social; in 07 met een controleur en een poortwachter die afkeurt wat niet aan de regels voldoet | Communicatiemedewerkers | Workflow | Je wilt zien hoe een app zichzelf controleert voordat iets naar buiten gaat |
| Toetsweekplanner (04) | Maakt met een leerling een studieplan voor de toetsweek en levert Excel en agendabestand | Mentoren, leerlingen (na DPIA) | Agent Console | Je wilt zien wat een agent kan dat een workflow niet kan: zelf bepalen hoe, en bestanden maken |
| Transcriptietool (05) | Zet een opname van een overleg om in een verslag met besluiten en actiepunten | Secties, teams | Workflow met tool | Je wilt een bestand als invoer en een tool (spraak naar tekst) in een workflow |
| Lesmateriaal-check (06) | Beoordeelt lesmateriaal op toegankelijkheid (UDL), maakt versies voor docent en leerling, zoekt open leermateriaal op Wikiwijs en koppelt aan SLO-leerdoelen | Docenten, ondersteuningscoördinatoren | Agent Console met twee eigen tools | Je wilt een eigen tool maken van een website met een API, met en zonder sleutel |
| Studiecoach biologie (08) | Helpt een leerling met uitleg, hints en planning bij ecologie; stuurt persoonlijke vragen door naar de docent | Docenten, leerlingen (na DPIA) | Chatflow | Je wilt een gesprek met routes, geheugen en een mens in de lus |
De volgorde is ook een leerlijn: 01 en 02 in het eerste uur van de workshop, 03 en 07 als je een team wilt helpen, 05 en 08 als je een vak wilt bedienen, 04 en 06 als je wilt weten wat de Agent Console toevoegt.
Voorbeeld-apps
De apps uit de handleidingen staan live om uit te proberen:
- Tekst op niveau (01): https://udify.app/workflow/eINp9Jdd6ICodDZF
- Schoolgids-assistent (02, met Balie-stand uit 03): https://udify.app/chat/cvLAmpk60m9HUXUy
- Ouderbrief-assistent (03): https://udify.app/chat/OJCfxjBeBHCEbBPx
- Schoolnieuws (03 en 07): https://udify.app/workflow/jJclFyX9BlteuHYi
- Toetsweekplanner (04): https://udify.app/agent/rKoqw8rbmp0IF86Q
- Transcriptietool (05): https://udify.app/workflow/7N5dNg8fD9qXHA80
- Lesmateriaal-check (06): https://udify.app/agent/lkWKedkSW2d3nqBV
- Studiecoach biologie (08): https://udify.app/chat/fP0TJW3s8IXOj9BO
Video's
Bij elke handleiding hoort een uitlegvideo van 5 tot 10 minuten (handleiding 3 en 8 in twee delen) (video-*.mp4 in de map, met
ondertitels ingesloten en apart als .srt): de schermafbeeldingen uit de handleiding, verteld
door een Nederlandse computerstem, als lossere vertelling van dezelfde stappen en valkuilen.
De tekst staat in video-script.md in elke map (bij 03 en 08: video-script-1.md en -2.md). De video's zijn gebouwd met maak_video.py uit
de Copilot-reeks (https://git.lexconsultancy.nl/guido/copilot-handleidingen, map _gereedschap;
ffmpeg, Pillow, edge-tts).
| Video | Duur |
|---|---|
| 01 Tekst op niveau | 8,5 min |
| 02 De Schoolgids-assistent | 8,5 min |
| 03 Schoolcommunicatie, deel 1: schrijfwijzer, Ouderbrief-assistent en Balie-stand | 7 min |
| 03 Schoolnieuws, deel 2: één formulier, drie berichten | 5 min |
| 04 De Toetsweekplanner | 9 min |
| 05 De Transcriptietool | 8,5 min |
| 06 De Lesmateriaal-check | 10 min |
| 07 Schoolnieuws met controle | 9,5 min |
| 08 De Studiecoach, deel 1: vraagherkenning, geheugen en drie routes | 8,5 min |
| 08 De Studiecoach, deel 2: een mens in de lus en publiceren | 4,5 min |
Apps installeren in je eigen Dify
Elke Studio-app staat ook als bestand in de map van zijn handleiding: <naam>.dify.yml. Dat is de
DSL-export van Dify. Zo zet je hem in je eigen werkruimte (online of zelf gehost):
- Download het
.dify.yml-bestand uit de map. - Ga in Dify naar Studio, klik Create en kies Import DSL file.
- Sleep het bestand in het venster en klik Create.
- Kies bij elke LLM-stap je eigen model (de export verwijst naar gpt-5-mini via OpenAI) en koppel bij Knowledge je eigen kennisbank; die reist niet mee. Maak hem eerst aan met het voorbeelddocument uit dezelfde map (handleiding 02, stap 1 tot 5).
- Publish.
De bestanden bevatten geen sleutels. Een Agent Console-app (04, 06) importeer je op dezelfde manier, maar vanaf de pagina Agents (Create, Import DSL file). De export van een agent noemt het geüploade bestand wel, maar bevat het niet: upload na het importeren de CSV of PDF uit de map van de handleiding opnieuw onder FILES. Voor 06 maak je eerst de twee eigen tools aan (Integrations, Swagger API as Tool, schema's uit de map; de SLO-tool met je eigen sleutel) en zet je ze opnieuw onder TOOLS.
| Bestand | Handleiding |
|---|---|
| 01-workflow/tekst-op-niveau.dify.yml | 01 |
| 02-agent-kennisbank/schoolgids-assistent.dify.yml | 02 (inclusief de Balie-stand uit 03) |
| 03-schoolcommunicatie/ouderbrief-assistent.dify.yml | 03 |
| 03-schoolcommunicatie/schoolnieuws.dify.yml | 03 en 07 (versie 2, met Controleur en Poortwachter) |
| 04-agent-console/toetsweekplanner.dify.yml | 04 (Agent Console; toetsrooster-voorbeeld.csv opnieuw uploaden) |
| 05-transcriptietool/transcriptietool.dify.yml | 05 |
| 06-inclusief-lesmateriaal/lesmateriaal-check.dify.yml | 06 (Agent Console; tools opnieuw aanmaken, lesbrief opnieuw uploaden) |
| 08-chatflow-studiecoach/studiecoach-biologie.dify.yml | 08 |
Zelf bouwen of bewerken
Elke map heeft dezelfde opbouw:
handleiding-*.md bron (bewerk deze)
beelden/ screenshots, genummerd in volgorde
build.py maakt .html, .pdf en .docx uit de .md: python3 build.py
python3 _gereedschap/bouw_alles.py bouwt alles tegelijk; python3 00-presentatie/build.py
bouwt de dia's en de PDF van de presentatie. Nodig: python3 met markdown, google-chrome en libreoffice.
Een presentatie als PowerPoint: python3 _gereedschap/maak_pptx.py <dia-pdf> in de map van die
presentatie. Elke dia komt als beeld op een 16:9-slide en de sprekersnotities komen in het
notitieveld, zodat PowerPoint ze in de sprekersweergave toont terwijl de zaal alleen de dia ziet.
De tekst is dan niet meer te bewerken in PowerPoint: wijzigen doe je in maak_dias.py en daarna
opnieuw bouwen. Een notitieversie als PDF (dia plus notities op één A4) maakt
bouw_notities_pdf.py in de map van de presentatie.
De PDF's staan naast de bronnen in git; HTML en Word maak je zelf met build.py.
Opmaak in de bronnen: genummerde lijst = handelingen, tabel "Wat je intypt" = veldwaarden,
codeblok = letterlijk overtypen (label "Intypen"), oranje kader = valkuil, groen kader = "Zelf kiezen"
(blockquote die met Zelf kiezen begint). Opmaak en logo's staan in _gereedschap/build_handleiding.py;
vervang de logo's door die van je eigen school of netwerk.
Engelse editie (LeX Consultancy, internationale open bronnen): https://git.lexconsultancy.nl/guido/dify-guides Dezelfde apps in Microsoft 365 Copilot (Agent Builder): https://git.lexconsultancy.nl/guido/copilot-handleidingen en als Gems in Google Gemini: https://git.lexconsultancy.nl/guido/gemini-handleidingen Dezelfde apps als Custom GPT's in ChatGPT: https://git.lexconsultancy.nl/guido/chatgpt-handleidingen