diff --git a/00-ai-tools/ai-tools-in-het-onderwijs.md b/00-ai-tools/ai-tools-in-het-onderwijs.md index e2e5ee2..4c9a558 100644 --- a/00-ai-tools/ai-tools-in-het-onderwijs.md +++ b/00-ai-tools/ai-tools-in-het-onderwijs.md @@ -1,12 +1,12 @@ # AI-tools in het onderwijs: wat er al is, en waar Dify past diff --git a/00-ontwerpkaart/ontwerpkaart.md b/00-ontwerpkaart/ontwerpkaart.md index bed343e..d9f9bec 100644 --- a/00-ontwerpkaart/ontwerpkaart.md +++ b/00-ontwerpkaart/ontwerpkaart.md @@ -1,5 +1,6 @@ # Vijf ontwerppatronen voor AI-agents, en hoe je ze in Dify bouwt diff --git a/00-workshop/draaiboek-workshop.md b/00-workshop/draaiboek-workshop.md index 58ecdd6..f6f0052 100644 --- a/00-workshop/draaiboek-workshop.md +++ b/00-workshop/draaiboek-workshop.md @@ -1,10 +1,11 @@ # Draaiboek workshop AI Agents met Dify diff --git a/00-workshop/presentatie/presentatie-workshop-ai-agents.pdf b/00-workshop/presentatie/presentatie-workshop-ai-agents.pdf index 62a7f63..8ac55a4 100644 Binary files a/00-workshop/presentatie/presentatie-workshop-ai-agents.pdf and b/00-workshop/presentatie/presentatie-workshop-ai-agents.pdf differ diff --git a/01-workflow/handleiding-dify.md b/01-workflow/handleiding-dify.md index d9b194f..cf2a243 100644 --- a/01-workflow/handleiding-dify.md +++ b/01-workflow/handleiding-dify.md @@ -1,21 +1,20 @@ # Bouwen in Dify: van workflow naar agent diff --git a/02-agent-kennisbank/handleiding-dify-agent.md b/02-agent-kennisbank/handleiding-dify-agent.md index 1319b48..12de89a 100644 --- a/02-agent-kennisbank/handleiding-dify-agent.md +++ b/02-agent-kennisbank/handleiding-dify-agent.md @@ -1,23 +1,21 @@ # Bouwen in Dify: een agent met eigen kennisbank diff --git a/03-schoolcommunicatie/handleiding-dify-schoolcommunicatie.md b/03-schoolcommunicatie/handleiding-dify-schoolcommunicatie.md index 7770393..f8a1454 100644 --- a/03-schoolcommunicatie/handleiding-dify-schoolcommunicatie.md +++ b/03-schoolcommunicatie/handleiding-dify-schoolcommunicatie.md @@ -1,19 +1,17 @@ # Bouwen in Dify: van opname naar verslag diff --git a/07-schoolnieuws-met-controle/handleiding-dify-schoolnieuws-met-controle.md b/07-schoolnieuws-met-controle/handleiding-dify-schoolnieuws-met-controle.md index 214b652..e745f16 100644 --- a/07-schoolnieuws-met-controle/handleiding-dify-schoolnieuws-met-controle.md +++ b/07-schoolnieuws-met-controle/handleiding-dify-schoolnieuws-met-controle.md @@ -1,20 +1,21 @@ # Schoolnieuws met controle: zelfkritiek en een poortwachter diff --git a/08-chatflow-studiecoach/handleiding-dify-studiecoach.md b/08-chatflow-studiecoach/handleiding-dify-studiecoach.md index 73d8e46..9d04070 100644 --- a/08-chatflow-studiecoach/handleiding-dify-studiecoach.md +++ b/08-chatflow-studiecoach/handleiding-dify-studiecoach.md @@ -1,19 +1,23 @@ diff --git a/CHANGELOG.md b/CHANGELOG.md index 3fd987d..6bb5791 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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). diff --git a/README.md b/README.md index 237fe65..e643a13 100644 --- a/README.md +++ b/README.md @@ -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.