guido/dify-handleidingen
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Uitgave 2: licentie op alles, presentatie erbij, README kaal

Browse Source 
- CC BY-SA 4.0 voor documenten, dia's en beelden, MIT voor scripts; colofon met
  eigenaar en contact in elk gebouwd document en op de slotdia
- Presentatie (22 dia's) als bron, PDF en sprekersnotities in 00-workshop/presentatie
- README en CHANGELOG zonder procesnotities; instructieblokken heten Voor de bewerker
- Lokaal extractiescript uit de uitgave gehaald

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido van Dijk
2026-09-20 20:40:31 +02:00
parent 659e4c7e76
commit a47195722d
46 changed files with 887 additions and 131 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+51 -60
View File
@@ -1,73 +1,64 @@
# Dify-handleidingen
Gemaakt door LeX Consultancy B.V. met Claude Code, screenshots via de Chrome-extensie
op het Dify-sandboxaccount "Dify". Elke map heeft dezelfde opbouw:
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.
handleiding-*.md bron (bewerk deze)
beelden/ screenshots, genummerd in volgorde
build.py maakt .html, .pdf en .docx uit de .md (python3 build.py);
roept _gereedschap/build_handleiding.py aan, dat het logo van
AI Netwerk Limburg op de titelpagina en in de voet zet
handleiding-*.pdf uitdeelversie
handleiding-*.docx bewerkbare versie (tabellen en kaders als Word-tabellen)
## Inhoud
| Map | Titel | Voor wie | Status |
| --- | --- | --- | --- |
| 01-workflow | Bouwen in Dify: van workflow naar agent | Deelnemers workshop AI Agents, Kennisfestival | klaar, 20-09-2026; met Zelf kiezen-kaders en Maak hem van jou |
| 02-agent-kennisbank | Bouwen in Dify: een agent met eigen kennisbank | Deelnemers workshop, deel 2 | klaar, 20-09-2026; met Zelf kiezen-kaders en Maak hem van jou |
| 03-schoolcommunicatie | Dify voor schoolcommunicatie: Het Voorbeeldcollege | Deelnemers workshop, teams communicatie | klaar, 20-09-2026 (34 pp.); apps live, zie links hieronder |
| 04-agent-console | Bouwen in de Agent Console: Toetsweekplanner (UC-2026-008) | Experimenteerruimte ICT SOML | agent gebouwd en gepubliceerd, handleiding nog te schrijven |
| 05-transcriptietool | Bouwen in Dify: van opname naar verslag (UC-2026-009) | Experimenteerruimte ICT SOML | klaar, 20-09-2026; met Zelf kiezen-kaders en Maak hem van jou |
| 06-inclusief-lesmateriaal | Agent Console: lesmateriaal beoordelen en aanpassen voor leerlingen met ondersteuning (UDL, open leermateriaal); zelfde vak en materiaal als 08 (lesbrief-ecologie.pdf en stercollectie-voedselweb-hv3.pdf staan al in de map) | Docenten, ondersteuningscoördinatoren | nog te bouwen |
| 07-schoolnieuws-met-controle | Schoolnieuws met controle: zelfkritiek (Controleur) en poortwachter (Code + IF/ELSE), vervolg op 03 | Deelnemers workshop, teams communicatie | klaar, 20-09-2026 (26 pp.); Schoolnieuws is nu versie 2 |
| 08-chatflow-studiecoach | Studiecoach biologie 3 havo (Chatflow): Question Classifier met vier routes, Memory, Human Input via e-mail naar de docent; lesbrief en studiewijzer fictief, plus Stercollectie-module (VO-content, CC BY-SA 4.0) | Docenten, deelnemers workshop | klaar, 20-09-2026 (45 pp.); app live, Debug Mode op de docentmail staat aan |
| 00-workshop | Draaiboek workshop AI Agents met Dify (2 uur): programma, werkvormen, valkuilen per blok, varianten; presentatie als artifact https://claude.ai/artifact/BWBzJaP1yE3f7auhdvsUTk (22 slides met sprekersnotities; festivaltijden 23-09-2026: 13:00-14:00 en 14:15-15:30) | Begeleider | klaar, 20-09-2026 |
| 00-ontwerppatronen | Vijf ontwerppatronen voor AI-agents (één aanroep, ReAct, plannen en uitvoeren, zelfkritiek, poortwachter) en hoe je ze in Dify bouwt | Alle deelnemers | klaar, 20-09-2026 (5 pp.) |
| 00-ontwerpkaart | Ontwerpkaart: één A4 om je eigen app te ontwerpen voordat je klikt | Alle deelnemers | klaar, 20-09-2026 (1 A4, uitprinten) |
| 00-ai-tools | AI-tools in het onderwijs: Copilot, Gemini, ChatGPT, Claude, Mistral, DeepSeek, Grok en de EU-opties; wat zit er al in school, wat mag (AVG, AI Act), de EU-competentiekaders, en hoe verhoudt het zich tot Dify | Alle deelnemers | klaar, 20-09-2026 (10 pp.); kolom Stand in Nederland bij elke workshop opnieuw nalopen |
| 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 |
Afspraken uit het gesprek van 20-09-2026 (Guido):
- Geen MOVARE meer in de serie; het voorbeeld is overal Het Voorbeeldcollege (fictief).
- Elke handleiding krijgt per stap een groen kader "Zelf kiezen" (wat je kunt vervangen door eigen
materiaal, stijl of prompt) en een slothoofdstuk "Maak hem van jou": tabel met aanpaspunten van
makkelijk naar moeilijk, drie opdrachten, checklist eigen materiaal (geen persoonsgegevens,
eigenaar, publiceren of niet).
- De ontwerpkaart is een los A4: gebruiker, wat erin, wat eruit, regels, waaraan zie je dat het werkt.
In voorbereiding: 04 Toetsweekplanner (Agent Console) en 06 Lesmateriaal beoordelen en aanpassen
voor leerlingen met ondersteuning (UDL, open leermateriaal).
Account: sinds 20-09-2026 (avond) **Professional** ($59/maand: 50 apps, 5.000 credits per maand, 3 teamleden).
De handleidingen blijven geschreven voor deelnemers met een gratis sandbox-account (5 apps, 200 credits,
1 bestand per upload); waar dat verschil telt, staat het erbij. OpenAI loopt via eigen sleutel
(Gebruiksprioriteit API-sleutel).
Voorbeeld-apps om te proberen (gebouwd volgens de handleidingen):
Gepubliceerde voorbeeld-apps:
- Tekst op niveau (01): https://udify.app/workflow/eINp9Jdd6ICodDZF
- Schoolgids-assistent (02, 03): https://udify.app/chat/cvLAmpk60m9HUXUy
- Ouderbrief-assistent (03): https://udify.app/chat/OJCfxjBeBHCEbBPx
- Schoolnieuws met controle (03, 07): https://udify.app/workflow/jJclFyX9BlteuHYi
- Transcriptietool (05): https://udify.app/workflow/7N5dNg8fD9qXHA80
- Studiecoach biologie (08): https://udify.app/chat/fP0TJW3s8IXOj9BO
- 01: https://udify.app/workflow/eINp9Jdd6ICodDZF (Tekst op niveau)
- 02: https://udify.app/chat/cvLAmpk60m9HUXUy (Schoolgids-assistent)
- 03: https://udify.app/chat/OJCfxjBeBHCEbBPx (Ouderbrief-assistent)
https://udify.app/workflow/jJclFyX9BlteuHYi (Schoolnieuws: website, ouderapp, social; sinds 07 met Controleur en Poortwachter)
https://udify.app/chat/cvLAmpk60m9HUXUy (Schoolgids-assistent met Balie-stand, zelfde app als 02)
- 08: https://udify.app/chat/fP0TJW3s8IXOj9BO (Studiecoach biologie; kennisbank Biologie 3 havo ecologie, 3 documenten)
- 04: https://udify.app/agent/Ny9Pw03BNSpvR6lI (Toetsweekplanner, Agent Console, gpt-5.4)
- 05: https://udify.app/workflow/7N5dNg8fD9qXHA80 (Transcriptietool)
## Gebruik
Opmaakafspraken in alle handleidingen: genummerde lijst = handelingen, tabel "Wat je intypt"
= veldwaarden, grijs kader "Intypen" = letterlijk overtypen, oranje kader = valkuil,
groen kader = "Zelf kiezen" (blockquote die met **Zelf kiezen** begint). Een los A4 krijgt
"STIJL: compact" in het commentaarblok bovenin (kleinere letter).
Geen em-dashes. Knopnamen in de taal van het scherm.
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:
_gereedschap/build_handleiding.py is het gedeelde bouwscript (opmaak, logo, PDF, Word);
logo-ai-netwerk-limburg.png staat ernaast. Wijzig de opmaak daar, niet per map.
```bash
python3 build.py
```
_gereedschap/extract.py haalt screenshots uit een Claude Code-sessietranscript
(de Chrome-extensie schrijft ze niet naar schijf). Sessiepad in het script aanpassen.
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.
## Publiceren
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.
- Bron: deze map is een git-repository (git.lexconsultancy.nl, spiegel op GitHub mogelijk). Gebouwde
bestanden (.pdf, .docx, .html) staan niet in git; maak ze met `python3 build.py` in elke map, of met
`python3 _gereedschap/bouw_alles.py` voor alles tegelijk.
- Licentie: CC BY-SA 4.0, zie LICENSE.md. Logo van AI Netwerk Limburg uitgezonderd.
- Vindplaats voor deelnemers: pagina op ai-netwerk-limburg.nl met de PDF's; Wikiwijs-arrangement na het festival.
- De live udify-apps draaien op het account en de OpenAI-sleutel van LeX Consultancy. Na een workshop:
Toegangspunt → Webapp uitzetten, of een maandlimiet op de sleutel.
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