# 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.

## 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 |

In voorbereiding: 04 Toetsweekplanner (Agent Console) en 06 Lesmateriaal beoordelen en aanpassen
voor leerlingen met ondersteuning (UDL, open leermateriaal).

Voorbeeld-apps om te proberen (gebouwd volgens de handleidingen):

- 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

## Gebruik

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:

```bash
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.

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