Uitgave kaal: alleen de materialen, geen procesnotities

- README: inhoud, voorbeeld-apps, bouwen en bewerken; geen status, afspraken of accountgegevens
- Instructieblokken in alle bronnen herschreven zonder werkwijze, vensters of namen
- CHANGELOG samengevoegd tot één uitgave

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido van Dijk
2026-09-20 20:41:31 +02:00
parent a47195722d
commit f082b57232
13 changed files with 102 additions and 114 deletions
+41 -47
View File
@@ -1,64 +1,58 @@
# Dify-handleidingen
Stapsgewijze handleidingen om zelf AI-apps en agents te bouwen in [Dify](https://cloud.dify.ai),
geschreven voor het onderwijs. Elke stap staat met een screenshot beschreven; alle voorbeelden spelen
op Het Voorbeeldcollege (fictief) en bevatten geen persoonsgegevens. Gemaakt door LeX Consultancy B.V.
voor AI Netwerk Limburg en de Experimenteerruimte ICT SOML.
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 |
| --- | --- | --- |
| 01-workflow | Bouwen in Dify: van workflow naar agent | Beginners |
| 02-agent-kennisbank | Bouwen in Dify: een agent met eigen kennisbank | Beginners, vervolg op 01 |
| 03-schoolcommunicatie | Dify voor schoolcommunicatie: ouderbrief, schoolnieuws en balie-assistent | Teams communicatie |
| 05-transcriptietool | Bouwen in Dify: van opname naar verslag | Secretariaat, teamleiders |
| 07-schoolnieuws-met-controle | Schoolnieuws met controle: zelfkritiek en poortwachter (Code en IF/ELSE), vervolg op 03 | Teams communicatie |
| 08-chatflow-studiecoach | Studiecoach biologie 3 havo (Chatflow): vier routes, geheugen, doorsturen naar de docent | Docenten |
| 00-workshop | Draaiboek en presentatie van de workshop AI Agents met Dify (2 uur, 22 dia's) | Begeleiders |
| 00-ontwerppatronen | Vijf ontwerppatronen voor AI-agents en hoe je ze in Dify bouwt | Iedereen |
| 00-ontwerpkaart | Ontwerpkaart: één A4 om je app te ontwerpen voordat je klikt | Iedereen |
| 00-ai-tools | AI-tools in het onderwijs: wat zit er al in school, wat mag (AVG, AI Act), de EU-competentiekaders | Iedereen |
| 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 | 21 pp. |
| 03-schoolcommunicatie | Dify voor schoolcommunicatie: ouderbrief, schoolnieuws, balie | Teams communicatie | 34 pp. |
| 05-transcriptietool | Bouwen in Dify: van opname naar verslag | Secties, teams | 28 pp. |
| 07-schoolnieuws-met-controle | Schoolnieuws met controle: zelfkritiek en poortwachter, vervolg op 03 | Teams communicatie | 26 pp. |
| 08-chatflow-studiecoach | Studiecoach biologie 3 havo: Chatflow met vier routes, geheugen en een docent in de lus | Docenten | 45 pp. |
| 00-workshop | Draaiboek en presentatie van de workshop AI Agents met Dify (2 uur, 22 dia's) | Begeleiders | 8 pp. + 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 | Iedereen | 1 A4 |
| 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. |
In voorbereiding: 04 Toetsweekplanner (Agent Console) en 06 Lesmateriaal beoordelen en aanpassen
voor leerlingen met ondersteuning (UDL, open leermateriaal).
In voorbereiding: 04 (Agent Console: Toetsweekplanner) en 06 (lesmateriaal beoordelen en
aanpassen voor leerlingen met ondersteuning; het lesmateriaal staat al in de map).
Voorbeeld-apps om te proberen (gebouwd volgens de handleidingen):
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.
## 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, 03): https://udify.app/chat/cvLAmpk60m9HUXUy
- Schoolgids-assistent (02, met Balie-stand uit 03): https://udify.app/chat/cvLAmpk60m9HUXUy
- Ouderbrief-assistent (03): https://udify.app/chat/OJCfxjBeBHCEbBPx
- Schoolnieuws met controle (03, 07): https://udify.app/workflow/jJclFyX9BlteuHYi
- Schoolnieuws (03 en 07): https://udify.app/workflow/jJclFyX9BlteuHYi
- Transcriptietool (05): https://udify.app/workflow/7N5dNg8fD9qXHA80
- Studiecoach biologie (08): https://udify.app/chat/fP0TJW3s8IXOj9BO
## Gebruik
## Zelf bouwen of bewerken
Elke map bevat de bron (`*.md`), de screenshots (`beelden/`) en `build.py`, dat er een PDF, een
Word-bestand en een HTML-pagina van maakt:
Elke map heeft dezelfde opbouw:
```bash
python3 build.py
```
handleiding-*.md bron (bewerk deze)
beelden/ screenshots, genummerd in volgorde
build.py maakt .html, .pdf en .docx uit de .md: python3 build.py
Voor alles tegelijk: `python3 _gereedschap/bouw_alles.py`. Nodig: python3-markdown, google-chrome
en libreoffice. De presentatie bouw je met `python3 00-workshop/presentatie/bouw_pdf.py`; de PDF
staat er al bij.
`python3 _gereedschap/bouw_alles.py` bouwt alles tegelijk; `python3 00-workshop/presentatie/bouw_pdf.py`
bouwt de dia's en de PDF van de presentatie. Nodig: python3 met `markdown`, google-chrome en libreoffice.
Gebouwde bestanden staan niet in git, behalve de presentatie-PDF en de fictieve testdocumenten.
Opmaak in de handleidingen: genummerde lijst = handelingen, tabel "Wat je intypt" = veldwaarden,
grijs kader "Intypen" = letterlijk overtypen, oranje kader = valkuil, groen kader "Zelf kiezen" =
wat je vervangt door eigen materiaal, stijl of prompt. Elke handleiding sluit af met "Maak hem van
jou": aanpaspunten van makkelijk naar moeilijk, opdrachten en een checklist voor eigen materiaal.
De handleidingen zijn geschreven voor een gratis Dify-sandbox (5 apps, 200 credits, 1 bestand per
upload) met een eigen OpenAI-sleutel en gpt-5-mini. Dify verandert snel; de titelpagina van elke
handleiding vermeldt de datum van de schermen, CHANGELOG.md wat er per uitgave veranderde.
## Licentie en contact
CC BY-SA 4.0 voor documenten, dia's en beelden, MIT voor de scripts; zie [LICENSE.md](LICENSE.md).
Het logo van AI Netwerk Limburg is uitgezonderd. Kopiëren, bewerken en hergebruiken mag, met
bronvermelding en onder dezelfde licentie.
Eigenaar en contact: Guido van Dijk, LeX Consultancy B.V. en AI Netwerk Limburg ·
guido@l-e-x.nl · guido@ai-netwerk-limburg.nl · https://ai-netwerk-limburg.nl
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 staan in `_gereedschap/build_handleiding.py`;
vervang het logo door dat van je eigen school of netwerk.