Ingevulde ontwerpkaart per app: hoofdstuk in elke handleiding en los A4 in 00-ontwerpkaart/voorbeelden

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-20 21:40:32 +02:00
parent 9d151d4fae
commit 820147eeb1
42 changed files with 633 additions and 12 deletions
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 1, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Tekst op niveau
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 1**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Workflow**, handleiding 1. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| Een docent Nederlands met een leestekst uit de methode die te moeilijk is voor de helft van 3 havo. Heeft tien minuten voor de les, wil niet zelf herschrijven. | De tekst (geplakt, veld Paragraph) en het niveau uit een lijstje: groep 7, brugklas, 3 havo, 5 vwo (veld Select). |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| De herschreven tekst op het gekozen niveau, met alle inhoud behouden en vakbegrippen uitgelegd in een bijzin; daaronder drie begripsvragen (feit, hoofdgedachte, toepassing) zonder antwoorden. | Korte zinnen, geen inhoud weglaten, geen vakbegrippen vervangen. Geen kennisbank nodig: de regels staan in de prompt van de twee LLM-stappen. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | Een alinea uit een aardrijkskundemethode, niveau brugklas | Kortere zinnen, zelfde feiten, drie vragen die over de tekst gaan |
+| 2 | Dezelfde alinea, niveau 5 vwo | Nauwelijks vereenvoudigd, vragen op analyseniveau |
+| 3 (de lastige) | Een tekst met een tabel met cijfers, niveau groep 7 | De cijfers blijven kloppen; de app verzint geen nieuwe getallen |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Workflow) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 2, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Schoolgids-assistent
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 2**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Agent met kennisbank**, handleiding 2. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| Een ouder die om 21:30 wil weten of zijn kind morgen met een ziekmelding naar de receptie moet of dat hij kan bellen. Heeft de schoolgids nooit gelezen. | Eén vraag in gewone taal, in de chat. Geen formulier. |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| Een antwoord van maximaal vijf zinnen in gewoon Nederlands, met het hoofdstuk van de schoolgids waar het uit komt. Of: "dat staat niet in de schoolgids, bel de receptie". | Alleen antwoorden uit de schoolgids in de kennisbank (schoolgids-voorbeeldcollege.pdf); niets verzinnen; bij twijfel doorverwijzen. Kennisbank: de schoolgids, geknipt per alinea. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | Hoe laat begint de eerste les? | Het juiste tijdstip, met verwijzing naar het hoofdstuk over lestijden |
+| 2 | Mag mijn kind een telefoon meenemen? | De telefoonregel uit de schoolgids, kort |
+| 3 (de lastige) | Wat is het salaris van de rector? | "Dat staat niet in de schoolgids" en een verwijzing naar de receptie |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Agent met kennisbank) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 3, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Ouderbrief-assistent
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 3**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Agent met kennisbank**, handleiding 3. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| Een mentor die om 16:00 nog een brief over de excursie van volgende week moet versturen en drie wollige alinea's heeft staan. Wil dat de brief klinkt als de school, niet als hemzelf. | De conceptbrief of losse zinnen, geplakt in de chat. Als de klas of de gevraagde actie ontbreekt, vraagt de agent ernaar. |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| De herschreven brief met onderwerpregel, in de stijl van de schrijfwijzer (B1, u-vorm, opbouw), en daaronder "Wat ik heb veranderd": maximaal vijf punten met de regel erbij. Ontbrekende feiten als [INVULLEN]. | De schrijfwijzer van Het Voorbeeldcollege (schrijfwijzer-voorbeeldcollege.pdf) in de kennisbank; geen data, namen of afspraken verzinnen; geen inleiding of compliment van de agent zelf. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | Wollige brief over een ouderavond | Korte brief met datum, tijd, plaats en wat de ouder moet doen; vijf verbeterpunten |
+| 2 | Twee losse zinnen zonder klas | De agent vraagt eerst voor welke klas de brief is |
+| 3 (de lastige) | Brief zonder datum van de excursie | [INVULLEN] op de plek van de datum, geen verzonnen datum |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Agent met kennisbank) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 4, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Toetsweekplanner
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 4**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Agent Console**, handleiding 4. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| Een leerling uit 2 havo, drie weken voor de toetsweek, die niet weet waar te beginnen. Heeft het rooster, een telefoon en 's avonds anderhalf uur. | Het toetsrooster (als bestand bij de agent: toetsrooster-voorbeeld.csv), de momenten waarop de leerling kan leren, en per vak makkelijk/gemiddeld/moeilijk. De agent vraagt ze één voor één. |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| Een plan per dag in de chat (blok, vak, tijd, stof) en twee bestanden uit de sandbox: studieplan.xlsx en studieplan.ics voor de telefoonagenda. Afsluitend de vraag of er iets verschoven moet worden. | Vijf planregels (moeilijke vakken dubbel, elk vak twee keer, blokken 25-45 min met pauze, avond voor de toets alleen herhalen, niets buiten de opgegeven momenten); geen cijfers of oordelen; niets bewaren. Tool: CurrentTime voor de datum. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | Rooster, momenten en moeilijkheid ingevuld | Plan dat aan alle vijf regels voldoet, plus xlsx en ics |
+| 2 | "Zet wiskunde op dinsdagavond" terwijl woensdag geschiedenis is | De agent legt uit waarom dat botst met de herhaalregel en biedt een alternatief |
+| 3 (de lastige) | "Ga ik mijn toets halen?" | Geen voorspelling; terug naar het plan |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Agent Console) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 5, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Transcriptietool
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 5**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Workflow met tool**, handleiding 5. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| De notulist van een sectieoverleg die het verslag altijd twee weken later pas af heeft. Heeft een mp3 van drie kwartier en een kwartier tijd. | Eén audiobestand (mp3, m4a of wav, maximaal 5 MB) via een bestandsveld. Voor het prototype alleen een fictieve, door een computerstem voorgelezen opname. |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| Een verslag met vijf kopjes (Overleg, Samenvatting, Besluiten, Actiepunten met eigenaar en datum, Doorgeschoven) en daaronder het volledige transcript. Onzekere namen met een vraagteken. | Geen echte opnames in Dify-cloud (privacykader); audio wissen na transcriptie; iemand leest het verslag na. Tool: Speech To Text met een eigen OpenAI-sleutel. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | De fictieve opname van drie minuten | Verslag met vijf kopjes, drie actiepunten met eigenaar |
+| 2 | Dezelfde opname als 128 kbps (te groot) | Foutmelding over de bestandsgrootte; verkleinen naar 32 kbps |
+| 3 (de lastige) | Een foto in plaats van audio | Het invoerveld weigert het bestand; alleen Audio staat aan |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Workflow met tool) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 6, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Lesmateriaal-check
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 6**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Agent Console met eigen tool**, handleiding 6. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| Een docent biologie met een lesbrief die voor een derde van de klas te talig is, en een ondersteuningscoördinator die vraagt "wat doe je voor de leerlingen met dyslexie?". Heeft een uur op de studiedag. | De lesbrief (als bestand bij de agent of meegestuurd in de chat) en de ondersteuningsbehoeften in de klas uit een lijst van zes (of "weet ik niet"). |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| Een rapport met zeven scores (zinslengte, begrippen, structuur, voorkennis, beeld, verwerking, keuze), drie bestanden (docent-notitie, leerlingversie toegankelijk, leerlingversie verdieping) en maximaal vijf open bronnen van Wikiwijs met licentie. | UDL: de vorm verandert, de stof en de leerdoelen niet; geen namen of diagnoses; licentie altijd vermelden, CC BY-SA delen onder dezelfde licentie. Eigen tool: Edurep zoeken (Swagger API). |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | De lesbrief ecologie, dyslexie en NT2 | Rapport, twee bestanden, vijf bronnen die echt in de zoekresultaten staan |
+| 2 | Dezelfde lesbrief, hoogbegaafd erbij | Derde bestand met verdiepingsvragen en een onderzoeksopdracht |
+| 3 (de lastige) | "Kun je Jayden apart een versie geven?" | Geen naam, geen persoonlijk advies; de versie is voor de hele klas |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Agent Console met eigen tool) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 7, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Schoolnieuws met controle
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 7**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Workflow met controleur en poortwachter**, handleiding 7. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| De communicatiemedewerker die elk bericht drie keer moet schrijven (website, ouderapp, social) en die geen tijd heeft om elke versie langs de schrijfwijzer te leggen. | Drie velden: de kernboodschap (wie, wat, waar, wanneer), de klas of afdeling, en de toon (informatief, feestelijk, dringend). |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| Bij goedkeuring: drie versies klaar om te plaatsen. Bij afkeuring: de drie concepten plus "Afgekeurd omdat" met de regels die overtreden zijn, voor de communicatiemedewerker. | De schrijfwijzer uit de kennisbank; de Controleur (tweede LLM) herschrijft de ouderapp-versie; de Poortwachter (Code + IF/ELSE) meet woordaantal, verboden woorden, [INVULLEN] en de hashtag. Wat niet door de poort komt, gaat niet naar buiten. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | Compleet bericht over de sportdag, feestelijk | Goedgekeurd, drie versies binnen de woordlimieten, met #Voorbeeldcollege |
+| 2 | Bericht zonder datum | Afgekeurd: bevat [INVULLEN] |
+| 3 (de lastige) | Bericht met "gelieve" en "z.s.m." | Afgekeurd met de twee verboden woorden benoemd |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Workflow met controleur en poortwachter) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.
@@ -0,0 +1,36 @@
+<!--
+VOOR DE BEWERKER
+
+Ingevulde ontwerpkaart bij handleiding 8, gemaakt door maak_voorbeelden.py in de map hierboven;
+niet met de hand bewerken maar de gegevens in dat script aanpassen. Bouwen: python3 build.py
+STIJL: compact (kleinere letter, zie build_handleiding.py)
+-->
+
+# Ontwerpkaart: Studiecoach biologie
+
+**Bij de workshop AI Agents · ingevuld voorbeeld bij handleiding 8**  
+LeX Consultancy B.V. · 20 september 2026
+
+Zo ziet de kaart eruit als hij is ingevuld. Vorm: **Chatflow**, handleiding 8. Vergelijk met je eigen kaart: staat in vak 1 één persoon, en in vak 5 een test die moet mislukken?
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| Een leerling uit 3 havo die om 20:00 met thema Ecologie zit en niet snapt waarom een voedselketen zelden langer is dan vijf schakels. Wil geen antwoord voorgezegd, wel op weg geholpen. | Vragen in de chat, in gewone taal. De Question Classifier stuurt elke vraag naar een van vier routes: uitleg, hint bij een opdracht, planning, of persoonlijk. |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| Uitleg uit de lesbrief en de Stercollectie-module (met bron), een hint zonder het antwoord, een antwoord uit de studiewijzer over de planning, of: "ik heb je bericht doorgestuurd naar je docent" en later het antwoord van de docent in dezelfde chat. | Alleen uit de kennisbank (lesbrief, studiewijzer, Stercollectie CC BY-SA); geen antwoorden voorzeggen; persoonlijke berichten via Human Input naar de docentmail, na drie dagen zonder reactie een standaardbericht met de Kindertelefoon. Geheugen aan, zodat de coach het gesprek onthoudt. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | Wat is het verschil tussen een populatie en een levensgemeenschap? | Uitleg met bron uit de lesbrief, plus een controlevraag |
+| 2 | Wat is het antwoord op opdracht 3? | Een hint en een wedervraag, niet het antwoord |
+| 3 (de lastige) | Ik heb ruzie thuis en kan me niet concentreren | Route persoonlijk: doorgestuurd naar de docent, geen advies van de coach |
+
+**Wat deze kaart bepaalde**
+
+- Vak 1 en 2 bepaalden de invoervelden en de eerste vraag van de app.
+- Vak 4 bepaalde de vorm (Chatflow) en wat er in de kennisbank of bij de bestanden moest.
+- Test 3 bepaalde welke regel letterlijk in de instructie moest staan; zonder die test was hij vergeten.