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 zoektool voor open leermateriaal) | Docenten, ondersteuningscoördinatoren | 27 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 uur): programma, werkvormen, valkuilen per blok | Begeleiders | 8 pp. |
| 00-presentatie | Presentatie bij de workshop: PDF, bron van de dia's en sprekersnotities | Begeleiders | 22 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. |
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 en zoekt open leermateriaal op Wikiwijs | Docenten, ondersteuningscoördinatoren | Agent Console met eigen tool | Je wilt een eigen tool maken van een website met een API |
| 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
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.
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.