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
+5 -5
View File
@@ -1,12 +1,12 @@
<!--
VOOR DE BEWERKER
Bijlage bij de serie Dify-handleidingen: overzicht van de AI-tools die in het onderwijs
al aanwezig zijn en hoe ze zich verhouden tot wat we in Dify bouwen. Geen beelden.
al aanwezig zijn en hoe ze zich verhouden tot wat je in Dify bouwt. Geen beelden.
Bouwen: python3 build.py
Stand van zaken: 20 september 2026. Bronnen die bij het schrijven zijn geraadpleegd:
sivon.nl/veelgestelde-vragen-over-ai, sivon.nl/toetsingskader (AI Toetsingskader Funderend
Onderwijs 1.0, 1 april 2026), kennisnet.nl (SURF-advies Microsoft 365 Copilot).
Bij een volgende workshop: de kolom "Stand in Nederland" opnieuw nalopen.
Stand van zaken: 20 september 2026. Geraadpleegde bronnen: sivon.nl/veelgestelde-vragen-over-ai,
sivon.nl/toetsingskader (AI Toetsingskader Funderend Onderwijs 1.0, 1 april 2026),
kennisnet.nl (SURF-advies Microsoft 365 Copilot). De kolom "Stand in Nederland" veroudert snel.
-->
# AI-tools in het onderwijs: wat er al is, en waar Dify past
+1
View File
@@ -1,5 +1,6 @@
<!--
VOOR DE BEWERKER
Losse A4 bij de serie Dify-handleidingen. Geen beelden. Bouwen: python3 build.py
STIJL: compact (kleinere letter, zie build_handleiding.py)
Bedoeld om uit te printen en met pen in te vullen vóór iemand in Dify gaat klikken.
@@ -1,12 +1,11 @@
<!--
VOOR DE BEWERKER
Bijlage bij de serie Dify-handleidingen: de vijf gangbare ontwerppatronen voor AI-agents
(single-shot, ReAct, planner-executor, reflexive, verifier-gated), in eigen woorden en
gekoppeld aan wat in Dify te bouwen is. Geen beelden; de schema's zijn tekst.
Bouwen: python3 build.py
Codeblokken met taal "schema" worden als tekstschema gezet (gestippeld kader, geen label Intypen).
De patroonnamen zijn algemeen vakjargon (onder meer in het overzicht "AI Agent Design Patterns"
van GenAI.works); de tekst hier is eigen werk.
-->
# Vijf ontwerppatronen voor AI-agents, en hoe je ze in Dify bouwt
+3 -2
View File
@@ -1,10 +1,11 @@
<!--
VOOR DE BEWERKER
Draaiboek voor de begeleider van de workshop AI Agents met Dify (2 uur). Geen beelden.
Bouwen: python3 build.py
De presentatie staat in presentatie/ (maak_dias.py bouwt de dia's, bouw_pdf.py de PDF;
22 dia's, sprekersnotities in project/slides/*.html; tijden van het Kennisfestival 23-09-2026). Bij een nieuwe versie van de handleidingen:
paginanummers in blok 2 en 4 nalopen.
22 dia's, sprekersnotities in project/slides/*.html). Bij een nieuwe versie van de
handleidingen: paginanummers in blok 2 en 4 nalopen.
-->
# Draaiboek workshop AI Agents met Dify
+7 -8
View File
@@ -1,21 +1,20 @@
<!--
VOOR DE BEWERKER
De screenshots staan in beelden/ en worden hieronder
met hun originele bestandsnaam aangeroepen. Zet dit bestand in diezelfde map,
dan kloppen de verwijzingen.
Handleiding 1: van workflow naar agent. Beelden staan in beelden/ en worden hieronder
met hun bestandsnaam aangeroepen; schermen vastgelegd op 20 september 2026 (Dify cloud).
Omzetten naar HTML, PDF en Word: python3 build.py
(gebruikt python-markdown, google-chrome en libreoffice; geen pandoc nodig)
(python-markdown, google-chrome en libreoffice; opmaak en logo in _gereedschap/build_handleiding.py)
Opmaakafspraken in dit bestand:
Opmaakafspraken (zie ook README.md):
- Genummerde lijst = handelingen (klikken, kiezen)
- Tabel "Wat je intypt" = waarden voor formuliervelden
- Codeblok (```) = tekst die letterlijk overgetypt wordt (label "Intypen")
- Blockquote (>) = tip of waarschuwing (oranje kader)
- Blockquote (>) = valkuil of tip (oranje kader)
- Blockquote die begint met **Zelf kiezen** = keuzemoment voor de deelnemer (groen kader)
Gedaan op 20 september 2026: alle screenshots nagelopen, geen account- of
persoonsgegevens in beeld (sandbox-account "Dify").
Gepubliceerde voorbeeld-app: https://udify.app/workflow/eINp9Jdd6ICodDZF
-->
# Bouwen in Dify: van workflow naar agent
@@ -1,23 +1,21 @@
<!--
VOOR DE BEWERKER
Bron van handleiding 2 (agent met kennisbank). Beelden staan in beelden/,
vastgelegd op 20 september 2026 via de Chrome-extensie op het sandbox-account
"Dify" (workspace "Dify's Workspace"), venster 1800x907 CSS-px, uitvoer 1556x784.
Handleiding 2: agent met eigen kennisbank. Beelden in beelden/, vastgelegd op
20 september 2026 (Dify cloud).
Omzetten naar HTML, PDF en Word: python3 build.py
(zelfde script als handleiding 1; python-markdown, google-chrome, libreoffice)
(python-markdown, google-chrome en libreoffice; opmaak en logo in _gereedschap/build_handleiding.py)
Opmaakafspraken (gelijk aan handleiding 1):
Opmaakafspraken (zie ook README.md):
- Genummerde lijst = handelingen (klikken, kiezen)
- Tabel "Wat je intypt" = waarden voor formuliervelden
- Codeblok (```) = tekst die letterlijk overgetypt wordt (label "Intypen")
- Blockquote (>) = tip of waarschuwing (oranje kader)
- Blockquote (>) = valkuil of tip (oranje kader)
- Blockquote die begint met **Zelf kiezen** = keuzemoment voor de deelnemer (groen kader)
Testdocument: schoolgids-voorbeeldcollege.pdf (fictief, in deze map).
Gepubliceerde voorbeeld-app: https://udify.app/chat/cvLAmpk60m9HUXUy
Op het account staat ook een lege agent "Schoolgids-assistent" in de Agent
Console (bèta), aangemaakt om die route te beoordelen; mag weg.
-->
# Bouwen in Dify: een agent met eigen kennisbank
@@ -1,19 +1,17 @@
<!--
VOOR DE BEWERKER
Bron van handleiding 3 (schoolcommunicatie, Het Voorbeeldcollege). Beelden staan in
beelden/, vastgelegd op 20 september 2026 via de Chrome-extensie op het sandbox-account
"Dify" (workspace "Dify's Workspace"). Beeldformaten wisselen (1512x793 en 1555x784);
het bouwscript schaalt op breedte. In a01-a04, b04 en c06 zijn namen van een eerder,
vervallen voorbeeld weggepoetst met een egaal vlak.
Handleiding 3: schoolcommunicatie op Het Voorbeeldcollege (fictief). Beelden in beelden/,
vastgelegd op 20 september 2026 (Dify cloud).
Omzetten naar HTML, PDF en Word: python3 build.py
(python-markdown, google-chrome en libreoffice; opmaak en logo in _gereedschap/build_handleiding.py)
Opmaakafspraken (gelijk aan handleiding 1 en 2):
Opmaakafspraken (zie ook README.md):
- Genummerde lijst = handelingen (klikken, kiezen)
- Tabel "Wat je intypt" = waarden voor formuliervelden
- Codeblok (```) = tekst die letterlijk overgetypt wordt (label "Intypen")
- Blockquote (>) = valkuil (oranje kader)
- Blockquote (>) = valkuil of tip (oranje kader)
- Blockquote die begint met **Zelf kiezen** = keuzemoment voor de deelnemer (groen kader)
Testdocument: schrijfwijzer-voorbeeldcollege.pdf (fictief, in deze map); de schoolgids
@@ -1,25 +1,24 @@
<!--
VOOR DE BEWERKER
Handleiding 05: Transcriptietool, naar use case UC-2026-009 van de Experimenteerruimte
ICT SOML (Guido Merry, Grescollege). Beelden in beelden/, vastgelegd op 20 september
2026 via de Chrome-extensie op het sandbox-account "Dify" met eigen OpenAI-sleutel
(Gebruiksprioriteit: API-sleutel). Twee vensterformaten: 1512x793 en 1568x766;
build.py schaalt op breedte, dus dat valt niet op.
Handleiding 5: transcriptietool, naar use case UC-2026-009 van de Experimenteerruimte
ICT SOML. Beelden in beelden/, vastgelegd op 20 september 2026 (Dify cloud, eigen OpenAI-sleutel).
Omzetten naar HTML, PDF en Word: python3 build.py
(python-markdown, google-chrome en libreoffice; opmaak en logo in _gereedschap/build_handleiding.py)
Opmaakafspraken:
Opmaakafspraken (zie ook README.md):
- Genummerde lijst = handelingen (klikken, kiezen)
- Tabel "Wat je intypt" = waarden voor formuliervelden
- Codeblok (```) = tekst die letterlijk overgetypt wordt (label "Intypen")
- Blockquote (>) = tip of waarschuwing (oranje kader)
- Blockquote (>) = valkuil of tip (oranje kader)
- Blockquote die begint met **Zelf kiezen** = keuzemoment voor de deelnemer (groen kader)
Bestanden in deze map:
sectieoverleg-script.txt het fictieve overleg (500 woorden)
sectieoverleg-opname.mp3 voorgelezen door OpenAI tts-1, stem Alloy, 3:01, 128 kbps (te groot voor de tool)
sectieoverleg-opname-klein.mp3 zelfde opname, 32 kbps mono 16 kHz, 707 kB (deze gebruiken)
Gepubliceerde app: https://udify.app/workflow/7N5dNg8fD9qXHA80
Gepubliceerde voorbeeld-app: https://udify.app/workflow/7N5dNg8fD9qXHA80
-->
# Bouwen in Dify: van opname naar verslag
@@ -1,20 +1,21 @@
<!--
VOOR DE BEWERKER
Bron van handleiding 7 (zelfkritiek en poortwachter, vervolg op handleiding 3).
Beelden in beelden/, vastgelegd op 20 september 2026 via de Chrome-extensie op het
sandbox-account "Dify" (vensters 1468x715, 1568x764 en 1512x794; het bouwscript
schaalt op breedte). Beeld 35 is een verkleinde opname (0,6).
Handleiding 7: zelfkritiek en poortwachter, vervolg op handleiding 3. Beelden in beelden/,
vastgelegd op 20 september 2026 (Dify cloud).
Omzetten naar HTML, PDF en Word: python3 build.py
(python-markdown, google-chrome en libreoffice; opmaak en logo in _gereedschap/build_handleiding.py)
Opmaakafspraken: zie handleiding 1 t/m 3 (genummerde lijst = handelingen, tabel
"Wat je intypt", codeblok = Intypen, blockquote = valkuil, **Zelf kiezen** = groen kader).
De Python-code voor de Poortwachter is bij het bouwen via de browserconsole in de
Monaco-editor gezet (typen met auto-inspringing gaat mis); deelnemers plakken hem
gewoon met Ctrl+V.
Opmaakafspraken (zie ook README.md):
- Genummerde lijst = handelingen (klikken, kiezen)
- Tabel "Wat je intypt" = waarden voor formuliervelden
- Codeblok (```) = tekst die letterlijk overgetypt wordt (label "Intypen")
- Blockquote (>) = valkuil of tip (oranje kader)
- Blockquote die begint met **Zelf kiezen** = keuzemoment voor de deelnemer (groen kader)
Gepubliceerde app (versie 2 van Schoolnieuws): https://udify.app/workflow/jJclFyX9BlteuHYi
De Python-code voor de Poortwachter staat in de tekst; deelnemers plakken hem met Ctrl+V in de Code-node.
Gepubliceerde voorbeeld-app (versie 2 van Schoolnieuws): https://udify.app/workflow/jJclFyX9BlteuHYi
-->
# Schoolnieuws met controle: zelfkritiek en een poortwachter
@@ -1,19 +1,23 @@
<!--
VOOR DE BEWERKER
Bron van handleiding 8 (Chatflow: Studiecoach biologie 3 havo). Beelden in beelden/,
vastgelegd op 20 september 2026 via de Chrome-extensie op het account "Dify's Workspace"
(Professional). Vensters wisselen (1568x715, 1480x675, 1461x812); het bouwscript schaalt.
In e04, e05, f05 en f06 is het accountmailadres weggepoetst.
Handleiding 8: Chatflow, Studiecoach biologie 3 havo. Beelden in beelden/, vastgelegd op
20 september 2026 (Dify cloud).
Omzetten naar HTML, PDF en Word: python3 build.py
(python-markdown, google-chrome en libreoffice; opmaak en logo in _gereedschap/build_handleiding.py)
Lesmateriaal maken (studiewijzer + lesbrief, fictief): python3 maak_materiaal.py
stercollectie-voedselweb-hv3.pdf is de PDF-export van maken.wikiwijs.nl/157495
(VO-content, CC BY-SA 4.0), gedownload op 20-09-2026.
(VO-content, CC BY-SA 4.0).
Opmaakafspraken: zie handleiding 1 t/m 3.
Opmaakafspraken (zie ook README.md):
- Genummerde lijst = handelingen (klikken, kiezen)
- Tabel "Wat je intypt" = waarden voor formuliervelden
- Codeblok (```) = tekst die letterlijk overgetypt wordt (label "Intypen")
- Blockquote (>) = valkuil of tip (oranje kader)
- Blockquote die begint met **Zelf kiezen** = keuzemoment voor de deelnemer (groen kader)
Gepubliceerde app: https://udify.app/chat/fP0TJW3s8IXOj9BO
Gepubliceerde voorbeeld-app: https://udify.app/chat/fP0TJW3s8IXOj9BO
Kennisbank: Biologie 3 havo ecologie (3 documenten).
-->
+4 -10
View File
@@ -3,15 +3,9 @@
Dify verandert snel. Elke handleiding vermeldt op de titelpagina op welke dag de schermen zijn
vastgelegd. Hier staat per uitgave wat er veranderde.
## 2026-09-20, uitgave 2
## 2026-09-20, eerste uitgave
- Presentatie van de workshop toegevoegd (00-workshop/presentatie: 22 dia's als PDF, bron en sprekersnotities erbij).
- Licentie op alles: CC BY-SA 4.0 voor documenten, dia's en beelden, MIT voor de scripts. Elk document en de
slotdia dragen een colofon met licentie, eigenaar en contact.
## 2026-09-20, uitgave 1
- Handleidingen 01, 02, 03, 05, 07 en 08, elk met "Zelf kiezen"-kaders en "Maak hem van jou".
- Handleidingen 01, 02, 03, 05, 07 en 08, met "Zelf kiezen"-kaders en "Maak hem van jou".
- Bijlagen: ontwerpkaart, ontwerppatronen, AI-tools in het onderwijs (met AVG, AI Act en EU-kaders).
- Draaiboek van de workshop AI Agents met Dify.
- Schermen vastgelegd op Dify cloud van 20 september 2026 (Studio met Chatflow, Human Input, Agent Console bèta).
- Draaiboek en presentatie (22 dia's) van de workshop AI Agents met Dify.
- Vastgelegd op Dify cloud van 20 september 2026 (Studio met Chatflow, Human Input, Agent Console bèta).
+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.