Guido van Dijk
dc81e1a067
- In een oogopslag, dagvoorbereiding (dag ervoor, uur vooraf, vijf minuten) en rolverdeling - Als het misgaat: schrapvolgorde bij tijdnood, techniek en zaalsituaties - Vragen die altijd komen: tien vragen met een kort antwoord - Bijlage A alles om te plakken, B links en reeksen, C afvinklijst - Na afloop aangevuld; 17 paginas 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): programma, werkvormen, valkuilen per blok, en het vergelijkingsblok met Copilot, ChatGPT en Gemini | Begeleiders | 9 pp. |
| 00-presentatie | Presentatie bij de workshop: PDF, bron van de dia's en sprekersnotities | Begeleiders | 24 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.
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