Files
dify-handleidingen/README.md
T
2026-09-20 21:46:31 +02:00

6.3 KiB

Dify-handleidingen

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 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 22 pp.
03-schoolcommunicatie Dify voor schoolcommunicatie: ouderbrief, schoolnieuws, balie Teams communicatie 36 pp.
04-agent-console Bouwen in de Agent Console: de Toetsweekplanner (agent met bestand, tool en sandbox) Mentoren, Experimenteerruimte 27 pp.
05-transcriptietool Bouwen in Dify: van opname naar verslag Secties, teams 29 pp.
06-inclusief-lesmateriaal Bouwen in de Agent Console: de Lesmateriaal-check (UDL, eigen zoektool voor open leermateriaal) Docenten, ondersteuningscoördinatoren 27 pp.
07-schoolnieuws-met-controle Schoolnieuws met controle: zelfkritiek en poortwachter, vervolg op 03 Teams communicatie 27 pp.
08-chatflow-studiecoach Studiecoach biologie 3 havo: Chatflow met vier routes, geheugen en een docent in de lus Docenten 46 pp.
00-workshop Draaiboek van de workshop AI Agents met Dify (2 uur): programma, werkvormen, valkuilen per blok Begeleiders 8 pp.
00-presentatie Presentatie bij de workshop: PDF, bron van de dia's en sprekersnotities Begeleiders 22 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; in voorbeelden/ de ingevulde kaart van elk van de acht apps Iedereen 1 A4 + 8 voorbeelden
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.

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.

Waarvoor is welke app

Elke handleiding bouwt één app. Dit is waar ze voor bedoeld zijn en wanneer je welke kiest.

App Wat hij doet Voor wie Soort Kies deze als
Tekst op niveau (01) Herschrijft een tekst naar een gekozen doelgroep of taalniveau Docenten, communicatie Workflow Je wilt leren wat een workflow is: vaste stappen, één invoer, één uitvoer
Schoolgids-assistent (02) Beantwoordt vragen van ouders en leerlingen uit de schoolgids, met bronvermelding Balie, mentoren, ouders Agent met kennisbank Je hebt een document waar steeds dezelfde vragen over komen
Ouderbrief-assistent (03) Schrijft een ouderbrief in de stijl van de school, op basis van de schrijfwijzer Teams, teamleiders Agent met kennisbank Brieven moeten in één toon en één opmaak, door verschillende mensen
Schoolnieuws (03 en 07) Maakt van één bericht drie versies: website, ouderapp en social; in 07 met een controleur en een poortwachter die afkeurt wat niet aan de regels voldoet Communicatiemedewerkers Workflow Je wilt zien hoe een app zichzelf controleert voordat iets naar buiten gaat
Toetsweekplanner (04) Maakt met een leerling een studieplan voor de toetsweek en levert Excel en agendabestand Mentoren, leerlingen (na DPIA) Agent Console Je wilt zien wat een agent kan dat een workflow niet kan: zelf bepalen hoe, en bestanden maken
Transcriptietool (05) Zet een opname van een overleg om in een verslag met besluiten en actiepunten Secties, teams Workflow met tool Je wilt een bestand als invoer en een tool (spraak naar tekst) in een workflow
Lesmateriaal-check (06) Beoordeelt lesmateriaal op toegankelijkheid (UDL), maakt versies voor docent en leerling en zoekt open leermateriaal op Wikiwijs Docenten, ondersteuningscoördinatoren Agent Console met eigen tool Je wilt een eigen tool maken van een website met een API
Studiecoach biologie (08) Helpt een leerling met uitleg, hints en planning bij ecologie; stuurt persoonlijke vragen door naar de docent Docenten, leerlingen (na DPIA) Chatflow Je wilt een gesprek met routes, geheugen en een mens in de lus

De volgorde is ook een leerlijn: 01 en 02 in het eerste uur van de workshop, 03 en 07 als je een team wilt helpen, 05 en 08 als je een vak wilt bedienen, 04 en 06 als je wilt weten wat de Agent Console toevoegt.

Voorbeeld-apps

De apps uit de handleidingen staan live om uit te proberen:

Zelf bouwen of bewerken

Elke map heeft dezelfde opbouw:

handleiding-*.md      bron (bewerk deze)
beelden/              screenshots, genummerd in volgorde
build.py              maakt .html, .pdf en .docx uit de .md:  python3 build.py

python3 _gereedschap/bouw_alles.py bouwt alles tegelijk; python3 00-presentatie/build.py bouwt de dia's en de PDF van de presentatie. Nodig: python3 met markdown, google-chrome en libreoffice. De PDF's staan naast de bronnen in git; HTML en Word maak je zelf met build.py.

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's staan in _gereedschap/build_handleiding.py; vervang de logo's door die van je eigen school of netwerk.