dify-handleidingen/CHANGELOG.md

# Wijzigingen

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-22, link en QR-code naar alle vier de reeksen

- De slotdia van de drie presentaties heeft een QR-code naar https://git.lexconsultancy.nl/guido,
  de overzichtspagina met alle vier de reeksen, met het bijschrift "Alle vier de reeksen".
- De bronvermelding wijst niet meer naar deze ene repository maar naar die overzichtspagina.
- De dia's over wat je meeneemt en hoe je verder komt noemen het adres nu voluit.

## 2026-09-22, presentaties ook als PowerPoint

- `_gereedschap/maak_pptx.py`: maakt van een gebouwde presentatie een pptx met elke dia als beeld
  en de sprekersnotities in het notitieveld, voor de sprekersweergave van PowerPoint.
- `00-sessie` en `00-lezing` hebben nu ook een `.pptx`. Die van de workshop staat niet in git,
  omdat daar de privé begeleidersnotities in zitten.

## 2026-09-22, sessie Van voorbeeld naar je eigen project

- Nieuwe map `00-sessie`: een presentatie van 2 x een uur voor een gemengd publiek. Eerste uur
  inhoud (wat is een agent, wat niet, hoeveel ruimte geef je het model), een interactieblok met
  drie stellingen, en vier live demo's uit de acht voorbeeld-apps. Tweede uur: de ontwerpkaart
  voor een eigen project, met bouwen als optie, pitches, wat mag, en hoe je verder komt.
- Vier interactiemomenten en 35 minuten waarin deelnemers zelf werken; geen laptops nodig om
  mee te doen.
- Inclusief notitieversie (per dia een A4 met beeld en sprekersnotities).

## 2026-09-22, materiaal voor wie de workshop leidt

- `00-workshop/regiekaart.md` en `.pdf`: het hele programma op één kaart naast je laptop, met de
  schrapvolgorde bij tijdnood, de vier zinnen die moeten vallen en wat je doet als iets misgaat.
- `00-presentatie/bouw_notities_pdf.py`: maakt een notitieversie van de presentatie, per dia een
  A4 met het beeld en de sprekersnotities eronder. Nodig omdat een PDF op volledig scherm geen
  sprekersweergave heeft. De versie met de privénotities staat niet in git.

## 2026-09-22, losse lezing Wat is een AI-agent

- Nieuwe map `00-lezing`: een presentatie van twintig minuten voor een teamvergadering of bestuur,
  met drie interactiemomenten en zonder laptops. Twaalf dia's: peiling, drie lagen, wat een agent
  is, wat het niet is, drie voorbeelden van school, waar de mens hoort, de vier omgevingen naast
  elkaar, wat mag, AVG en AI Act, en hoe je maandag begint.
- Platformonafhankelijk: verwijst naar alle vier de reeksen handleidingen en de video's.

## 2026-09-22, wat een agent is, en het complete draaiboek

- Presentatie: twee dia's erbij (26 in totaal). "Wat is een agent?" (doel en regels, middelen,
  ruimte om te kiezen, met de Toetsweekplanner als voorbeeld) en "Wat een agent niet is"
  (geen mens, geen feitenmachine, geen programma, geen beslisser). Het landschapsblok groeit
  daarmee van 5 naar 10 minuten; de demo met de sabotage van 15 naar 10.
- Draaiboek: uitgebreid tot een draaiboek dat een ander kan draaien. In één oogopslag,
  voorbereiding in drie stappen, rolverdeling, schrapvolgorde bij tijdnood, techniek- en
  zaalsituaties, tien veelgestelde vragen, en drie bijlagen: alles om te plakken, links,
  en een afvinklijst. 18 pagina's.
- Alle dianummers in het draaiboek opnieuw gelijkgetrokken.

## 2026-09-22, vergelijkingsblok in de workshop

- Presentatie: twee dia's erbij (24 in totaal). "Dezelfde zes agents, vier omgevingen" zet Dify,
  Copilot Chat, ChatGPT en Gemini naast elkaar op acht punten; "Welke heeft jouw school" is een
  interactie met handen omhoog die terugkoppelt naar de ontwerpkaart.
- Draaiboek: het blok Vier omgevingen (7 minuten) toegevoegd na de pitches, met de tijden
  erachter opnieuw verdeeld; demo en pitches elk twee minuten korter, 15:30 blijft hard.
  Materiaallijst: de drie andere reeksen als PDF op de laptops. Nieuwe variant voor een school
  met alleen Microsoft of alleen Google.
- De dia's over wat mag en mee naar huis zijn verschoven (17 tot 22 werden 19 tot 24) en de
  slotdia noemt nu de vier reeksen en de 28 uitlegvideo's.

## 2026-09-21, uitlegvideo's

- Video 03 en 08 in twee delen geknipt (7 en 5, 8,5 en 4,5 minuten) in plaats van één lange.
- Bij elke handleiding een video van 8 tot 13 minuten met de schermafbeeldingen, een Nederlandse
  computerstem (nl-NL-FennaNeural) en ondertitels; tekst in `video-script.md` per map, gebouwd met
  `maak_video.py` uit de Copilot-reeks.

## 2026-09-21, DSL-bestanden

- Ook de agents van 04 en 06 als `.dify.yml` (Toetsweekplanner, Lesmateriaal-check); bestanden en eigen tools komen niet mee, zie de README.
- Handleiding 03, stap 4: de beschrijving van de kennisbank ingekort tot onder de 400 tekens, de grens die Dify zonder melding hanteert; de kennisbank zelf is bijgewerkt.
- Elke Studio-app staat als `.dify.yml` in de map van zijn handleiding, te importeren via Studio, Create, Import DSL file. Installatie-instructie in de README.

## 2026-09-20, eerste uitgave

- Handleidingen 04 (Agent Console: Toetsweekplanner) en 06 (Agent Console: Lesmateriaal-check met eigen Edurep-zoektool).
- 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), Dify zelf hosten (Docker op Windows, Mac, Linux).
- 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).