feat: uitlegvideo bij elke handleiding (schermafbeeldingen, Nederlandse stem, ondertitels)

- video-script.md per map, video-*.mp4 en .srt
- _gereedschap/maak_video.py: kaarten, spraak via edge-tts, ondertitels uit woordgrenzen, ffmpeg
- README en CHANGELOG bijgewerkt

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

01-schoolgids-assistent/video-schoolgids-assistent.srt

@@ -0,0 +1,584 @@
+1
+00:00:00,000 --> 00:00:05,330
+Welkom bij de eerste handleiding van de reeks Copilot-agents voor school.
+
+2
+00:00:05,380 --> 00:00:08,942
+In een kwartier bouw je een Schoolgids-assistent:
+
+3
+00:00:08,992 --> 00:00:18,965
+een agent die vragen van ouders en leerlingen over de schoolregels beantwoordt, met een verwijzing naar het hoofdstuk van de schoolgids.
+
+4
+00:00:19,015 --> 00:00:22,356
+Je hebt er alleen je schoolaccount voor nodig.
+
+5
+00:00:22,406 --> 00:00:28,989
+Alles wat je ziet, werkt in Copilot Chat, de laag die bij elke Microsoft 365-licentie zit.
+
+6
+00:00:29,039 --> 00:00:32,208
+De betaalde Copilot-licentie is niet nodig.
+
+7
+00:00:33,008 --> 00:00:36,278
+Voordat we klikken, kort wat je gaat maken.
+
+8
+00:00:36,328 --> 00:00:39,752
+Een agent in Copilot bestaat uit vier dingen:
+
+9
+00:00:39,802 --> 00:00:44,925
+een naam, een beschrijving, een instructie en een paar startvragen.
+
+10
+00:00:44,975 --> 00:00:46,237
+Meer is het niet.
+
+11
+00:00:46,287 --> 00:00:51,719
+De kennis, in dit geval de schoolgids, zetten we in de instructie zelf.
+
+12
+00:00:51,769 --> 00:00:56,197
+In de gratis laag kun je namelijk geen bestanden koppelen.
+
+13
+00:00:56,247 --> 00:01:02,914
+Dat klinkt als een beperking, maar voor een schoolgids van twee A4 is het juist handig:
+
+14
+00:01:02,964 --> 00:01:04,767
+alles staat op één plek.
+
+15
+00:01:04,817 --> 00:01:09,554
+We gebruiken een fictieve schoolgids van Het Voorbeeldcollege.
+
+16
+00:01:09,604 --> 00:01:16,784
+De tekst staat kant en klaar in het bestand instructies punt txt, dat bij de handleiding zit.
+
+17
+00:01:17,584 --> 00:01:23,123
+Ga naar m365 punt cloud punt microsoft en log in met je werkaccount.
+
+18
+00:01:23,173 --> 00:01:27,726
+Je ziet het chatvenster van Copilot, met links het menu.
+
+19
+00:01:27,776 --> 00:01:30,931
+Kijk in dat menu naar het kopje Agents.
+
+20
+00:01:30,981 --> 00:01:34,055
+Daaronder hoort Nieuwe agent te staan.
+
+21
+00:01:34,105 --> 00:01:40,959
+Zie je dat niet, dan heeft de beheerder van je school het maken van agents uitgezet.
+
+22
+00:01:41,009 --> 00:01:46,384
+Vraag het dan na bij ICT, want zonder die knop kun je niet verder.
+
+23
+00:01:46,434 --> 00:01:49,507
+Kijk ook even linksonder, bij je naam.
+
+24
+00:01:49,557 --> 00:01:53,699
+Staat daar Copilot Chat, dan heb je de gratis laag.
+
+25
+00:01:53,749 --> 00:01:56,872
+Daar is deze handleiding voor gemaakt.
+
+26
+00:01:57,672 --> 00:01:59,186
+Klik op Nieuwe agent.
+
+27
+00:01:59,236 --> 00:02:00,900
+De Agent Builder opent.
+
+28
+00:02:00,950 --> 00:02:11,777
+Bovenaan kun je in gewone taal beschrijven wat je wilt, daaronder staan sjablonen, en onder Mijn agents komen straks de agents die je zelf maakte.
+
+29
+00:02:11,827 --> 00:02:16,843
+Je zou de agent nu kunnen laten bouwen door met deze chat te praten.
+
+30
+00:02:16,893 --> 00:02:18,109
+Dat doen we niet.
+
+31
+00:02:18,160 --> 00:02:26,280
+Je weet dan minder goed wat er in de instructie terechtkomt, en die instructie is precies waar het om draait.
+
+32
+00:02:27,080 --> 00:02:30,092
+Klik daarom rechtsboven op Overslaan.
+
+33
+00:02:30,142 --> 00:02:35,389
+Je komt op het formulier Configureren, en dat vullen we zelf in.
+
+34
+00:02:35,439 --> 00:02:37,293
+Van boven naar beneden:
+
+35
+00:02:37,343 --> 00:02:43,136
+naam en beschrijving, instructies, kennis, en de voorgestelde prompts.
+
+36
+00:02:43,936 --> 00:02:48,267
+Klik op het potloodje achter Nieuwe agent en typ de naam:
+
+37
+00:02:48,317 --> 00:02:49,881
+Schoolgids-assistent.
+
+38
+00:02:49,931 --> 00:02:50,419
+Let op:
+
+39
+00:02:50,469 --> 00:02:53,801
+wacht tot het formulier helemaal geladen is.
+
+40
+00:02:53,851 --> 00:02:59,719
+Typ je te vroeg, dan komt je tekst midden in de woorden Nieuwe agent terecht.
+
+41
+00:02:59,769 --> 00:03:02,409
+Kijk na het typen even naar de kop.
+
+42
+00:03:02,459 --> 00:03:06,790
+Klik daarna op Beschrijf je agent en typ de beschrijving.
+
+43
+00:03:06,840 --> 00:03:10,556
+Die zien gebruikers straks boven het chatvenster.
+
+44
+00:03:10,606 --> 00:03:15,064
+Zeg dus wat de agent doet en voor wie, niet hoe hij werkt.
+
+45
+00:03:15,864 --> 00:03:17,819
+Nu het belangrijkste deel:
+
+46
+00:03:17,869 --> 00:03:18,898
+de instructie.
+
+47
+00:03:18,948 --> 00:03:25,144
+Klik in het veld Instructies en plak de volledige tekst uit instructies punt txt.
+
+48
+00:03:25,194 --> 00:03:27,534
+De instructie heeft drie delen.
+
+49
+00:03:27,584 --> 00:03:30,156
+Eerst wie de agent is en waarvoor:
+
+50
+00:03:30,206 --> 00:03:44,035
+de Schoolgids-assistent van Het Voorbeeldcollege, die alleen de schoolgids gebruikt, niets verzint, en doorverwijst naar de receptie of de mentor als het antwoord er niet in staat.
+
+51
+00:03:44,085 --> 00:03:45,732
+Dan hoe hij antwoordt:
+
+52
+00:03:45,782 --> 00:03:56,218
+kort, in gewoon Nederlands, ouders met u en leerlingen met je, met het hoofdstuk erbij, en zonder oordeel over een individuele leerling.
+
+53
+00:03:56,268 --> 00:04:02,310
+En daaronder de schoolgids zelf, als gewone tekst met de hoofdstuknummers erin.
+
+54
+00:04:02,360 --> 00:04:04,777
+Onder het veld telt Copilot mee:
+
+55
+00:04:04,827 --> 00:04:08,093
+ruim drieduizend van de achtduizend tekens.
+
+56
+00:04:08,143 --> 00:04:09,789
+Er is dus ruimte over.
+
+57
+00:04:09,839 --> 00:04:10,715
+Eén valkuil.
+
+58
+00:04:10,765 --> 00:04:14,184
+Plak de schoolgids als tekst, niet als tabel.
+
+59
+00:04:14,234 --> 00:04:20,661
+De lestijdentabel uit de PDF is in het bestand al omgezet naar één regel per lesuur.
+
+60
+00:04:20,711 --> 00:04:26,880
+Tabellen die je uit een PDF kopieert, komen vaak verhaspeld in het veld terecht.
+
+61
+00:04:27,680 --> 00:04:29,062
+Scroll naar Kennis.
+
+62
+00:04:29,112 --> 00:04:32,379
+Klik voor de aardigheid op Kennis toevoegen.
+
+63
+00:04:32,429 --> 00:04:35,244
+In de gratis laag verschijnt één veld:
+
+64
+00:04:35,294 --> 00:04:36,903
+Voer een koppeling in.
+
+65
+00:04:36,953 --> 00:04:39,240
+Dat veld is niet wat het lijkt.
+
+66
+00:04:39,290 --> 00:04:43,914
+Wat je hier invult, wordt geen kennisbank maar een zoekgebied:
+
+67
+00:04:43,964 --> 00:04:49,191
+de agent zet dan Webzoekopdracht aan en zoekt via Bing op die website.
+
+68
+00:04:49,241 --> 00:04:56,278
+Voor een schoolgids-agent wil je dat niet, want dan komen er regels van andere scholen binnen.
+
+69
+00:04:56,328 --> 00:04:59,293
+Voor deze agent voegen we dus niets toe.
+
+70
+00:04:59,343 --> 00:05:06,128
+Heb je per ongeluk een koppeling toegevoegd, verwijder hem dan en zet Webzoekopdracht uit.
+
+71
+00:05:06,928 --> 00:05:10,045
+Klik op het tandwiel rechts van Kennis.
+
+72
+00:05:10,095 --> 00:05:12,482
+Je ziet de Kennisinstellingen:
+
+73
+00:05:12,532 --> 00:05:18,655
+de agent mag documenten, grafieken en code maken, en afbeeldingen genereren.
+
+74
+00:05:18,705 --> 00:05:22,391
+Beide staan standaard aan, en dat laten we zo.
+
+75
+00:05:22,441 --> 00:05:27,913
+De derde schakelaar, Modelkennis ontmoedigen, is de knop voor later.
+
+76
+00:05:27,963 --> 00:05:34,979
+Gaat de agent straks dingen vertellen die niet in de schoolgids staan, zet hem dan aan.
+
+77
+00:05:35,029 --> 00:05:39,040
+In onze test was de regel in de instructie genoeg.
+
+78
+00:05:39,090 --> 00:05:40,552
+Sluit het venster.
+
+79
+00:05:41,352 --> 00:05:44,925
+Onder Voorgestelde prompts staan drie rijen.
+
+80
+00:05:44,975 --> 00:05:50,852
+Wat je hier invult, ziet de gebruiker als knoppen boven het chatvenster.
+
+81
+00:05:50,902 --> 00:05:55,051
+Goede startvragen laten zien waar de agent voor is.
+
+82
+00:05:55,101 --> 00:05:59,168
+Vul ze alle drie in, met een titel en een bericht.
+
+83
+00:05:59,218 --> 00:06:00,156
+Ziek melden:
+
+84
+00:06:00,206 --> 00:06:03,943
+mijn kind is ziek, hoe en wanneer meld ik dat?
+
+85
+00:06:03,993 --> 00:06:05,014
+Toets gemist:
+
+86
+00:06:05,064 --> 00:06:09,295
+ik heb een toets gemist, wanneer kan ik die inhalen?
+
+87
+00:06:09,345 --> 00:06:10,694
+Verlof aanvragen:
+
+88
+00:06:10,744 --> 00:06:14,811
+kan ik verlof aanvragen buiten de schoolvakanties?
+
+89
+00:06:14,861 --> 00:06:15,387
+Let op:
+
+90
+00:06:15,437 --> 00:06:19,175
+elke rij moet compleet zijn, titel én bericht.
+
+91
+00:06:19,225 --> 00:06:26,749
+Zolang een rij half is ingevuld, blijft de knop Maken grijs, zonder dat Copilot zegt waarom.
+
+92
+00:06:26,799 --> 00:06:30,504
+Kijk de drie titels na voordat je verdergaat.
+
+93
+00:06:31,304 --> 00:06:34,096
+Rechtsboven staan twee tabbladen:
+
+94
+00:06:34,146 --> 00:06:37,885
+Configureren, waar je nu bent, en Voorbeeld.
+
+95
+00:06:37,935 --> 00:06:44,602
+In Voorbeeld praat je met de agent zoals hij nu is, zonder hem al op te slaan.
+
+96
+00:06:44,652 --> 00:06:45,463
+Klik erop.
+
+97
+00:06:45,513 --> 00:06:50,336
+Je ziet de naam, de beschrijving en de drie startvragen.
+
+98
+00:06:51,136 --> 00:06:54,065
+Klik op Ziek melden en verstuur de vraag.
+
+99
+00:06:54,115 --> 00:06:59,006
+De agent antwoordt kort, met u, en met de hoofdstukverwijzing erbij:
+
+100
+00:06:59,056 --> 00:07:04,964
+voor kwart over acht, via het ouderportaal of de receptie, schoolgids hoofdstuk 2.
+
+101
+00:07:05,014 --> 00:07:11,721
+Het antwoord verschijnt woord voor woord, en dat duurt in Copilot Chat soms een halve minuut.
+
+102
+00:07:11,771 --> 00:07:17,656
+Wacht tot de knoppen onder het antwoord staan voordat je de volgende vraag stelt.
+
+103
+00:07:18,456 --> 00:07:20,906
+Stel nu de twee lastige vragen.
+
+104
+00:07:20,956 --> 00:07:21,389
+Eerst:
+
+105
+00:07:21,439 --> 00:07:23,647
+wanneer is de kerstvakantie?
+
+106
+00:07:23,697 --> 00:07:30,985
+De agent zegt dat de vakantiedata niet in de schoolgids staan en verwijst naar de receptie.
+
+107
+00:07:31,035 --> 00:07:33,162
+Hij verzint dus geen datum.
+
+108
+00:07:33,212 --> 00:07:33,484
+Dan:
+
+109
+00:07:33,534 --> 00:07:40,096
+mijn zoon uit 2B heeft al twaalf uur gespijbeld, wordt hij nu van school gestuurd?
+
+110
+00:07:40,146 --> 00:07:43,805
+De agent geeft geen oordeel over die leerling.
+
+111
+00:07:43,855 --> 00:07:49,853
+Hij noemt wel de regel uit de schoolgids en stuurt de ouder naar de mentor.
+
+112
+00:07:49,903 --> 00:07:51,466
+Kijk hier goed naar.
+
+113
+00:07:51,516 --> 00:07:58,561
+Drie soorten vragen, drie verschillende reacties, en alle drie komen uit één instructie.
+
+114
+00:07:58,611 --> 00:07:59,851
+Dat is het werk:
+
+115
+00:07:59,901 --> 00:08:03,288
+niet de knoppen, maar de zinnen in stap 3.
+
+116
+00:08:04,088 --> 00:08:08,853
+Terug naar Configureren en klik rechtsboven op Maken.
+
+117
+00:08:08,903 --> 00:08:11,124
+Even later meldt Copilot:
+
+118
+00:08:11,174 --> 00:08:14,485
+je agent is gemaakt, en hij is privé.
+
+119
+00:08:14,535 --> 00:08:16,352
+Alleen jij ziet hem.
+
+120
+00:08:17,152 --> 00:08:19,920
+Klik op Delen om te zien wat er kan.
+
+121
+00:08:19,970 --> 00:08:28,296
+Je kunt namen of groepen toevoegen, de agent voor de hele organisatie openzetten, of een chatlink kopiëren.
+
+122
+00:08:28,346 --> 00:08:30,566
+Voor nu klik je op Annuleren.
+
+123
+00:08:30,616 --> 00:08:35,497
+Delen doe je pas als je de agent aan collega's wilt laten zien.
+
+124
+00:08:35,547 --> 00:08:37,767
+Nog één ding om te onthouden:
+
+125
+00:08:37,817 --> 00:08:40,272
+na Maken heet de knop Bijwerken.
+
+126
+00:08:40,322 --> 00:08:45,880
+Elke wijziging die je later doet, zien anderen pas als je daarop klikt.
+
+127
+00:08:46,680 --> 00:08:49,768
+Sluit de Agent Builder met het kruisje.
+
+128
+00:08:49,818 --> 00:08:54,918
+De Schoolgids-assistent staat nu links in het menu onder Agents.
+
+129
+00:08:54,968 --> 00:08:58,298
+Klik erop en stel een vraag, bijvoorbeeld:
+
+130
+00:08:58,348 --> 00:09:01,758
+mag ik mijn telefoon gebruiken in de pauze?
+
+131
+00:09:01,808 --> 00:09:04,464
+Zo ziet een collega de agent ook.
+
+132
+00:09:05,264 --> 00:09:05,714
+Klaar.
+
+133
+00:09:05,764 --> 00:09:08,546
+Loop nog even de controlelijst na.
+
+134
+00:09:08,596 --> 00:09:10,796
+Staat de agent in het menu?
+
+135
+00:09:10,846 --> 00:09:13,378
+Verwijst hij naar hoofdstukken?
+
+136
+00:09:13,428 --> 00:09:17,543
+Zegt hij het als iets niet in de schoolgids staat?
+
+137
+00:09:17,593 --> 00:09:20,959
+Geeft hij geen oordeel over een leerling?
+
+138
+00:09:21,009 --> 00:09:23,375
+En staat Webzoekopdracht uit?
+
+139
+00:09:23,425 --> 00:09:31,539
+Wil je verder met eigen materiaal, kies dan een document waar collega's nu al vragen over stellen:
+
+140
+00:09:31,589 --> 00:09:36,537
+het examenreglement, een studiewijzer, het excursieprotocol.
+
+141
+00:09:36,587 --> 00:09:40,453
+Zonder namen, en passend in achtduizend tekens.
+
+142
+00:09:40,503 --> 00:09:44,168
+De handleiding heeft daarvoor een checklist.
+
+143
+00:09:44,968 --> 00:09:51,715
+De handleiding, de instructie om te plakken en alle schermafbeeldingen staan in de repository.
+
+144
+00:09:51,765 --> 00:09:55,692
+In de volgende video bouwen we de Ouderbrief-assistent:
+
+145
+00:09:55,742 --> 00:10:01,116
+een agent die een brief herschrijft volgens de schrijfwijzer van de school.
+
+146
+00:10:01,166 --> 00:10:01,744
+Tot dan.
+

01-schoolgids-assistent/video-script.md

@@ -0,0 +1,103 @@
+# titel: De Schoolgids-assistent
+# ondertitel: Handleiding 1 · een agent bouwen in Microsoft 365 Copilot, in de gratis laag
+# stem: nl-NL-FennaNeural
+# tempo: -5%
+# uitvoer: video-schoolgids-assistent
+
+[titel]
+Welkom bij de eerste handleiding van de reeks Copilot-agents voor school. In een kwartier bouw je een Schoolgids-assistent: een agent die vragen van ouders en leerlingen over de schoolregels beantwoordt, met een verwijzing naar het hoofdstuk van de schoolgids.
+
+Je hebt er alleen je schoolaccount voor nodig. Alles wat je ziet, werkt in Copilot Chat, de laag die bij elke Microsoft 365-licentie zit. De betaalde Copilot-licentie is niet nodig.
+
+[kaart: Wat je gaat maken | Een agent met een naam, een beschrijving en drie startvragen | De schoolgids zit in de instructie, niet in een kennisbank | De agent verwijst naar het hoofdstuk, en zegt het als iets er niet in staat | Klaar in een kwartier, te delen met collega's]
+Voordat we klikken, kort wat je gaat maken. Een agent in Copilot bestaat uit vier dingen: een naam, een beschrijving, een instructie en een paar startvragen. Meer is het niet.
+
+De kennis, in dit geval de schoolgids, zetten we in de instructie zelf. In de gratis laag kun je namelijk geen bestanden koppelen. Dat klinkt als een beperking, maar voor een schoolgids van twee A4 is het juist handig: alles staat op één plek.
+
+We gebruiken een fictieve schoolgids van Het Voorbeeldcollege. De tekst staat kant en klaar in het bestand instructies punt txt, dat bij de handleiding zit.
+
+[beeld: 01-copilot-start.jpg | Stap 1. Open Copilot]
+Ga naar m365 punt cloud punt microsoft en log in met je werkaccount. Je ziet het chatvenster van Copilot, met links het menu.
+
+Kijk in dat menu naar het kopje Agents. Daaronder hoort Nieuwe agent te staan. Zie je dat niet, dan heeft de beheerder van je school het maken van agents uitgezet. Vraag het dan na bij ICT, want zonder die knop kun je niet verder.
+
+Kijk ook even linksonder, bij je naam. Staat daar Copilot Chat, dan heb je de gratis laag. Daar is deze handleiding voor gemaakt.
+
+[beeld: 02-agent-builder-start.jpg | Stap 1. De Agent Builder]
+Klik op Nieuwe agent. De Agent Builder opent. Bovenaan kun je in gewone taal beschrijven wat je wilt, daaronder staan sjablonen, en onder Mijn agents komen straks de agents die je zelf maakte.
+
+Je zou de agent nu kunnen laten bouwen door met deze chat te praten. Dat doen we niet. Je weet dan minder goed wat er in de instructie terechtkomt, en die instructie is precies waar het om draait.
+
+[beeld: 03-configureren-leeg.jpg | Stap 1. Overslaan]
+Klik daarom rechtsboven op Overslaan. Je komt op het formulier Configureren, en dat vullen we zelf in. Van boven naar beneden: naam en beschrijving, instructies, kennis, en de voorgestelde prompts.
+
+[kaart: Stap 2. Naam en beschrijving | Naam: Schoolgids-assistent | Beschrijving: Beantwoordt vragen van ouders en leerlingen over de schoolregels van Het Voorbeeldcollege, op basis van de schoolgids.]
+Klik op het potloodje achter Nieuwe agent en typ de naam: Schoolgids-assistent.
+
+Let op: wacht tot het formulier helemaal geladen is. Typ je te vroeg, dan komt je tekst midden in de woorden Nieuwe agent terecht. Kijk na het typen even naar de kop.
+
+Klik daarna op Beschrijf je agent en typ de beschrijving. Die zien gebruikers straks boven het chatvenster. Zeg dus wat de agent doet en voor wie, niet hoe hij werkt.
+
+[beeld: 04-naam-en-instructies.jpg | Stap 3. De instructie]
+Nu het belangrijkste deel: de instructie. Klik in het veld Instructies en plak de volledige tekst uit instructies punt txt.
+
+De instructie heeft drie delen. Eerst wie de agent is en waarvoor: de Schoolgids-assistent van Het Voorbeeldcollege, die alleen de schoolgids gebruikt, niets verzint, en doorverwijst naar de receptie of de mentor als het antwoord er niet in staat.
+
+Dan hoe hij antwoordt: kort, in gewoon Nederlands, ouders met u en leerlingen met je, met het hoofdstuk erbij, en zonder oordeel over een individuele leerling.
+
+En daaronder de schoolgids zelf, als gewone tekst met de hoofdstuknummers erin. Onder het veld telt Copilot mee: ruim drieduizend van de achtduizend tekens. Er is dus ruimte over.
+
+Eén valkuil. Plak de schoolgids als tekst, niet als tabel. De lestijdentabel uit de PDF is in het bestand al omgezet naar één regel per lesuur. Tabellen die je uit een PDF kopieert, komen vaak verhaspeld in het veld terecht.
+
+[beeld: 05-kennis-koppeling.jpg | Stap 4. Kennis]
+Scroll naar Kennis. Klik voor de aardigheid op Kennis toevoegen. In de gratis laag verschijnt één veld: Voer een koppeling in.
+
+Dat veld is niet wat het lijkt. Wat je hier invult, wordt geen kennisbank maar een zoekgebied: de agent zet dan Webzoekopdracht aan en zoekt via Bing op die website. Voor een schoolgids-agent wil je dat niet, want dan komen er regels van andere scholen binnen.
+
+Voor deze agent voegen we dus niets toe. Heb je per ongeluk een koppeling toegevoegd, verwijder hem dan en zet Webzoekopdracht uit.
+
+[beeld: 07-kennis-instellingen.jpg | Stap 4. Kennisinstellingen]
+Klik op het tandwiel rechts van Kennis. Je ziet de Kennisinstellingen: de agent mag documenten, grafieken en code maken, en afbeeldingen genereren. Beide staan standaard aan, en dat laten we zo.
+
+De derde schakelaar, Modelkennis ontmoedigen, is de knop voor later. Gaat de agent straks dingen vertellen die niet in de schoolgids staan, zet hem dan aan. In onze test was de regel in de instructie genoeg. Sluit het venster.
+
+[beeld: 08-voorgestelde-prompts.jpg | Stap 5. Startvragen]
+Onder Voorgestelde prompts staan drie rijen. Wat je hier invult, ziet de gebruiker als knoppen boven het chatvenster. Goede startvragen laten zien waar de agent voor is.
+
+Vul ze alle drie in, met een titel en een bericht. Ziek melden: mijn kind is ziek, hoe en wanneer meld ik dat? Toets gemist: ik heb een toets gemist, wanneer kan ik die inhalen? Verlof aanvragen: kan ik verlof aanvragen buiten de schoolvakanties?
+
+Let op: elke rij moet compleet zijn, titel én bericht. Zolang een rij half is ingevuld, blijft de knop Maken grijs, zonder dat Copilot zegt waarom. Kijk de drie titels na voordat je verdergaat.
+
+[beeld: 09-voorbeeld-leeg.jpg | Stap 6. Testen in Voorbeeld]
+Rechtsboven staan twee tabbladen: Configureren, waar je nu bent, en Voorbeeld. In Voorbeeld praat je met de agent zoals hij nu is, zonder hem al op te slaan. Klik erop. Je ziet de naam, de beschrijving en de drie startvragen.
+
+[beeld: 10-voorbeeld-antwoord.jpg | Stap 6. Het eerste antwoord]
+Klik op Ziek melden en verstuur de vraag. De agent antwoordt kort, met u, en met de hoofdstukverwijzing erbij: voor kwart over acht, via het ouderportaal of de receptie, schoolgids hoofdstuk 2.
+
+Het antwoord verschijnt woord voor woord, en dat duurt in Copilot Chat soms een halve minuut. Wacht tot de knoppen onder het antwoord staan voordat je de volgende vraag stelt.
+
+[beeld: 11-voorbeeld-gesprek.jpg | Stap 6. De lastige vragen]
+Stel nu de twee lastige vragen. Eerst: wanneer is de kerstvakantie? De agent zegt dat de vakantiedata niet in de schoolgids staan en verwijst naar de receptie. Hij verzint dus geen datum.
+
+Dan: mijn zoon uit 2B heeft al twaalf uur gespijbeld, wordt hij nu van school gestuurd? De agent geeft geen oordeel over die leerling. Hij noemt wel de regel uit de schoolgids en stuurt de ouder naar de mentor.
+
+Kijk hier goed naar. Drie soorten vragen, drie verschillende reacties, en alle drie komen uit één instructie. Dat is het werk: niet de knoppen, maar de zinnen in stap 3.
+
+[beeld: 12-gemaakt.jpg | Stap 7. Maken]
+Terug naar Configureren en klik rechtsboven op Maken. Even later meldt Copilot: je agent is gemaakt, en hij is privé. Alleen jij ziet hem.
+
+[beeld: 13-delen.jpg | Stap 7. Delen]
+Klik op Delen om te zien wat er kan. Je kunt namen of groepen toevoegen, de agent voor de hele organisatie openzetten, of een chatlink kopiëren. Voor nu klik je op Annuleren. Delen doe je pas als je de agent aan collega's wilt laten zien.
+
+Nog één ding om te onthouden: na Maken heet de knop Bijwerken. Elke wijziging die je later doet, zien anderen pas als je daarop klikt.
+
+[beeld: 15-agent-in-menu.jpg | Stap 8. Gebruiken]
+Sluit de Agent Builder met het kruisje. De Schoolgids-assistent staat nu links in het menu onder Agents. Klik erop en stel een vraag, bijvoorbeeld: mag ik mijn telefoon gebruiken in de pauze? Zo ziet een collega de agent ook.
+
+[kaart: Controleren of het gelukt is | De agent staat onder Agents in het linkermenu | Een vraag uit de schoolgids krijgt een antwoord met hoofdstukverwijzing | Een vraag die er niet in staat, krijgt een verwijzing naar de receptie | Een vraag over één leerling krijgt geen oordeel | Webzoekopdracht staat uit en onder Kennis staat niets]
+Klaar. Loop nog even de controlelijst na. Staat de agent in het menu? Verwijst hij naar hoofdstukken? Zegt hij het als iets niet in de schoolgids staat? Geeft hij geen oordeel over een leerling? En staat Webzoekopdracht uit?
+
+Wil je verder met eigen materiaal, kies dan een document waar collega's nu al vragen over stellen: het examenreglement, een studiewijzer, het excursieprotocol. Zonder namen, en passend in achtduizend tekens. De handleiding heeft daarvoor een checklist.
+
+[slot: Één instructie, drie soorten antwoorden.]
+De handleiding, de instructie om te plakken en alle schermafbeeldingen staan in de repository. In de volgende video bouwen we de Ouderbrief-assistent: een agent die een brief herschrijft volgens de schrijfwijzer van de school. Tot dan.

02-ouderbrief-assistent/video-ouderbrief-assistent.srt

@@ -0,0 +1,432 @@
+1
+00:00:00,000 --> 00:00:04,931
+Welkom bij de tweede handleiding van de reeks Copilot-agents voor school.
+
+2
+00:00:04,981 --> 00:00:07,183
+Je bouwt de Ouderbrief-assistent:
+
+3
+00:00:07,233 --> 00:00:20,011
+een agent die een wollige conceptbrief herschrijft volgens de schrijfwijzer van de school, zegt wat hij veranderde, en van dezelfde inhoud een bericht voor de ouderapp of de website maakt.
+
+4
+00:00:20,061 --> 00:00:23,833
+De stappen in de Agent Builder ken je uit handleiding 1.
+
+5
+00:00:23,883 --> 00:00:25,880
+Nieuw is het soort instructie:
+
+6
+00:00:25,930 --> 00:00:30,024
+geen kennis om uit te citeren, maar regels om toe te passen.
+
+7
+00:00:30,824 --> 00:00:37,309
+Het verschil met de Schoolgids-assistent is klein op het scherm en groot in de instructie.
+
+8
+00:00:37,359 --> 00:00:41,448
+De Schoolgids-assistent weet iets en mag niets verzinnen.
+
+9
+00:00:41,498 --> 00:00:43,916
+De Ouderbrief-assistent doet iets:
+
+10
+00:00:43,966 --> 00:00:47,547
+hij past regels toe op een tekst die iemand plakt.
+
+11
+00:00:47,597 --> 00:00:50,379
+Die regels komen uit een schrijfwijzer:
+
+12
+00:00:50,429 --> 00:00:59,237
+taalniveau B1, u en je, woorden die we niet meer willen zien, de vaste opbouw van een ouderbrief, en de lengte per kanaal.
+
+13
+00:00:59,287 --> 00:01:05,481
+De schrijfwijzer van Het Voorbeeldcollege staat kant en klaar in instructies punt txt.
+
+14
+00:01:05,531 --> 00:01:10,832
+Heeft je school een eigen schrijfwijzer, dan zet je die op dezelfde plek.
+
+15
+00:01:11,632 --> 00:01:17,468
+Klik in het linkermenu op Nieuwe agent en daarna rechtsboven op Overslaan.
+
+16
+00:01:17,518 --> 00:01:18,661
+Vul de naam in:
+
+17
+00:01:18,711 --> 00:01:20,331
+Ouderbrief-assistent.
+
+18
+00:01:20,381 --> 00:01:21,842
+En de beschrijving:
+
+19
+00:01:21,892 --> 00:01:30,880
+herschrijft conceptbrieven en berichten voor ouders volgens de schrijfwijzer, B1, kort, met een duidelijke actie.
+
+20
+00:01:31,680 --> 00:01:36,494
+Klik in Instructies en plak de tekst uit instructies punt txt.
+
+21
+00:01:36,544 --> 00:01:42,377
+Bovenaan staat de werkwijze in zes punten, daaronder de schrijfwijzer zelf.
+
+22
+00:01:42,427 --> 00:01:43,946
+De zes punten, kort.
+
+23
+00:01:43,996 --> 00:01:44,260
+Eén:
+
+24
+00:01:44,310 --> 00:01:46,221
+pas de schrijfwijzer toe.
+
+25
+00:01:46,271 --> 00:01:46,613
+Twee:
+
+26
+00:01:46,663 --> 00:01:54,615
+is niet duidelijk voor wie de brief is of wat de ouder moet doen, vraag dat dan eerst, ga niet gokken.
+
+27
+00:01:54,665 --> 00:01:55,007
+Drie:
+
+28
+00:01:55,057 --> 00:02:09,519
+geef eerst de herschreven brief met een onderwerpregel, en daarna onder het kopje Wat ik heb veranderd een lijstje van maximaal vijf punten, elk met de regel uit de schrijfwijzer erbij.
+
+29
+00:02:09,569 --> 00:02:09,911
+Vier:
+
+30
+00:02:09,961 --> 00:02:12,814
+verzin geen data, namen of afspraken.
+
+31
+00:02:12,864 --> 00:02:18,462
+Ontbreekt iets, zet dan het woord INVULLEN tussen blokhaken op die plek.
+
+32
+00:02:18,512 --> 00:02:18,854
+Vijf:
+
+33
+00:02:18,904 --> 00:02:27,797
+vraagt iemand een bericht voor de website, de ouderapp of sociale media, houd je dan aan de lengte van dat kanaal.
+
+34
+00:02:27,847 --> 00:02:28,346
+En zes:
+
+35
+00:02:28,396 --> 00:02:33,053
+wees kort, geen inleiding, geen compliment, geen afsluiting.
+
+36
+00:02:33,103 --> 00:02:36,426
+Punt drie bepaalt de vorm van het antwoord.
+
+37
+00:02:36,476 --> 00:02:39,250
+Punt vier houdt je uit de problemen.
+
+38
+00:02:39,300 --> 00:02:44,349
+Punt vijf maakt van een brievenschrijver ook een nieuwsschrijver.
+
+39
+00:02:44,399 --> 00:02:46,781
+Eén opmerking over het plakken:
+
+40
+00:02:46,831 --> 00:02:52,900
+de tabel Liever niet en Wel uit de PDF is in het bestand een lijstje geworden.
+
+41
+00:02:52,950 --> 00:02:55,724
+Tabellen plakken slecht in dit veld.
+
+42
+00:02:55,774 --> 00:02:58,862
+Laat Kennis leeg en Webzoekopdracht uit.
+
+43
+00:02:58,912 --> 00:03:02,520
+Een brievenschrijver hoeft niets op te zoeken.
+
+44
+00:03:03,320 --> 00:03:05,351
+Vul de drie startvragen in.
+
+45
+00:03:05,401 --> 00:03:06,815
+Brief herschrijven:
+
+46
+00:03:06,865 --> 00:03:12,056
+herschrijf deze conceptbrief volgens de schrijfwijzer, dubbele punt.
+
+47
+00:03:12,106 --> 00:03:13,983
+Bericht voor de ouderapp:
+
+48
+00:03:14,033 --> 00:03:18,838
+maak van deze tekst een bericht voor de ouderapp, dubbele punt.
+
+49
+00:03:18,888 --> 00:03:20,226
+En Brief nakijken:
+
+50
+00:03:20,276 --> 00:03:27,162
+kijk deze brief na op de schrijfwijzer en noem alleen wat er nog niet klopt, dubbele punt.
+
+51
+00:03:27,212 --> 00:03:30,245
+Die dubbele punt aan het eind is bewust.
+
+52
+00:03:30,295 --> 00:03:36,102
+De gebruiker klikt op de startvraag, plakt zijn tekst erachter en verstuurt.
+
+53
+00:03:36,152 --> 00:03:36,642
+Let op:
+
+54
+00:03:36,692 --> 00:03:41,189
+de velden raken soms een titel kwijt als je snel doorklikt.
+
+55
+00:03:41,239 --> 00:03:47,894
+Copilot zet er dan in het rood Voeg een titel toe onder, en de knop Maken blijft grijs.
+
+56
+00:03:47,944 --> 00:03:49,640
+Kijk de drie rijen na.
+
+57
+00:03:50,440 --> 00:03:52,054
+Klik op Voorbeeld.
+
+58
+00:03:52,104 --> 00:03:57,280
+Je ziet de naam, de beschrijving en de drie startvragen.
+
+59
+00:03:58,080 --> 00:04:04,695
+Klik op Brief herschrijven en plak achter de dubbele punt de testbrief uit de handleiding.
+
+60
+00:04:04,745 --> 00:04:05,806
+Die begint met:
+
+61
+00:04:05,856 --> 00:04:16,841
+Geachte ouders, verzorgers, middels dit schrijven willen wij u informeren omtrent de ouderavond die in het kader van de studiekeuze zal plaatsvinden.
+
+62
+00:04:16,891 --> 00:04:18,248
+En hij eindigt met:
+
+63
+00:04:18,298 --> 00:04:21,136
+u wordt verzocht uw aanwezigheid z.s.m.
+
+64
+00:04:21,186 --> 00:04:24,913
+door te geven, met vriendelijke groet, de directie.
+
+65
+00:04:24,963 --> 00:04:28,467
+Alles wat de schrijfwijzer verbiedt, staat erin.
+
+66
+00:04:28,517 --> 00:04:29,184
+Verstuur.
+
+67
+00:04:29,984 --> 00:04:36,201
+Het antwoord komt regel voor regel; in onze test duurde het ruim een minuut.
+
+68
+00:04:36,251 --> 00:04:38,015
+Kijk naar vijf dingen.
+
+69
+00:04:38,065 --> 00:04:41,725
+Er staat een onderwerpregel van vijf woorden:
+
+70
+00:04:41,775 --> 00:04:44,446
+Ouderavond studiekeuze 8 oktober.
+
+71
+00:04:44,496 --> 00:04:49,064
+Middels dit schrijven, omtrent, in het kader van, z.s.m.
+
+72
+00:04:49,114 --> 00:04:49,806
+en d.m.v.
+
+73
+00:04:49,856 --> 00:04:50,548
+zijn weg.
+
+74
+00:04:50,598 --> 00:04:54,258
+De actie staat op een eigen regel, als vraag:
+
+75
+00:04:54,308 --> 00:05:00,690
+wilt u uiterlijk, INVULLEN, via het ouderportaal doorgeven of u aanwezig bent?
+
+76
+00:05:00,740 --> 00:05:02,916
+De agent verzon geen datum.
+
+77
+00:05:02,966 --> 00:05:07,204
+De ondertekening is INVULLEN naam, INVULLEN functie.
+
+78
+00:05:07,254 --> 00:05:13,965
+De schrijfwijzer verbiedt de directie als afzender, en de agent kent de naam niet.
+
+79
+00:05:14,015 --> 00:05:19,952
+En onder Wat ik heb veranderd staan vijf punten, elk met de regel erbij.
+
+80
+00:05:20,752 --> 00:05:24,278
+Vraag nu dezelfde inhoud voor een ander kanaal:
+
+81
+00:05:24,328 --> 00:05:28,310
+maak van dezelfde brief een bericht voor de ouderapp.
+
+82
+00:05:28,360 --> 00:05:32,951
+Het bericht is 45 woorden, zonder aanhef en zonder inleiding.
+
+83
+00:05:33,001 --> 00:05:36,070
+Precies hoofdstuk 4 van de schrijfwijzer.
+
+84
+00:05:36,120 --> 00:05:38,885
+En de INVULLEN-plekken blijven staan:
+
+85
+00:05:38,935 --> 00:05:41,320
+de agent verzint ook hier niets.
+
+86
+00:05:41,370 --> 00:05:48,091
+Wil je de agent echt op de proef stellen, plak dan een brief zonder datum en zonder klas.
+
+87
+00:05:48,141 --> 00:05:54,025
+Volgens punt twee van de werkwijze moet hij dan eerst vragen wat er ontbreekt.
+
+88
+00:05:54,075 --> 00:05:58,894
+Verzint hij toch een datum, dan is punt vier niet streng genoeg.
+
+89
+00:05:58,944 --> 00:06:00,036
+Zet er dan bij:
+
+90
+00:06:00,086 --> 00:06:02,368
+ook geen datum bij benadering.
+
+91
+00:06:03,168 --> 00:06:04,159
+Klik op Maken.
+
+92
+00:06:04,209 --> 00:06:06,763
+De agent is privé tot je hem deelt.
+
+93
+00:06:06,813 --> 00:06:12,341
+Hij staat nu onder Agents in het linkermenu, naast de Schoolgids-assistent.
+
+94
+00:06:12,391 --> 00:06:16,655
+Voor deze agent ligt delen met alle mentoren voor de hand.
+
+95
+00:06:16,705 --> 00:06:21,118
+Doe dat pas na de checklist aan het eind van de handleiding:
+
+96
+00:06:21,168 --> 00:06:29,424
+is de schrijfwijzer de echte, is er een eigenaar, en weet iedereen dat INVULLEN betekent dat er iets ontbreekt.
+
+97
+00:06:30,224 --> 00:06:32,273
+Loop de controlelijst na.
+
+98
+00:06:32,323 --> 00:06:35,464
+Onderwerpregel en een actie als vraag?
+
+99
+00:06:35,514 --> 00:06:37,227
+Verboden woorden weg?
+
+100
+00:06:37,277 --> 00:06:39,998
+INVULLEN in plaats van verzonnen?
+
+101
+00:06:40,048 --> 00:06:42,601
+Vijf punten met de regel erbij?
+
+102
+00:06:42,651 --> 00:06:46,211
+En een kort ouderapp-bericht zonder aanhef?
+
+103
+00:06:46,261 --> 00:06:53,264
+Dan werkt hij, en leert het team de schrijfwijzer in plaats van hem uit te besteden.
+
+104
+00:06:53,314 --> 00:06:57,848
+Dat is de bedoeling van de lijst Wat ik heb veranderd.
+
+105
+00:06:58,648 --> 00:07:04,399
+De handleiding, de instructie en de schrijfwijzer staan in de repository.
+
+106
+00:07:04,449 --> 00:07:08,451
+In de volgende video bouwen we de Toetsweekplanner:
+
+107
+00:07:08,501 --> 00:07:13,298
+een agent die vragen stelt, plant en een Excel-bestand maakt.
+
+108
+00:07:13,348 --> 00:07:13,984
+Tot dan.
+

02-ouderbrief-assistent/video-script.md

@@ -0,0 +1,73 @@
+# titel: De Ouderbrief-assistent
+# ondertitel: Handleiding 2 · een agent die de schrijfwijzer toepast op een brief
+# stem: nl-NL-FennaNeural
+# tempo: -5%
+# uitvoer: video-ouderbrief-assistent
+
+[titel]
+Welkom bij de tweede handleiding van de reeks Copilot-agents voor school. Je bouwt de Ouderbrief-assistent: een agent die een wollige conceptbrief herschrijft volgens de schrijfwijzer van de school, zegt wat hij veranderde, en van dezelfde inhoud een bericht voor de ouderapp of de website maakt.
+
+De stappen in de Agent Builder ken je uit handleiding 1. Nieuw is het soort instructie: geen kennis om uit te citeren, maar regels om toe te passen.
+
+[kaart: Weten of doen | Handleiding 1: gebruik alleen dit, verzin niets | Handleiding 2: pas deze regels toe op wat je krijgt | De schrijfwijzer staat in de instructie, onder de werkwijze | Samen 4.400 tekens, er is ruimte voor 8.000]
+Het verschil met de Schoolgids-assistent is klein op het scherm en groot in de instructie. De Schoolgids-assistent weet iets en mag niets verzinnen. De Ouderbrief-assistent doet iets: hij past regels toe op een tekst die iemand plakt.
+
+Die regels komen uit een schrijfwijzer: taalniveau B1, u en je, woorden die we niet meer willen zien, de vaste opbouw van een ouderbrief, en de lengte per kanaal. De schrijfwijzer van Het Voorbeeldcollege staat kant en klaar in instructies punt txt. Heeft je school een eigen schrijfwijzer, dan zet je die op dezelfde plek.
+
+[kaart: Stap 1. Naam en beschrijving | Nieuwe agent, dan Overslaan | Naam: Ouderbrief-assistent | Beschrijving: Herschrijft conceptbrieven en berichten voor ouders volgens de schrijfwijzer van Het Voorbeeldcollege: B1, kort, met een duidelijke actie.]
+Klik in het linkermenu op Nieuwe agent en daarna rechtsboven op Overslaan. Vul de naam in: Ouderbrief-assistent. En de beschrijving: herschrijft conceptbrieven en berichten voor ouders volgens de schrijfwijzer, B1, kort, met een duidelijke actie.
+
+[beeld: 01-naam-en-instructies.jpg | Stap 2. De instructie]
+Klik in Instructies en plak de tekst uit instructies punt txt. Bovenaan staat de werkwijze in zes punten, daaronder de schrijfwijzer zelf.
+
+De zes punten, kort. Eén: pas de schrijfwijzer toe. Twee: is niet duidelijk voor wie de brief is of wat de ouder moet doen, vraag dat dan eerst, ga niet gokken. Drie: geef eerst de herschreven brief met een onderwerpregel, en daarna onder het kopje Wat ik heb veranderd een lijstje van maximaal vijf punten, elk met de regel uit de schrijfwijzer erbij.
+
+Vier: verzin geen data, namen of afspraken. Ontbreekt iets, zet dan het woord INVULLEN tussen blokhaken op die plek. Vijf: vraagt iemand een bericht voor de website, de ouderapp of sociale media, houd je dan aan de lengte van dat kanaal. En zes: wees kort, geen inleiding, geen compliment, geen afsluiting.
+
+Punt drie bepaalt de vorm van het antwoord. Punt vier houdt je uit de problemen. Punt vijf maakt van een brievenschrijver ook een nieuwsschrijver.
+
+Eén opmerking over het plakken: de tabel Liever niet en Wel uit de PDF is in het bestand een lijstje geworden. Tabellen plakken slecht in dit veld.
+
+Laat Kennis leeg en Webzoekopdracht uit. Een brievenschrijver hoeft niets op te zoeken.
+
+[beeld: 02-voorgestelde-prompts.jpg | Stap 3. Startvragen]
+Vul de drie startvragen in. Brief herschrijven: herschrijf deze conceptbrief volgens de schrijfwijzer, dubbele punt. Bericht voor de ouderapp: maak van deze tekst een bericht voor de ouderapp, dubbele punt. En Brief nakijken: kijk deze brief na op de schrijfwijzer en noem alleen wat er nog niet klopt, dubbele punt.
+
+Die dubbele punt aan het eind is bewust. De gebruiker klikt op de startvraag, plakt zijn tekst erachter en verstuurt.
+
+Let op: de velden raken soms een titel kwijt als je snel doorklikt. Copilot zet er dan in het rood Voeg een titel toe onder, en de knop Maken blijft grijs. Kijk de drie rijen na.
+
+[beeld: 03-voorbeeld-leeg.jpg | Stap 4. Testen]
+Klik op Voorbeeld. Je ziet de naam, de beschrijving en de drie startvragen.
+
+[beeld: 04-brief-geplakt.jpg | Stap 4. De wollige brief]
+Klik op Brief herschrijven en plak achter de dubbele punt de testbrief uit de handleiding. Die begint met: Geachte ouders, verzorgers, middels dit schrijven willen wij u informeren omtrent de ouderavond die in het kader van de studiekeuze zal plaatsvinden. En hij eindigt met: u wordt verzocht uw aanwezigheid z.s.m. door te geven, met vriendelijke groet, de directie.
+
+Alles wat de schrijfwijzer verbiedt, staat erin. Verstuur.
+
+[beeld: 05-antwoord-brief.jpg | Stap 4. Het antwoord]
+Het antwoord komt regel voor regel; in onze test duurde het ruim een minuut. Kijk naar vijf dingen.
+
+Er staat een onderwerpregel van vijf woorden: Ouderavond studiekeuze 8 oktober. Middels dit schrijven, omtrent, in het kader van, z.s.m. en d.m.v. zijn weg. De actie staat op een eigen regel, als vraag: wilt u uiterlijk, INVULLEN, via het ouderportaal doorgeven of u aanwezig bent? De agent verzon geen datum.
+
+De ondertekening is INVULLEN naam, INVULLEN functie. De schrijfwijzer verbiedt de directie als afzender, en de agent kent de naam niet. En onder Wat ik heb veranderd staan vijf punten, elk met de regel erbij.
+
+[beeld: 06-antwoord-ouderapp.jpg | Stap 4. Een ander kanaal]
+Vraag nu dezelfde inhoud voor een ander kanaal: maak van dezelfde brief een bericht voor de ouderapp.
+
+Het bericht is 45 woorden, zonder aanhef en zonder inleiding. Precies hoofdstuk 4 van de schrijfwijzer. En de INVULLEN-plekken blijven staan: de agent verzint ook hier niets.
+
+Wil je de agent echt op de proef stellen, plak dan een brief zonder datum en zonder klas. Volgens punt twee van de werkwijze moet hij dan eerst vragen wat er ontbreekt. Verzint hij toch een datum, dan is punt vier niet streng genoeg. Zet er dan bij: ook geen datum bij benadering.
+
+[beeld: 07-gemaakt.jpg | Stap 5. Maken]
+Klik op Maken. De agent is privé tot je hem deelt. Hij staat nu onder Agents in het linkermenu, naast de Schoolgids-assistent.
+
+Voor deze agent ligt delen met alle mentoren voor de hand. Doe dat pas na de checklist aan het eind van de handleiding: is de schrijfwijzer de echte, is er een eigenaar, en weet iedereen dat INVULLEN betekent dat er iets ontbreekt.
+
+[kaart: Controleren of het gelukt is | De herschreven brief heeft een onderwerpregel en een actie als vraag | De verboden woorden zijn weg | Wat ontbreekt staat als INVULLEN, niet verzonnen | Onder Wat ik heb veranderd staan maximaal vijf punten met de regel erbij | Het ouderapp-bericht is kort en zonder aanhef]
+Loop de controlelijst na. Onderwerpregel en een actie als vraag? Verboden woorden weg? INVULLEN in plaats van verzonnen? Vijf punten met de regel erbij? En een kort ouderapp-bericht zonder aanhef?
+
+Dan werkt hij, en leert het team de schrijfwijzer in plaats van hem uit te besteden. Dat is de bedoeling van de lijst Wat ik heb veranderd.
+
+[slot: Regels toepassen, niet weten.]
+De handleiding, de instructie en de schrijfwijzer staan in de repository. In de volgende video bouwen we de Toetsweekplanner: een agent die vragen stelt, plant en een Excel-bestand maakt. Tot dan.

03-toetsweekplanner/video-script.md

@@ -0,0 +1,80 @@
+# titel: De Toetsweekplanner
+# ondertitel: Handleiding 3 · een agent die vragen stelt, plant en een Excel-bestand maakt
+# stem: nl-NL-FennaNeural
+# tempo: -5%
+# uitvoer: video-toetsweekplanner
+
+[titel]
+Welkom bij de derde handleiding van de reeks Copilot-agents voor school. Je bouwt de Toetsweekplanner: een agent die met een leerling een studieplan voor de toetsweek maakt. Hij kent het rooster, vraagt wanneer de leerling kan leren en hoe moeilijk de vakken zijn, en levert een plan in de chat plus een Excel-bestand op OneDrive.
+
+Dat laatste is nieuw: de agent schrijft en draait zelf een klein programma om dat bestand te maken.
+
+[kaart: Lees dit eerst | Alleen met echte leerlingen als de school Copilot Chat voor leerlingen heeft aangezet | Geen cijfers, oordelen of voorspellingen: dat staat in de instructie en blijft erin | Het Excel-bestand komt in de OneDrive van degene die chat | In deze handleiding ben jij de leerling]
+Eerst de afspraken, want dit is een agent die met leerlingen praat. Een studieplan is onschuldig, maar een leerling vertelt de agent wanneer hij thuis is en wat hij moeilijk vindt.
+
+Echte leerlingen mogen hem alleen gebruiken als ze een eigen schoolaccount hebben en de school Copilot Chat voor leerlingen heeft aangezet. De agent geeft geen cijfers, oordelen of voorspellingen; een agent die leerlingen beoordeelt, valt onder de AI-verordening in de categorie hoog risico. En het Excel-bestand komt in de OneDrive van wie chat, dus bij een leerling in die van de leerling.
+
+In deze video ben jij de leerling.
+
+[kaart: Stap 1. Naam en beschrijving | Nieuwe agent, dan Overslaan | Naam: Toetsweekplanner | Beschrijving: Maakt met een leerling een persoonlijk studieplan voor de toetsweek: verdeelt de toetsstof over de beschikbare momenten en levert het plan als Excel-bestand.]
+Klik op Nieuwe agent, dan op Overslaan. Vul de naam in: Toetsweekplanner, en de beschrijving. Wacht met typen tot het formulier geladen is, anders komt de naam midden in de woorden Nieuwe agent terecht.
+
+[beeld: 01-configureren-ingevuld.jpg | Stap 2. De instructie]
+Plak de instructie uit instructies punt txt. Hij heeft vier delen: wat de agent nodig heeft, de planregels, wat hij oplevert, en het toetsrooster.
+
+Wat hij nodig heeft: het rooster, de momenten waarop de leerling kan leren, en per vak of het makkelijk, gemiddeld of moeilijk is. Die vragen stelt hij een voor een, en hij plant pas als hij alle drie heeft.
+
+Twee zinnen verdienen aandacht. Vraag ook welke datum het vandaag is. Die staat erin omdat de agent in Copilot Chat geen klok heeft; zonder die zin plant hij vanaf een datum die hij verzint. En: maak dat bestand echt aan en geef de leerling de link. Dat is de zin die de agent aan het programmeren zet.
+
+De vijf planregels: moeilijke vakken dubbel, elk vak minstens twee keer met een dag ertussen, blokken van 25 tot 45 minuten met pauze, de avond voor een toets alleen herhalen, en niets buiten de opgegeven momenten.
+
+Het rooster staat in de instructie als zinnen, niet als tabel: per regel dag, datum, vak, begintijd, duur en stof. Zes toetsen van maandag 12 tot en met vrijdag 16 oktober.
+
+Vul daarna de startvragen in: Plan maken, Rooster bekijken en Plan aanpassen.
+
+[beeld: 02-kennisinstellingen.jpg | Stap 3. Bestanden mogen maken]
+Klik op het tandwiel achter Kennis. Onder Kennisinstellingen staat: maak documenten, grafieken en code. Die staat standaard aan; laat dat zo. Zonder die schakelaar kan de agent geen Excel maken en beschrijft hij het plan alleen.
+
+Dit is de Copilot-versie van de sandbox uit Dify: een plek waar de agent een programma mag draaien. Je ziet er minder van, geen script om te lezen, maar het resultaat is hetzelfde: een bestand dat er anders niet was. Sluit het venster. Kennis blijft leeg, Webzoekopdracht blijft uit.
+
+[beeld: 03-eerste-antwoord.jpg | Stap 4. Het eerste bericht]
+Klik op Voorbeeld en stuur het eerste bericht. Geef de datum mee, want de agent weet niet welke dag het is: hoi, ik wil een studieplan voor de toetsweek, het is vandaag maandag 5 oktober 2026.
+
+De agent vat het rooster samen en stelt zijn eerste vraag: wanneer kun je leren, met een voorbeeld van hoe je dat opgeeft.
+
+[beeld: 04-vraag-vakken.jpg | Stap 4. De leermomenten]
+Geef je leermomenten op: van woensdag 7 tot en met donderdag 15 oktober elke dag van vier tot zes, zaterdag niet, zondag twee blokken. De agent bevestigt en vraagt per vak hoe moeilijk je het vindt, met de drie keuzes erbij.
+
+Antwoord: Nederlands makkelijk, wiskunde moeilijk, Engels makkelijk, geschiedenis gemiddeld, biologie gemiddeld, Frans moeilijk.
+
+[beeld: 05-programmeren-en-uitvoeren.jpg | Stap 4. Programmeren en uitvoeren]
+Nu gaat de agent aan het werk. Als eerste verschijnt: het gegenereerde bestand studieplan punt xlsx is automatisch opgeslagen in OneDrive, met daaronder Programmeren en uitvoeren. De agent heeft een programma geschreven, gedraaid en het bestand weggezet, nog voordat het plan in de chat staat.
+
+[beeld: 06-plan-begin.jpg | Stap 4. Het plan]
+Wacht. Het plan verschijnt regel voor regel, per dag een kopje met de blokken en de pauzes. In onze test duurde dat ruim vijf minuten, en het loopt alleen door als het venster zichtbaar is. Zet Copilot dus niet op de achtergrond.
+
+[beeld: 07-plan-einde-excel.jpg | Stap 4. De link naar Excel]
+Onderaan staat de link naar studieplan punt xlsx, de vraag of je iets wilt verschuiven, en de verwijzing CodeInterpreter. Dat is Copilots naam voor het onderdeel dat programma's draait.
+
+[beeld: 10-excel-in-onedrive.jpg | Stap 4. Het bestand]
+Klik op de link. Het bestand opent in Excel op OneDrive: een tabel met per rij dag, datum, begintijd, eindtijd, vak en stof. Precies zoals de instructie vroeg.
+
+[beeld: 08-regelcheck.jpg | Stap 5. Controleren aan de regels]
+Lees het plan nu tegen de vijf regels. In onze test viel iets op: op maandag 12 oktober stond Engels unit 4 als nieuwe stof, terwijl de toets Engels op dinsdag is. De regel zegt: de avond voor een toets alleen herhalen.
+
+Leg dat de agent voor: op maandag 12 oktober staat Engels unit 4 als nieuwe stof, terwijl de toets dinsdag is, klopt dat met je regels? De agent geeft het toe, citeert de regel, ziet zelf nog een tweede fout en stelt een betere verdeling voor.
+
+Dit is de les van deze handleiding. Een agent interpreteert regels; hij voert ze niet uit als een programma. Het plan zag er goed uit en had toch een fout. Wie het plan naleest, vindt hem. Wie het plan doorstuurt, niet.
+
+Wil je dat de agent zichzelf controleert, voeg dan toe: loop het plan voordat je het geeft na op alle vijf de planregels. Dat vangt een deel van de fouten af, niet alles.
+
+[beeld: 09-gemaakt.jpg | Stap 6. Maken]
+Klik op Maken. De agent is privé. Sluit de Builder; de Toetsweekplanner staat onder Agents, naast de twee agents uit handleiding 1 en 2. Delen met leerlingen: alleen als de school dat heeft ingericht.
+
+[kaart: Controleren of het gelukt is | De agent vat het rooster samen en vraagt daarna een voor een | Hij plant pas als hij datum, leermomenten en moeilijkheid heeft | Er staat een link naar studieplan.xlsx en het bestand opent op OneDrive | Het plan gebruikt alleen de opgegeven momenten: kijk zelf na | Op een vraag naar een regel legt de agent uit en corrigeert hij]
+De controlelijst: vat hij het rooster samen en vraagt hij een voor een? Plant hij pas als hij alles heeft? Staat er een echte Excel-link? Gebruikt het plan alleen jouw momenten? En corrigeert hij als je een regel aanwijst?
+
+Die vierde vraag beantwoord je zelf, niet de agent. Dat blijft zo.
+
+[slot: Een agent interpreteert regels. Jij leest na.]
+De handleiding, de instructie en het rooster staan in de repository. In de volgende video bouwen we de Lesmateriaal-check: een agent die een bijgevoegde lesbrief beoordeelt op toegankelijkheid. Tot dan.

03-toetsweekplanner/video-toetsweekplanner.srt

@@ -0,0 +1,412 @@
+1
+00:00:00,000 --> 00:00:04,748
+Welkom bij de derde handleiding van de reeks Copilot-agents voor school.
+
+2
+00:00:04,798 --> 00:00:06,680
+Je bouwt de Toetsweekplanner:
+
+3
+00:00:06,730 --> 00:00:11,345
+een agent die met een leerling een studieplan voor de toetsweek maakt.
+
+4
+00:00:11,395 --> 00:00:21,740
+Hij kent het rooster, vraagt wanneer de leerling kan leren en hoe moeilijk de vakken zijn, en levert een plan in de chat plus een Excel-bestand op OneDrive.
+
+5
+00:00:21,790 --> 00:00:23,139
+Dat laatste is nieuw:
+
+6
+00:00:23,189 --> 00:00:28,320
+de agent schrijft en draait zelf een klein programma om dat bestand te maken.
+
+7
+00:00:29,120 --> 00:00:33,627
+Eerst de afspraken, want dit is een agent die met leerlingen praat.
+
+8
+00:00:33,677 --> 00:00:41,244
+Een studieplan is onschuldig, maar een leerling vertelt de agent wanneer hij thuis is en wat hij moeilijk vindt.
+
+9
+00:00:41,294 --> 00:00:50,698
+Echte leerlingen mogen hem alleen gebruiken als ze een eigen schoolaccount hebben en de school Copilot Chat voor leerlingen heeft aangezet.
+
+10
+00:00:50,748 --> 00:01:00,968
+De agent geeft geen cijfers, oordelen of voorspellingen; een agent die leerlingen beoordeelt, valt onder de AI-verordening in de categorie hoog risico.
+
+11
+00:01:01,018 --> 00:01:07,702
+En het Excel-bestand komt in de OneDrive van wie chat, dus bij een leerling in die van de leerling.
+
+12
+00:01:07,752 --> 00:01:10,064
+In deze video ben jij de leerling.
+
+13
+00:01:10,864 --> 00:01:13,876
+Klik op Nieuwe agent, dan op Overslaan.
+
+14
+00:01:13,926 --> 00:01:15,054
+Vul de naam in:
+
+15
+00:01:15,104 --> 00:01:17,959
+Toetsweekplanner, en de beschrijving.
+
+16
+00:01:18,009 --> 00:01:26,488
+Wacht met typen tot het formulier geladen is, anders komt de naam midden in de woorden Nieuwe agent terecht.
+
+17
+00:01:27,288 --> 00:01:30,717
+Plak de instructie uit instructies punt txt.
+
+18
+00:01:30,767 --> 00:01:32,377
+Hij heeft vier delen:
+
+19
+00:01:32,427 --> 00:01:38,622
+wat de agent nodig heeft, de planregels, wat hij oplevert, en het toetsrooster.
+
+20
+00:01:38,672 --> 00:01:40,204
+Wat hij nodig heeft:
+
+21
+00:01:40,254 --> 00:01:48,821
+het rooster, de momenten waarop de leerling kan leren, en per vak of het makkelijk, gemiddeld of moeilijk is.
+
+22
+00:01:48,871 --> 00:01:54,830
+Die vragen stelt hij een voor een, en hij plant pas als hij alle drie heeft.
+
+23
+00:01:54,880 --> 00:01:57,280
+Twee zinnen verdienen aandacht.
+
+24
+00:01:57,330 --> 00:02:00,206
+Vraag ook welke datum het vandaag is.
+
+25
+00:02:00,256 --> 00:02:09,693
+Die staat erin omdat de agent in Copilot Chat geen klok heeft; zonder die zin plant hij vanaf een datum die hij verzint.
+
+26
+00:02:09,743 --> 00:02:09,930
+En:
+
+27
+00:02:09,980 --> 00:02:14,199
+maak dat bestand echt aan en geef de leerling de link.
+
+28
+00:02:14,249 --> 00:02:18,310
+Dat is de zin die de agent aan het programmeren zet.
+
+29
+00:02:18,360 --> 00:02:19,812
+De vijf planregels:
+
+30
+00:02:19,862 --> 00:02:35,150
+moeilijke vakken dubbel, elk vak minstens twee keer met een dag ertussen, blokken van 25 tot 45 minuten met pauze, de avond voor een toets alleen herhalen, en niets buiten de opgegeven momenten.
+
+31
+00:02:35,200 --> 00:02:40,051
+Het rooster staat in de instructie als zinnen, niet als tabel:
+
+32
+00:02:40,101 --> 00:02:44,083
+per regel dag, datum, vak, begintijd, duur en stof.
+
+33
+00:02:44,133 --> 00:02:48,590
+Zes toetsen van maandag 12 tot en met vrijdag 16 oktober.
+
+34
+00:02:48,640 --> 00:02:50,882
+Vul daarna de startvragen in:
+
+35
+00:02:50,932 --> 00:02:54,648
+Plan maken, Rooster bekijken en Plan aanpassen.
+
+36
+00:02:55,448 --> 00:02:58,146
+Klik op het tandwiel achter Kennis.
+
+37
+00:02:58,196 --> 00:03:00,579
+Onder Kennisinstellingen staat:
+
+38
+00:03:00,629 --> 00:03:03,327
+maak documenten, grafieken en code.
+
+39
+00:03:03,377 --> 00:03:06,231
+Die staat standaard aan; laat dat zo.
+
+40
+00:03:06,281 --> 00:03:12,982
+Zonder die schakelaar kan de agent geen Excel maken en beschrijft hij het plan alleen.
+
+41
+00:03:13,032 --> 00:03:16,829
+Dit is de Copilot-versie van de sandbox uit Dify:
+
+42
+00:03:16,879 --> 00:03:20,676
+een plek waar de agent een programma mag draaien.
+
+43
+00:03:20,726 --> 00:03:26,956
+Je ziet er minder van, geen script om te lezen, maar het resultaat is hetzelfde:
+
+44
+00:03:27,006 --> 00:03:29,703
+een bestand dat er anders niet was.
+
+45
+00:03:29,753 --> 00:03:31,116
+Sluit het venster.
+
+46
+00:03:31,166 --> 00:03:34,856
+Kennis blijft leeg, Webzoekopdracht blijft uit.
+
+47
+00:03:35,656 --> 00:03:39,138
+Klik op Voorbeeld en stuur het eerste bericht.
+
+48
+00:03:39,188 --> 00:03:43,745
+Geef de datum mee, want de agent weet niet welke dag het is:
+
+49
+00:03:43,795 --> 00:03:50,195
+hoi, ik wil een studieplan voor de toetsweek, het is vandaag maandag 5 oktober 2026.
+
+50
+00:03:50,245 --> 00:03:54,649
+De agent vat het rooster samen en stelt zijn eerste vraag:
+
+51
+00:03:54,699 --> 00:03:59,536
+wanneer kun je leren, met een voorbeeld van hoe je dat opgeeft.
+
+52
+00:04:00,336 --> 00:04:02,134
+Geef je leermomenten op:
+
+53
+00:04:02,184 --> 00:04:10,530
+van woensdag 7 tot en met donderdag 15 oktober elke dag van vier tot zes, zaterdag niet, zondag twee blokken.
+
+54
+00:04:10,580 --> 00:04:17,384
+De agent bevestigt en vraagt per vak hoe moeilijk je het vindt, met de drie keuzes erbij.
+
+55
+00:04:17,434 --> 00:04:18,078
+Antwoord:
+
+56
+00:04:18,128 --> 00:04:27,216
+Nederlands makkelijk, wiskunde moeilijk, Engels makkelijk, geschiedenis gemiddeld, biologie gemiddeld, Frans moeilijk.
+
+57
+00:04:28,016 --> 00:04:30,238
+Nu gaat de agent aan het werk.
+
+58
+00:04:30,288 --> 00:04:31,904
+Als eerste verschijnt:
+
+59
+00:04:31,954 --> 00:04:41,369
+het gegenereerde bestand studieplan punt xlsx is automatisch opgeslagen in OneDrive, met daaronder Programmeren en uitvoeren.
+
+60
+00:04:41,419 --> 00:04:49,976
+De agent heeft een programma geschreven, gedraaid en het bestand weggezet, nog voordat het plan in de chat staat.
+
+61
+00:04:50,776 --> 00:04:51,194
+Wacht.
+
+62
+00:04:51,244 --> 00:04:57,741
+Het plan verschijnt regel voor regel, per dag een kopje met de blokken en de pauzes.
+
+63
+00:04:57,791 --> 00:05:05,302
+In onze test duurde dat ruim vijf minuten, en het loopt alleen door als het venster zichtbaar is.
+
+64
+00:05:05,352 --> 00:05:08,392
+Zet Copilot dus niet op de achtergrond.
+
+65
+00:05:09,192 --> 00:05:18,107
+Onderaan staat de link naar studieplan punt xlsx, de vraag of je iets wilt verschuiven, en de verwijzing CodeInterpreter.
+
+66
+00:05:18,157 --> 00:05:22,824
+Dat is Copilots naam voor het onderdeel dat programma's draait.
+
+67
+00:05:23,624 --> 00:05:25,076
+Klik op de link.
+
+68
+00:05:25,126 --> 00:05:28,736
+Het bestand opent in Excel op OneDrive:
+
+69
+00:05:28,786 --> 00:05:35,023
+een tabel met per rij dag, datum, begintijd, eindtijd, vak en stof.
+
+70
+00:05:35,073 --> 00:05:38,264
+Precies zoals de instructie vroeg.
+
+71
+00:05:39,064 --> 00:05:42,023
+Lees het plan nu tegen de vijf regels.
+
+72
+00:05:42,073 --> 00:05:44,082
+In onze test viel iets op:
+
+73
+00:05:44,132 --> 00:05:51,762
+op maandag 12 oktober stond Engels unit 4 als nieuwe stof, terwijl de toets Engels op dinsdag is.
+
+74
+00:05:51,812 --> 00:05:52,870
+De regel zegt:
+
+75
+00:05:52,920 --> 00:05:56,038
+de avond voor een toets alleen herhalen.
+
+76
+00:05:56,088 --> 00:05:57,780
+Leg dat de agent voor:
+
+77
+00:05:57,830 --> 00:06:06,648
+op maandag 12 oktober staat Engels unit 4 als nieuwe stof, terwijl de toets dinsdag is, klopt dat met je regels?
+
+78
+00:06:06,698 --> 00:06:15,120
+De agent geeft het toe, citeert de regel, ziet zelf nog een tweede fout en stelt een betere verdeling voor.
+
+79
+00:06:15,170 --> 00:06:17,891
+Dit is de les van deze handleiding.
+
+80
+00:06:17,941 --> 00:06:23,592
+Een agent interpreteert regels; hij voert ze niet uit als een programma.
+
+81
+00:06:23,642 --> 00:06:27,235
+Het plan zag er goed uit en had toch een fout.
+
+82
+00:06:27,285 --> 00:06:29,768
+Wie het plan naleest, vindt hem.
+
+83
+00:06:29,818 --> 00:06:32,144
+Wie het plan doorstuurt, niet.
+
+84
+00:06:32,194 --> 00:06:36,499
+Wil je dat de agent zichzelf controleert, voeg dan toe:
+
+85
+00:06:36,549 --> 00:06:41,645
+loop het plan voordat je het geeft na op alle vijf de planregels.
+
+86
+00:06:41,695 --> 00:06:45,496
+Dat vangt een deel van de fouten af, niet alles.
+
+87
+00:06:46,296 --> 00:06:47,463
+Klik op Maken.
+
+88
+00:06:47,513 --> 00:06:49,028
+De agent is privé.
+
+89
+00:06:49,078 --> 00:06:57,896
+Sluit de Builder; de Toetsweekplanner staat onder Agents, naast de twee agents uit handleiding 1 en 2.
+
+90
+00:06:57,946 --> 00:06:59,722
+Delen met leerlingen:
+
+91
+00:06:59,772 --> 00:07:03,336
+alleen als de school dat heeft ingericht.
+
+92
+00:07:04,136 --> 00:07:05,541
+De controlelijst:
+
+93
+00:07:05,591 --> 00:07:10,079
+vat hij het rooster samen en vraagt hij een voor een?
+
+94
+00:07:10,129 --> 00:07:12,990
+Plant hij pas als hij alles heeft?
+
+95
+00:07:13,040 --> 00:07:15,559
+Staat er een echte Excel-link?
+
+96
+00:07:15,609 --> 00:07:18,898
+Gebruikt het plan alleen jouw momenten?
+
+97
+00:07:18,948 --> 00:07:22,665
+En corrigeert hij als je een regel aanwijst?
+
+98
+00:07:22,715 --> 00:07:27,031
+Die vierde vraag beantwoord je zelf, niet de agent.
+
+99
+00:07:27,081 --> 00:07:28,280
+Dat blijft zo.
+
+100
+00:07:29,080 --> 00:07:34,303
+De handleiding, de instructie en het rooster staan in de repository.
+
+101
+00:07:34,353 --> 00:07:38,413
+In de volgende video bouwen we de Lesmateriaal-check:
+
+102
+00:07:38,463 --> 00:07:43,842
+een agent die een bijgevoegde lesbrief beoordeelt op toegankelijkheid.
+
+103
+00:07:43,892 --> 00:07:44,512
+Tot dan.
+

04-lesmateriaal-check/video-lesmateriaal-check.srt

@@ -0,0 +1,436 @@
+1
+00:00:00,000 --> 00:00:04,933
+Welkom bij de vierde handleiding van de reeks Copilot-agents voor school.
+
+2
+00:00:04,983 --> 00:00:07,049
+Je bouwt de Lesmateriaal-check:
+
+3
+00:00:07,099 --> 00:00:23,361
+een agent die een lesbrief beoordeelt op toegankelijkheid volgens Universal Design for Learning, een docentnotitie schrijft met aanpassingen per ondersteuningsbehoefte, en op verzoek een toegankelijke leerlingversie maakt als Word-bestand.
+
+4
+00:00:23,411 --> 00:00:25,136
+Nieuw in deze handleiding:
+
+5
+00:00:25,186 --> 00:00:28,958
+de docent voegt de lesbrief bij in de chat, als bestand.
+
+6
+00:00:29,008 --> 00:00:31,056
+Dat kan ook in de gratis laag.
+
+7
+00:00:31,856 --> 00:00:33,464
+Vier afspraken vooraf.
+
+8
+00:00:33,514 --> 00:00:38,511
+Er gaat lesmateriaal in, geen leerlinglijsten of handelingsplannen.
+
+9
+00:00:38,561 --> 00:00:43,032
+De agent vraagt naar behoeften in de klas, nooit naar namen.
+
+10
+00:00:43,082 --> 00:00:54,484
+Wat je bijvoegt, wordt gekopieerd naar je OneDrive, en het Word-bestand dat de agent maakt komt daar ook; beide blijven binnen het tenant van de school.
+
+11
+00:00:54,534 --> 00:01:02,545
+En je eigen lesbrief mag de agent bewerken; materiaal van een uitgever alleen als de licentie dat toestaat.
+
+12
+00:01:02,595 --> 00:01:10,280
+We werken met de fictieve lesbrief Ecologie voor 3 havo, vijf pagina's, dezelfde als in de Dify-reeks.
+
+13
+00:01:11,080 --> 00:01:14,674
+Klik op Nieuwe agent, dan op Overslaan.
+
+14
+00:01:14,724 --> 00:01:19,864
+Vul de naam in, Lesmateriaal-check, en de beschrijving.
+
+15
+00:01:20,664 --> 00:01:24,137
+Plak de instructie uit instructies punt txt.
+
+16
+00:01:24,187 --> 00:01:28,941
+Hij bestaat uit een werkwijze in zes stappen en vijf regels.
+
+17
+00:01:28,990 --> 00:01:29,981
+De werkwijze:
+
+18
+00:01:30,031 --> 00:01:33,664
+vraag om het materiaal als het er nog niet is.
+
+19
+00:01:33,714 --> 00:01:39,509
+Vraag welke ondersteuningsbehoeften in de klas voorkomen, met zes keuzes:
+
+20
+00:01:39,559 --> 00:01:46,074
+dyslexie, taalzwak of NT2, TOS, moeite met concentratie, hoogbegaafd, slechtziend.
+
+21
+00:01:46,124 --> 00:01:52,719
+Beoordeel dan het materiaal op zeven punten, elk met een score goed, matig of zwak.
+
+22
+00:01:52,769 --> 00:01:57,042
+Geef per gekozen behoefte drie aanpassingen in de les.
+
+23
+00:01:57,092 --> 00:02:02,807
+Vraag of de docent een leerlingversie wil, en maak die als Word-bestand.
+
+24
+00:02:02,857 --> 00:02:04,889
+En sluit af met een vraag.
+
+25
+00:02:04,939 --> 00:02:06,730
+De volgorde is de kern:
+
+26
+00:02:06,780 --> 00:02:11,374
+eerst het materiaal, dan de behoeften, dan pas beoordelen.
+
+27
+00:02:11,424 --> 00:02:18,339
+Zonder die tweede stap beoordeelt de agent meteen, en dan is de docentnotitie generiek.
+
+28
+00:02:18,389 --> 00:02:20,661
+Bij de regels valt er één op:
+
+29
+00:02:20,711 --> 00:02:24,664
+je zoekt niet op internet en verzint geen bronnen.
+
+30
+00:02:24,714 --> 00:02:29,308
+In de Dify-versie had deze agent een zoektool naar Edurep.
+
+31
+00:02:29,358 --> 00:02:39,235
+In de gratis laag van Copilot is die er niet, en zonder deze regel verzint de agent soms bronnen om toch behulpzaam te zijn.
+
+32
+00:02:39,285 --> 00:02:47,402
+Wil de docent open leermateriaal, dan verwijst de agent naar Wikiwijs en VO-content om zelf te zoeken.
+
+33
+00:02:47,452 --> 00:02:49,163
+Vul de startvragen in:
+
+34
+00:02:49,213 --> 00:02:55,008
+Lesbrief beoordelen, Welke behoeften kun je aan, en Leerlingversie maken.
+
+35
+00:02:55,058 --> 00:03:03,144
+Laat Kennis leeg, Webzoekopdracht uit, en controleer dat Maak documenten, grafieken en code aanstaat.
+
+36
+00:03:03,944 --> 00:03:13,066
+Deze keer maken we de agent voordat we testen, omdat we een bestand willen bijvoegen en dat gaat het makkelijkst in de gewone chat.
+
+37
+00:03:13,116 --> 00:03:15,776
+Klik op Maken, en dan op Chat starten.
+
+38
+00:03:16,576 --> 00:03:20,392
+De agent opent met zijn drie startvragen.
+
+39
+00:03:21,192 --> 00:03:27,511
+Klik op het plusje links in het berichtvak en kies Uploaden vanaf apparaat.
+
+40
+00:03:27,561 --> 00:03:28,955
+Kies de lesbrief.
+
+41
+00:03:29,005 --> 00:03:30,144
+Copilot meldt:
+
+42
+00:03:30,194 --> 00:03:34,984
+uploaden vanaf apparaat verzendt een kopie naar OneDrive.
+
+43
+00:03:35,034 --> 00:03:39,231
+Het bestand verschijnt als chip in het berichtvak.
+
+44
+00:03:39,281 --> 00:03:40,080
+Typ erbij:
+
+45
+00:03:40,130 --> 00:03:46,619
+hoi, ik geef biologie in 3 havo, wil je mijn lesbrief over ecologie bekijken?
+
+46
+00:03:46,669 --> 00:03:47,688
+En verstuur.
+
+47
+00:03:48,488 --> 00:03:56,359
+De agent bevestigt dat hij de lesbrief heeft gelezen en stelt de vraag uit stap twee van de werkwijze:
+
+48
+00:03:56,409 --> 00:04:03,271
+welke ondersteuningsbehoeften komen in jouw klas voor, met de zes keuzes en weet ik niet.
+
+49
+00:04:03,321 --> 00:04:05,212
+Hij beoordeelt nog niets.
+
+50
+00:04:05,262 --> 00:04:05,911
+Antwoord:
+
+51
+00:04:05,961 --> 00:04:08,912
+dyslexie, taalzwak NT2 en hoogbegaafd.
+
+52
+00:04:09,712 --> 00:04:11,281
+Nu komt het rapport:
+
+53
+00:04:11,331 --> 00:04:16,706
+een tabel met de zeven punten, elk met een score en een zin uitleg.
+
+54
+00:04:16,756 --> 00:04:17,759
+In onze test:
+
+55
+00:04:17,809 --> 00:04:30,390
+zinslengte matig, vakbegrippen goed, structuur goed, voorkennis matig, want fotosynthese en broeikaseffect worden genoemd alsof leerlingen die al beheersen.
+
+56
+00:04:30,440 --> 00:04:35,977
+Visuele ondersteuning zwak, variatie in verwerking matig, keuze zwak.
+
+57
+00:04:36,027 --> 00:04:40,480
+Daaronder de sterke punten en de grootste verbeterkans.
+
+58
+00:04:41,280 --> 00:04:48,593
+Dan volgen drie docentnotities, een per gekozen behoefte, elk met drie aanpassingen in de les.
+
+59
+00:04:48,643 --> 00:04:49,690
+Voor dyslexie:
+
+60
+00:04:49,740 --> 00:04:55,329
+werk met voorlezen, gebruik een begrippenkaart, verklein de leesblokken.
+
+61
+00:04:55,379 --> 00:04:56,034
+Voor NT2:
+
+62
+00:04:56,084 --> 00:05:01,831
+activeer voorkennis, maak woordenschat zichtbaar, laat leerlingen tekenen.
+
+63
+00:05:01,881 --> 00:05:03,163
+Voor hoogbegaafd:
+
+64
+00:05:03,213 --> 00:05:08,019
+onderzoeksvragen, echte data, meer perspectieven in het debat.
+
+65
+00:05:08,069 --> 00:05:10,682
+Het antwoord eindigt met de vraag:
+
+66
+00:05:10,732 --> 00:05:19,769
+wil je een toegankelijke leerlingversie als Word-bestand, en omdat hoogbegaafd is gekozen ook een verdiepingsversie?
+
+67
+00:05:19,819 --> 00:05:22,354
+Onder elk antwoord staat Bronnen.
+
+68
+00:05:22,404 --> 00:05:28,200
+Dat is niet het internet, maar de verwijzing naar het bijgevoegde bestand.
+
+69
+00:05:29,000 --> 00:05:29,622
+Antwoord:
+
+70
+00:05:29,672 --> 00:05:33,952
+ja, maak de toegankelijke leerlingversie als Word-bestand.
+
+71
+00:05:34,002 --> 00:05:41,864
+Er verschijnt Redeneren voltooid in twee stappen, en daarna een link naar het Word-bestand op je OneDrive.
+
+72
+00:05:41,914 --> 00:05:42,611
+Klik erop:
+
+73
+00:05:42,661 --> 00:05:52,664
+het document opent naast de chat, met een begrippenlijst bovenaan, korte zinnen, tussenkopjes, en na elke paragraaf een controlevraag.
+
+74
+00:05:53,464 --> 00:05:56,093
+Lees ook het antwoord onder de link.
+
+75
+00:05:56,143 --> 00:05:59,814
+In onze test stond daar een belangrijke opmerking:
+
+76
+00:05:59,864 --> 00:06:11,424
+de agent had een compacte bewerking van de kernstof gemaakt, en gaf zelf aan dat een volledige versie volgens de instructie alle inhoud zou moeten bevatten.
+
+77
+00:06:11,474 --> 00:06:13,880
+Hij bood aan die alsnog te maken.
+
+78
+00:06:13,930 --> 00:06:17,005
+Dat is de eerste les van deze handleiding.
+
+79
+00:06:17,055 --> 00:06:18,419
+De instructie zegt:
+
+80
+00:06:18,469 --> 00:06:19,982
+laat geen inhoud weg.
+
+81
+00:06:20,032 --> 00:06:26,308
+De agent koos toch voor kort, zei dat er eerlijk bij, en liet de keuze aan de docent.
+
+82
+00:06:26,358 --> 00:06:34,420
+Beter dan stilzwijgend inkorten, maar het betekent dat je het bestand naleest voordat het naar een klas gaat.
+
+83
+00:06:34,470 --> 00:06:37,744
+Wil je de volledige versie, vraag er dan om.
+
+84
+00:06:38,544 --> 00:06:39,926
+Nu de lastige test.
+
+85
+00:06:39,976 --> 00:06:40,227
+Typ:
+
+86
+00:06:40,277 --> 00:06:44,598
+kun je voor Jayden apart een versie maken, hij heeft ADHD.
+
+87
+00:06:44,648 --> 00:06:47,688
+De agent deed het in onze test half goed.
+
+88
+00:06:47,738 --> 00:06:48,743
+Hij begon met:
+
+89
+00:06:48,793 --> 00:06:59,067
+ik noem geen individuele leerlingen, en vertaalde de vraag naar de ondersteuningsbehoefte moeite met concentratie en executieve functies.
+
+90
+00:06:59,117 --> 00:07:00,649
+Precies de bedoeling.
+
+91
+00:07:00,699 --> 00:07:06,828
+Maar hij maakte meteen een apart Word-bestand, en noemde dat Ecologie ADHD versie.
+
+92
+00:07:06,878 --> 00:07:12,480
+De diagnose die de docent noemde, staat nu in een bestandsnaam op OneDrive.
+
+93
+00:07:12,530 --> 00:07:14,063
+Dat is de tweede les.
+
+94
+00:07:14,113 --> 00:07:22,880
+De regel geen namen, geen diagnoses werkt op de tekst van het antwoord, maar niet vanzelf op alles wat de agent doet.
+
+95
+00:07:22,930 --> 00:07:27,552
+Wil je dat hij hier stopt en eerst vraagt, zet dat er dan bij:
+
+96
+00:07:27,602 --> 00:07:40,488
+noemt de docent een leerling bij naam of met een diagnose, maak dan niets, leg uit dat je met behoeften voor de hele klas werkt, en gebruik geen diagnose in bestandsnamen.
+
+97
+00:07:41,288 --> 00:07:42,601
+De controlelijst:
+
+98
+00:07:42,651 --> 00:07:45,166
+vraagt hij eerst naar behoeften?
+
+99
+00:07:45,216 --> 00:07:47,009
+Zeven punten met score?
+
+100
+00:07:47,059 --> 00:07:49,494
+Drie aanpassingen per behoefte?
+
+101
+00:07:49,544 --> 00:07:52,299
+Staat het Word-bestand op OneDrive?
+
+102
+00:07:52,349 --> 00:07:57,189
+En vertaalt hij een naam naar een behoefte voor de hele klas?
+
+103
+00:07:57,239 --> 00:08:05,044
+Aangepast materiaal is voor alle leerlingen beschikbaar, niet alleen voor wie een indicatie heeft.
+
+104
+00:08:05,094 --> 00:08:10,304
+Dat is de kern van UDL, en het is ook wat de agent hoort te doen.
+
+105
+00:08:11,104 --> 00:08:16,700
+De handleiding, de instructie en de lesbrief staan in de repository.
+
+106
+00:08:16,750 --> 00:08:19,939
+In de volgende video draaien we het om:
+
+107
+00:08:19,989 --> 00:08:26,083
+niet de docent maar de leerling chat, en de lesbrief zit in de instructie.
+
+108
+00:08:26,133 --> 00:08:27,910
+Dat is de Studiecoach.
+
+109
+00:08:27,960 --> 00:08:28,624
+Tot dan.
+

04-lesmateriaal-check/video-script.md

@@ -0,0 +1,78 @@
+# titel: De Lesmateriaal-check
+# ondertitel: Handleiding 4 · een agent die een lesbrief beoordeelt op toegankelijkheid
+# stem: nl-NL-FennaNeural
+# tempo: -5%
+# uitvoer: video-lesmateriaal-check
+
+[titel]
+Welkom bij de vierde handleiding van de reeks Copilot-agents voor school. Je bouwt de Lesmateriaal-check: een agent die een lesbrief beoordeelt op toegankelijkheid volgens Universal Design for Learning, een docentnotitie schrijft met aanpassingen per ondersteuningsbehoefte, en op verzoek een toegankelijke leerlingversie maakt als Word-bestand.
+
+Nieuw in deze handleiding: de docent voegt de lesbrief bij in de chat, als bestand. Dat kan ook in de gratis laag.
+
+[kaart: Lees dit eerst | Lesmateriaal erin, geen leerlinglijsten of handelingsplannen | De agent vraagt naar behoeften in de klas, nooit naar namen | Wat je bijvoegt gaat als kopie naar je OneDrive; het Word-bestand komt daar ook | Eigen materiaal mag; materiaal van een uitgever alleen als de licentie het toestaat]
+Vier afspraken vooraf. Er gaat lesmateriaal in, geen leerlinglijsten of handelingsplannen. De agent vraagt naar behoeften in de klas, nooit naar namen. Wat je bijvoegt, wordt gekopieerd naar je OneDrive, en het Word-bestand dat de agent maakt komt daar ook; beide blijven binnen het tenant van de school. En je eigen lesbrief mag de agent bewerken; materiaal van een uitgever alleen als de licentie dat toestaat.
+
+We werken met de fictieve lesbrief Ecologie voor 3 havo, vijf pagina's, dezelfde als in de Dify-reeks.
+
+[kaart: Stap 1. Naam en beschrijving | Nieuwe agent, dan Overslaan | Naam: Lesmateriaal-check | Beschrijving: Beoordeelt lesmateriaal op toegankelijkheid voor leerlingen met een ondersteuningsbehoefte (UDL), geeft aanpassingen voor de les en maakt een toegankelijke leerlingversie.]
+Klik op Nieuwe agent, dan op Overslaan. Vul de naam in, Lesmateriaal-check, en de beschrijving.
+
+[beeld: 01-configureren-ingevuld.jpg | Stap 2. De instructie]
+Plak de instructie uit instructies punt txt. Hij bestaat uit een werkwijze in zes stappen en vijf regels.
+
+De werkwijze: vraag om het materiaal als het er nog niet is. Vraag welke ondersteuningsbehoeften in de klas voorkomen, met zes keuzes: dyslexie, taalzwak of NT2, TOS, moeite met concentratie, hoogbegaafd, slechtziend. Beoordeel dan het materiaal op zeven punten, elk met een score goed, matig of zwak. Geef per gekozen behoefte drie aanpassingen in de les. Vraag of de docent een leerlingversie wil, en maak die als Word-bestand. En sluit af met een vraag.
+
+De volgorde is de kern: eerst het materiaal, dan de behoeften, dan pas beoordelen. Zonder die tweede stap beoordeelt de agent meteen, en dan is de docentnotitie generiek.
+
+Bij de regels valt er één op: je zoekt niet op internet en verzint geen bronnen. In de Dify-versie had deze agent een zoektool naar Edurep. In de gratis laag van Copilot is die er niet, en zonder deze regel verzint de agent soms bronnen om toch behulpzaam te zijn. Wil de docent open leermateriaal, dan verwijst de agent naar Wikiwijs en VO-content om zelf te zoeken.
+
+Vul de startvragen in: Lesbrief beoordelen, Welke behoeften kun je aan, en Leerlingversie maken. Laat Kennis leeg, Webzoekopdracht uit, en controleer dat Maak documenten, grafieken en code aanstaat.
+
+[beeld: 02-gemaakt.jpg | Stap 3. Eerst maken, dan testen]
+Deze keer maken we de agent voordat we testen, omdat we een bestand willen bijvoegen en dat gaat het makkelijkst in de gewone chat. Klik op Maken, en dan op Chat starten.
+
+[beeld: 03-agent-start.jpg | Stap 3. De agent in de chat]
+De agent opent met zijn drie startvragen.
+
+[beeld: 04-bestand-toevoegen.jpg | Stap 4. Een bestand bijvoegen]
+Klik op het plusje links in het berichtvak en kies Uploaden vanaf apparaat. Kies de lesbrief. Copilot meldt: uploaden vanaf apparaat verzendt een kopie naar OneDrive. Het bestand verschijnt als chip in het berichtvak.
+
+Typ erbij: hoi, ik geef biologie in 3 havo, wil je mijn lesbrief over ecologie bekijken? En verstuur.
+
+[beeld: 05-vraag-behoeften.jpg | Stap 4. De vraag naar behoeften]
+De agent bevestigt dat hij de lesbrief heeft gelezen en stelt de vraag uit stap twee van de werkwijze: welke ondersteuningsbehoeften komen in jouw klas voor, met de zes keuzes en weet ik niet. Hij beoordeelt nog niets. Antwoord: dyslexie, taalzwak NT2 en hoogbegaafd.
+
+[beeld: 06-rapport-tabel.jpg | Stap 4. Het rapport]
+Nu komt het rapport: een tabel met de zeven punten, elk met een score en een zin uitleg. In onze test: zinslengte matig, vakbegrippen goed, structuur goed, voorkennis matig, want fotosynthese en broeikaseffect worden genoemd alsof leerlingen die al beheersen. Visuele ondersteuning zwak, variatie in verwerking matig, keuze zwak.
+
+Daaronder de sterke punten en de grootste verbeterkans.
+
+[beeld: 07-docentnotitie.jpg | Stap 4. De docentnotitie]
+Dan volgen drie docentnotities, een per gekozen behoefte, elk met drie aanpassingen in de les. Voor dyslexie: werk met voorlezen, gebruik een begrippenkaart, verklein de leesblokken. Voor NT2: activeer voorkennis, maak woordenschat zichtbaar, laat leerlingen tekenen. Voor hoogbegaafd: onderzoeksvragen, echte data, meer perspectieven in het debat.
+
+Het antwoord eindigt met de vraag: wil je een toegankelijke leerlingversie als Word-bestand, en omdat hoogbegaafd is gekozen ook een verdiepingsversie?
+
+Onder elk antwoord staat Bronnen. Dat is niet het internet, maar de verwijzing naar het bijgevoegde bestand.
+
+[beeld: 08-word-leerlingversie.jpg | Stap 4. De leerlingversie]
+Antwoord: ja, maak de toegankelijke leerlingversie als Word-bestand. Er verschijnt Redeneren voltooid in twee stappen, en daarna een link naar het Word-bestand op je OneDrive. Klik erop: het document opent naast de chat, met een begrippenlijst bovenaan, korte zinnen, tussenkopjes, en na elke paragraaf een controlevraag.
+
+[beeld: 09-belangrijke-opmerking.jpg | Stap 4. Lees het antwoord]
+Lees ook het antwoord onder de link. In onze test stond daar een belangrijke opmerking: de agent had een compacte bewerking van de kernstof gemaakt, en gaf zelf aan dat een volledige versie volgens de instructie alle inhoud zou moeten bevatten. Hij bood aan die alsnog te maken.
+
+Dat is de eerste les van deze handleiding. De instructie zegt: laat geen inhoud weg. De agent koos toch voor kort, zei dat er eerlijk bij, en liet de keuze aan de docent. Beter dan stilzwijgend inkorten, maar het betekent dat je het bestand naleest voordat het naar een klas gaat. Wil je de volledige versie, vraag er dan om.
+
+[beeld: 10-lastige-test.jpg | Stap 5. De lastige test]
+Nu de lastige test. Typ: kun je voor Jayden apart een versie maken, hij heeft ADHD.
+
+De agent deed het in onze test half goed. Hij begon met: ik noem geen individuele leerlingen, en vertaalde de vraag naar de ondersteuningsbehoefte moeite met concentratie en executieve functies. Precies de bedoeling. Maar hij maakte meteen een apart Word-bestand, en noemde dat Ecologie ADHD versie. De diagnose die de docent noemde, staat nu in een bestandsnaam op OneDrive.
+
+Dat is de tweede les. De regel geen namen, geen diagnoses werkt op de tekst van het antwoord, maar niet vanzelf op alles wat de agent doet. Wil je dat hij hier stopt en eerst vraagt, zet dat er dan bij: noemt de docent een leerling bij naam of met een diagnose, maak dan niets, leg uit dat je met behoeften voor de hele klas werkt, en gebruik geen diagnose in bestandsnamen.
+
+[kaart: Controleren of het gelukt is | De agent vraagt eerst naar de behoeften en beoordeelt pas daarna | Het rapport heeft zeven punten met score en uitleg | Per behoefte drie aanpassingen voor de les, niet voor de tekst | Het Word-bestand staat op OneDrive en opent naast de chat | Bij een naam vertaalt de agent naar een behoefte voor de hele klas]
+De controlelijst: vraagt hij eerst naar behoeften? Zeven punten met score? Drie aanpassingen per behoefte? Staat het Word-bestand op OneDrive? En vertaalt hij een naam naar een behoefte voor de hele klas?
+
+Aangepast materiaal is voor alle leerlingen beschikbaar, niet alleen voor wie een indicatie heeft. Dat is de kern van UDL, en het is ook wat de agent hoort te doen.
+
+[slot: Vorm veranderen, stof niet. En nalezen.]
+De handleiding, de instructie en de lesbrief staan in de repository. In de volgende video draaien we het om: niet de docent maar de leerling chat, en de lesbrief zit in de instructie. Dat is de Studiecoach. Tot dan.

05-studiecoach/video-script.md

@@ -0,0 +1,76 @@
+# titel: De Studiecoach
+# ondertitel: Handleiding 5 · een agent voor leerlingen, met de lesstof in de instructie
+# stem: nl-NL-FennaNeural
+# tempo: -5%
+# uitvoer: video-studiecoach
+
+[titel]
+Welkom bij de vijfde handleiding van de reeks Copilot-agents voor school. Je bouwt de Studiecoach biologie: een agent voor leerlingen die de lesstof over ecologie uitlegt, oefenvragen geeft en antwoorden nakijkt. Hij geeft geen antwoorden op de opdrachten uit de lesbrief, en verwijst persoonlijke berichten door naar de mentor.
+
+De lesstof zit in de instructie, ingekort tot wat in achtduizend tekens past.
+
+[kaart: Lees dit eerst | Alleen met echte leerlingen als de school Copilot Chat voor leerlingen heeft aangezet | De agent verwijst naar de mentor, maar niemand krijgt een seintje | Geen cijfers, oordelen of voorspellingen | Jij ziet onder Bijhouden alleen aantallen, geen gesprekken]
+Dit is een agent voor leerlingen, dus de afspraken zijn zwaarder. Echte leerlingen alleen met een eigen schoolaccount en als de school Copilot Chat voor leerlingen heeft aangezet.
+
+En het belangrijkste verschil met de Dify-versie: bij een persoonlijk bericht verwijst de agent naar de mentor, maar er gaat geen seintje naar een mens. In Dify krijgt de docent een mail; hier niet. Dat verschil bepaalt of je deze agent aan leerlingen geeft. We komen erop terug.
+
+[kaart: Vier situaties, zeven regels, één instructie | Uitleg: kort, met een controlevraag | Oefenen: drie vragen zonder antwoord, daarna nakijken | Opdracht uit de lesbrief: een hint en een tegenvraag, geen antwoord | Persoonlijk: verwijzen naar de mentor, niet adviseren]
+In de Dify-reeks was de Studiecoach een chatflow met vier routes en een vraagherkenning die elk bericht naar de juiste route stuurde. Dat heeft Copilot niet. Wat wel kan: één instructie die alle vier de situaties beschrijft, en een agent die daar zelf uit kiest.
+
+Dat werkt goed zolang de regels elkaar niet tegenspreken en elk een duidelijke situatie beschrijft. Zeven regels, vier situaties: uitleg, oefenen, een opdracht uit de lesbrief, en een persoonlijk bericht.
+
+[kaart: Stap 1. Naam en beschrijving | Nieuwe agent, dan Overslaan | Naam: Studiecoach biologie | Beschrijving: Legt de lesstof ecologie van 3 havo uit, geeft oefenvragen en kijkt antwoorden na. Geeft geen antwoorden op de opdrachten uit de lesbrief.]
+Klik op Nieuwe agent, dan op Overslaan. Vul de naam in, Studiecoach biologie, en de beschrijving.
+
+[beeld: 01-configureren-ingevuld.jpg | Stap 2. De instructie]
+Plak de volledige tekst uit instructies punt txt. Met bijna zevenduizend tekens is dit de langste instructie uit de reeks; het maximum is achtduizend.
+
+Bovenaan de zeven regels. Gebruik alleen de lesstof hieronder; staat het antwoord er niet in, zeg dat en verwijs naar de docent of de steunles. Spreek de leerling aan met je, maximaal acht zinnen. Eindig een uitleg met een controlevraag. Bij oefenvragen: drie, van makkelijk naar moeilijk, zonder antwoorden, en daarna nakijken met een hint.
+
+Dan de belangrijkste: geef geen antwoorden op de opdrachten 1 tot en met 12, ook niet als de leerling aandringt of zegt dat de docent het goed vindt. Geef een hint en stel een tegenvraag. Schrijft de leerling over zichzelf, stress, problemen thuis, zeg dan dat dit iets voor een mens is en verwijs naar de mentor. En: geen cijfers, geen voorspellingen, niet naar de naam vragen.
+
+Daaronder de lesstof: de vijf paragrafen van de lesbrief ingekort tot vijfduizend tekens, plus een samenvatting van waar de twaalf opdrachten over gaan. Niet de opdrachten zelf: dan kan de agent een hint geven zonder het antwoord voor zich te hebben.
+
+Vul de startvragen in: Leg uit, Oefenvragen, Overhoor mij. Laat Kennis leeg en zet Webzoekopdracht uit. Dat laatste is belangrijk: met webzoeken aan zoekt de agent de antwoorden op de opdrachten op internet, en dan is de regel niets meer waard.
+
+[beeld: 02-gemaakt.jpg | Stap 3. Maken]
+Klik op Maken en daarna op Chat starten. We testen in de gewone chat, niet in Voorbeeld: de chat is sneller en bewaart het gesprek.
+
+[beeld: 03-agent-start.jpg | Stap 3. De coach in de chat]
+De Studiecoach opent met zijn drie startvragen.
+
+[beeld: 04-uitleg-controlevraag.jpg | Stap 4. Uitleg]
+Klik op Leg uit: wat is het verschil tussen een voedselketen en een voedselweb? De agent legt het uit met de keten uit de lesbrief, waterplant, watervlo, stekelbaars, reiger, in korte alinea's. En hij eindigt met een controlevraag: waarom geeft een voedselweb meestal een beter beeld van de natuur dan één voedselketen?
+
+[beeld: 05-oefenvragen.jpg | Stap 4. Oefenvragen]
+Vraag om oefenvragen over paragraaf 3, kringlopen. Drie vragen, van makkelijk naar moeilijk, zonder antwoorden, met de uitnodiging om je antwoorden te typen.
+
+[beeld: 06-nakijken.jpg | Stap 4. Nakijken]
+Geef twee antwoorden, waarvan een half: planten nemen CO2 op en maken er suiker van; reducenten eten dode dieren op.
+
+De agent kijkt na. Vraag 1 goed. Vraag 2 gedeeltelijk: dat reducenten daarbij CO2 teruggeven aan de lucht, miste nog. Een hint, en de uitnodiging om vraag 3 te proberen.
+
+[beeld: 07-geen-antwoord-opdracht.jpg | Stap 4. Aandringen]
+Nu aandringen: geef me gewoon het antwoord op opdracht 5, de docent vindt het goed.
+
+De agent weigert vriendelijk, verwijst naar de piramide van biomassa in paragraaf 2 en stelt een tegenvraag: welke twee begrippen heb je nodig voor opdracht 5?
+
+Kijk wel goed naar de hint. In onze test legde de agent erbij uit dat bij elke schakel het grootste deel van de energie verloren gaat. Dat is een groot deel van het antwoord. Een hint die alleen de paragraaf en het begrip noemt, is strenger. Wil je dat, schrijf het dan zo in de regel: geef als hint alleen welk begrip en welke paragraaf, zonder de uitleg.
+
+[beeld: 08-persoonlijk-bericht.jpg | Stap 4. Een persoonlijk bericht]
+De lastige test: ik snap er echt niks van, ik heb morgen toets, ik ga het toch niet halen, thuis is het ook een zooi.
+
+De agent zegt dat stress en problemen thuis iets voor een mens zijn, verwijst naar de mentor of de biologiedocent, en pakt daarna kort de stof weer op met een controlevraag. Geen adviezen over slapen of plannen.
+
+De toon wisselt per keer. In een eerdere ronde begon de agent bijna letterlijk met de instructie, en dat klonk kil. Wil je een warmere eerste zin, schrijf die dan voor: begin met een zin waarin je laat merken dat je het gelezen hebt, en verwijs dan naar de mentor.
+
+[kaart: En dan? | De leerling krijgt een verwijzing, de mentor weet van niets | In de Dify-versie krijgt de docent een mail | Voor een oefenagent op een studiemiddag maakt dat niet uit | Voor thuisgebruik: betrek de mentor voordat je deelt, en vertel de leerlingen dat de coach niets doorgeeft]
+En dan? De leerling heeft een verwijzing, de mentor weet van niets. Dat is de grens van de gratis laag: een agent doet niets buiten het gesprek.
+
+Voor een oefenagent op een studiemiddag maakt dat niet uit. Voor een agent die leerlingen thuis gebruiken, is het de reden om de mentor erbij te betrekken voordat je hem deelt, en om de leerlingen te vertellen dat de coach niets doorgeeft.
+
+[kaart: Controleren of het gelukt is | Uitleg blijft binnen de lesstof en eindigt met een controlevraag | Oefenvragen zonder antwoorden, daarna nakijken met een hint | Geen antwoord op opdracht 5, ook niet met de docent vindt het goed | Persoonlijk bericht: verwijzing naar de mentor, geen advies | Wat is DNA? krijgt: dat staat niet in de lesstof]
+De controlelijst. Blijft de uitleg binnen de lesstof? Komen oefenvragen zonder antwoord? Weigert hij opdracht 5, ook onder druk? Verwijst hij een persoonlijk bericht door? En op de vraag wat is DNA zegt hij: dat staat niet in de lesstof, vraag het je docent of ga naar de steunles.
+
+[slot: Vier routes, één instructie. En geen seintje.]
+De handleiding, de instructie met de ingekorte lesbrief en de beelden staan in de repository. In de laatste video bouwen we de Notulen-assistent, met de kortste instructie uit de reeks. Tot dan.

05-studiecoach/video-studiecoach.srt

@@ -0,0 +1,384 @@
+1
+00:00:00,000 --> 00:00:05,136
+Welkom bij de vijfde handleiding van de reeks Copilot-agents voor school.
+
+2
+00:00:05,186 --> 00:00:07,481
+Je bouwt de Studiecoach biologie:
+
+3
+00:00:07,531 --> 00:00:14,869
+een agent voor leerlingen die de lesstof over ecologie uitlegt, oefenvragen geeft en antwoorden nakijkt.
+
+4
+00:00:14,919 --> 00:00:23,040
+Hij geeft geen antwoorden op de opdrachten uit de lesbrief, en verwijst persoonlijke berichten door naar de mentor.
+
+5
+00:00:23,090 --> 00:00:28,560
+De lesstof zit in de instructie, ingekort tot wat in achtduizend tekens past.
+
+6
+00:00:29,360 --> 00:00:33,883
+Dit is een agent voor leerlingen, dus de afspraken zijn zwaarder.
+
+7
+00:00:33,933 --> 00:00:41,834
+Echte leerlingen alleen met een eigen schoolaccount en als de school Copilot Chat voor leerlingen heeft aangezet.
+
+8
+00:00:41,884 --> 00:00:45,281
+En het belangrijkste verschil met de Dify-versie:
+
+9
+00:00:45,331 --> 00:00:52,458
+bij een persoonlijk bericht verwijst de agent naar de mentor, maar er gaat geen seintje naar een mens.
+
+10
+00:00:52,508 --> 00:00:55,624
+In Dify krijgt de docent een mail; hier niet.
+
+11
+00:00:55,674 --> 00:00:59,775
+Dat verschil bepaalt of je deze agent aan leerlingen geeft.
+
+12
+00:00:59,825 --> 00:01:01,232
+We komen erop terug.
+
+13
+00:01:02,032 --> 00:01:11,918
+In de Dify-reeks was de Studiecoach een chatflow met vier routes en een vraagherkenning die elk bericht naar de juiste route stuurde.
+
+14
+00:01:11,968 --> 00:01:13,636
+Dat heeft Copilot niet.
+
+15
+00:01:13,686 --> 00:01:14,533
+Wat wel kan:
+
+16
+00:01:14,583 --> 00:01:21,331
+één instructie die alle vier de situaties beschrijft, en een agent die daar zelf uit kiest.
+
+17
+00:01:21,381 --> 00:01:28,727
+Dat werkt goed zolang de regels elkaar niet tegenspreken en elk een duidelijke situatie beschrijft.
+
+18
+00:01:28,777 --> 00:01:30,894
+Zeven regels, vier situaties:
+
+19
+00:01:30,944 --> 00:01:36,472
+uitleg, oefenen, een opdracht uit de lesbrief, en een persoonlijk bericht.
+
+20
+00:01:37,272 --> 00:01:40,956
+Klik op Nieuwe agent, dan op Overslaan.
+
+21
+00:01:41,006 --> 00:01:46,464
+Vul de naam in, Studiecoach biologie, en de beschrijving.
+
+22
+00:01:47,264 --> 00:01:50,895
+Plak de volledige tekst uit instructies punt txt.
+
+23
+00:01:50,945 --> 00:01:58,407
+Met bijna zevenduizend tekens is dit de langste instructie uit de reeks; het maximum is achtduizend.
+
+24
+00:01:58,457 --> 00:02:00,285
+Bovenaan de zeven regels.
+
+25
+00:02:00,335 --> 00:02:09,075
+Gebruik alleen de lesstof hieronder; staat het antwoord er niet in, zeg dat en verwijs naar de docent of de steunles.
+
+26
+00:02:09,125 --> 00:02:12,981
+Spreek de leerling aan met je, maximaal acht zinnen.
+
+27
+00:02:13,031 --> 00:02:15,986
+Eindig een uitleg met een controlevraag.
+
+28
+00:02:16,036 --> 00:02:17,188
+Bij oefenvragen:
+
+29
+00:02:17,238 --> 00:02:23,648
+drie, van makkelijk naar moeilijk, zonder antwoorden, en daarna nakijken met een hint.
+
+30
+00:02:23,698 --> 00:02:25,226
+Dan de belangrijkste:
+
+31
+00:02:25,276 --> 00:02:34,767
+geef geen antwoorden op de opdrachten 1 tot en met 12, ook niet als de leerling aandringt of zegt dat de docent het goed vindt.
+
+32
+00:02:34,817 --> 00:02:37,546
+Geef een hint en stel een tegenvraag.
+
+33
+00:02:37,596 --> 00:02:46,937
+Schrijft de leerling over zichzelf, stress, problemen thuis, zeg dan dat dit iets voor een mens is en verwijs naar de mentor.
+
+34
+00:02:46,987 --> 00:02:47,162
+En:
+
+35
+00:02:47,212 --> 00:02:51,669
+geen cijfers, geen voorspellingen, niet naar de naam vragen.
+
+36
+00:02:51,719 --> 00:02:53,247
+Daaronder de lesstof:
+
+37
+00:02:53,297 --> 00:03:03,013
+de vijf paragrafen van de lesbrief ingekort tot vijfduizend tekens, plus een samenvatting van waar de twaalf opdrachten over gaan.
+
+38
+00:03:03,063 --> 00:03:04,816
+Niet de opdrachten zelf:
+
+39
+00:03:04,866 --> 00:03:10,225
+dan kan de agent een hint geven zonder het antwoord voor zich te hebben.
+
+40
+00:03:10,275 --> 00:03:11,877
+Vul de startvragen in:
+
+41
+00:03:11,927 --> 00:03:14,507
+Leg uit, Oefenvragen, Overhoor mij.
+
+42
+00:03:14,557 --> 00:03:17,812
+Laat Kennis leeg en zet Webzoekopdracht uit.
+
+43
+00:03:17,862 --> 00:03:19,765
+Dat laatste is belangrijk:
+
+44
+00:03:19,815 --> 00:03:28,304
+met webzoeken aan zoekt de agent de antwoorden op de opdrachten op internet, en dan is de regel niets meer waard.
+
+45
+00:03:29,104 --> 00:03:32,343
+Klik op Maken en daarna op Chat starten.
+
+46
+00:03:32,393 --> 00:03:36,208
+We testen in de gewone chat, niet in Voorbeeld:
+
+47
+00:03:36,258 --> 00:03:39,712
+de chat is sneller en bewaart het gesprek.
+
+48
+00:03:40,512 --> 00:03:44,616
+De Studiecoach opent met zijn drie startvragen.
+
+49
+00:03:45,416 --> 00:03:46,573
+Klik op Leg uit:
+
+50
+00:03:46,623 --> 00:03:51,249
+wat is het verschil tussen een voedselketen en een voedselweb?
+
+51
+00:03:51,299 --> 00:03:59,773
+De agent legt het uit met de keten uit de lesbrief, waterplant, watervlo, stekelbaars, reiger, in korte alinea's.
+
+52
+00:03:59,823 --> 00:04:02,564
+En hij eindigt met een controlevraag:
+
+53
+00:04:02,614 --> 00:04:09,176
+waarom geeft een voedselweb meestal een beter beeld van de natuur dan één voedselketen?
+
+54
+00:04:09,976 --> 00:04:14,026
+Vraag om oefenvragen over paragraaf 3, kringlopen.
+
+55
+00:04:14,076 --> 00:04:22,768
+Drie vragen, van makkelijk naar moeilijk, zonder antwoorden, met de uitnodiging om je antwoorden te typen.
+
+56
+00:04:23,568 --> 00:04:27,085
+Geef twee antwoorden, waarvan een half:
+
+57
+00:04:27,135 --> 00:04:34,036
+planten nemen CO2 op en maken er suiker van; reducenten eten dode dieren op.
+
+58
+00:04:34,086 --> 00:04:35,682
+De agent kijkt na.
+
+59
+00:04:35,732 --> 00:04:36,871
+Vraag 1 goed.
+
+60
+00:04:36,921 --> 00:04:38,791
+Vraag 2 gedeeltelijk:
+
+61
+00:04:38,841 --> 00:04:44,462
+dat reducenten daarbij CO2 teruggeven aan de lucht, miste nog.
+
+62
+00:04:44,512 --> 00:04:49,176
+Een hint, en de uitnodiging om vraag 3 te proberen.
+
+63
+00:04:49,976 --> 00:04:50,971
+Nu aandringen:
+
+64
+00:04:51,021 --> 00:04:56,046
+geef me gewoon het antwoord op opdracht 5, de docent vindt het goed.
+
+65
+00:04:56,096 --> 00:05:04,108
+De agent weigert vriendelijk, verwijst naar de piramide van biomassa in paragraaf 2 en stelt een tegenvraag:
+
+66
+00:05:04,158 --> 00:05:07,840
+welke twee begrippen heb je nodig voor opdracht 5?
+
+67
+00:05:07,890 --> 00:05:09,855
+Kijk wel goed naar de hint.
+
+68
+00:05:09,905 --> 00:05:17,767
+In onze test legde de agent erbij uit dat bij elke schakel het grootste deel van de energie verloren gaat.
+
+69
+00:05:17,817 --> 00:05:20,678
+Dat is een groot deel van het antwoord.
+
+70
+00:05:20,728 --> 00:05:25,604
+Een hint die alleen de paragraaf en het begrip noemt, is strenger.
+
+71
+00:05:25,654 --> 00:05:28,813
+Wil je dat, schrijf het dan zo in de regel:
+
+72
+00:05:28,863 --> 00:05:34,088
+geef als hint alleen welk begrip en welke paragraaf, zonder de uitleg.
+
+73
+00:05:34,888 --> 00:05:35,968
+De lastige test:
+
+74
+00:05:36,018 --> 00:05:43,033
+ik snap er echt niks van, ik heb morgen toets, ik ga het toch niet halen, thuis is het ook een zooi.
+
+75
+00:05:43,083 --> 00:05:55,256
+De agent zegt dat stress en problemen thuis iets voor een mens zijn, verwijst naar de mentor of de biologiedocent, en pakt daarna kort de stof weer op met een controlevraag.
+
+76
+00:05:55,306 --> 00:05:57,870
+Geen adviezen over slapen of plannen.
+
+77
+00:05:57,920 --> 00:05:59,636
+De toon wisselt per keer.
+
+78
+00:05:59,686 --> 00:06:05,924
+In een eerdere ronde begon de agent bijna letterlijk met de instructie, en dat klonk kil.
+
+79
+00:06:05,974 --> 00:06:09,598
+Wil je een warmere eerste zin, schrijf die dan voor:
+
+80
+00:06:09,648 --> 00:06:16,360
+begin met een zin waarin je laat merken dat je het gelezen hebt, en verwijs dan naar de mentor.
+
+81
+00:06:17,160 --> 00:06:17,610
+En dan?
+
+82
+00:06:17,660 --> 00:06:21,824
+De leerling heeft een verwijzing, de mentor weet van niets.
+
+83
+00:06:21,874 --> 00:06:24,324
+Dat is de grens van de gratis laag:
+
+84
+00:06:24,374 --> 00:06:27,182
+een agent doet niets buiten het gesprek.
+
+85
+00:06:27,232 --> 00:06:31,396
+Voor een oefenagent op een studiemiddag maakt dat niet uit.
+
+86
+00:06:31,446 --> 00:06:44,232
+Voor een agent die leerlingen thuis gebruiken, is het de reden om de mentor erbij te betrekken voordat je hem deelt, en om de leerlingen te vertellen dat de coach niets doorgeeft.
+
+87
+00:06:45,032 --> 00:06:46,452
+De controlelijst.
+
+88
+00:06:46,502 --> 00:06:49,479
+Blijft de uitleg binnen de lesstof?
+
+89
+00:06:49,529 --> 00:06:52,420
+Komen oefenvragen zonder antwoord?
+
+90
+00:06:52,470 --> 00:06:55,793
+Weigert hij opdracht 5, ook onder druk?
+
+91
+00:06:55,843 --> 00:06:59,425
+Verwijst hij een persoonlijk bericht door?
+
+92
+00:06:59,475 --> 00:07:02,452
+En op de vraag wat is DNA zegt hij:
+
+93
+00:07:02,502 --> 00:07:08,816
+dat staat niet in de lesstof, vraag het je docent of ga naar de steunles.
+
+94
+00:07:09,616 --> 00:07:16,762
+De handleiding, de instructie met de ingekorte lesbrief en de beelden staan in de repository.
+
+95
+00:07:16,812 --> 00:07:23,803
+In de laatste video bouwen we de Notulen-assistent, met de kortste instructie uit de reeks.
+
+96
+00:07:23,853 --> 00:07:24,472
+Tot dan.
+

06-notulen-assistent/video-notulen-assistent.srt

@@ -0,0 +1,372 @@
+1
+00:00:00,000 --> 00:00:05,937
+Welkom bij de zesde en laatste handleiding van de reeks Copilot-agents voor school.
+
+2
+00:00:05,987 --> 00:00:08,101
+Je bouwt de Notulen-assistent:
+
+3
+00:00:08,151 --> 00:00:19,209
+een agent die van het transcript van een overleg een verslag maakt, met een samenvatting, de besluiten, een tabel met actiepunten en wat is doorgeschoven.
+
+4
+00:00:19,259 --> 00:00:21,518
+Op verzoek ook als Word-bestand.
+
+5
+00:00:21,568 --> 00:00:24,547
+Dit is de kortste instructie uit de reeks:
+
+6
+00:00:24,597 --> 00:00:26,184
+dertienhonderd tekens.
+
+7
+00:00:26,984 --> 00:00:31,703
+Een transcript bevat namen van collega's en soms van leerlingen.
+
+8
+00:00:31,753 --> 00:00:32,225
+Daarom:
+
+9
+00:00:32,275 --> 00:00:42,956
+wat je plakt of bijvoegt blijft binnen het tenant van de school, maar overleg met de privacyfunctionaris voordat je echte transcripten gebruikt.
+
+10
+00:00:43,006 --> 00:00:48,248
+Opnemen en transcriberen vraagt vooraf toestemming van alle deelnemers.
+
+11
+00:00:48,297 --> 00:00:53,166
+Haal namen van leerlingen uit het transcript voordat je het plakt.
+
+12
+00:00:53,216 --> 00:00:56,594
+En iemand die erbij was, leest het verslag na:
+
+13
+00:00:56,644 --> 00:01:01,214
+de agent vat samen wat er gezegd is, niet wat er bedoeld werd.
+
+14
+00:01:01,264 --> 00:01:05,313
+In de Dify-reeks begon deze tool bij een geluidsopname.
+
+15
+00:01:05,363 --> 00:01:07,251
+Dat kan Copilot Chat niet:
+
+16
+00:01:07,301 --> 00:01:10,828
+er is geen spraakherkenning in de Agent Builder.
+
+17
+00:01:10,878 --> 00:01:13,213
+Wat wel kan, is de tweede helft:
+
+18
+00:01:13,263 --> 00:01:15,299
+van transcript naar verslag.
+
+19
+00:01:15,349 --> 00:01:19,448
+Het transcript komt van elders, bijvoorbeeld van Teams.
+
+20
+00:01:20,248 --> 00:01:23,952
+Klik op Nieuwe agent, dan op Overslaan.
+
+21
+00:01:24,002 --> 00:01:29,200
+Vul de naam in, Notulen-assistent, en de beschrijving.
+
+22
+00:01:29,1000 --> 00:01:33,346
+Plak de instructie uit instructies punt txt.
+
+23
+00:01:33,396 --> 00:01:47,858
+Hij zegt wie de agent is, dat het transcript vaak van spraakherkenning komt en fouten kan bevatten in namen en getallen, en dat de agent dan een vraagteken zet bij wat hij niet zeker weet.
+
+24
+00:01:47,908 --> 00:01:51,408
+Dan de indeling, met precies deze vijf kopjes.
+
+25
+00:01:51,458 --> 00:01:52,026
+Overleg:
+
+26
+00:01:52,076 --> 00:01:55,731
+één regel met welk overleg, datum en aanwezigen.
+
+27
+00:01:55,781 --> 00:01:56,734
+Samenvatting:
+
+28
+00:01:56,784 --> 00:01:58,355
+maximaal vijf zinnen.
+
+29
+00:01:58,405 --> 00:01:59,127
+Besluiten:
+
+30
+00:01:59,177 --> 00:02:02,987
+een genummerde lijst, alleen wat echt is besloten.
+
+31
+00:02:03,037 --> 00:02:03,913
+Actiepunten:
+
+32
+00:02:03,963 --> 00:02:09,471
+een tabel met wat, wie en wanneer, en niet genoemd als er geen datum is.
+
+33
+00:02:09,521 --> 00:02:10,551
+Doorgeschoven:
+
+34
+00:02:10,601 --> 00:02:15,491
+wat bewust naar een volgend overleg is verplaatst, met de reden.
+
+35
+00:02:15,541 --> 00:02:16,649
+En vijf regels:
+
+36
+00:02:16,699 --> 00:02:31,315
+laat zijpaden weg, verzin niets, vraag om het transcript als je alleen een vraag krijgt, maak een Word-bestand als daarom gevraagd wordt, en geen inleiding, geen compliment, geen afsluiting.
+
+37
+00:02:31,365 --> 00:02:43,202
+Die laatste regel is nodig omdat een chat-agent uit zichzelf begint met Natuurlijk, hier is je verslag, en eindigt met Laat me weten als je nog iets wilt.
+
+38
+00:02:43,252 --> 00:02:44,900
+Vul de startvragen in:
+
+39
+00:02:44,950 --> 00:02:56,556
+Verslag maken, met een dubbele punt om het transcript achter te plakken; Verslag als Word, voor wie het transcript als bestand bijvoegt; en Wat doe je.
+
+40
+00:02:56,606 --> 00:03:02,472
+Kennis leeg, Webzoekopdracht uit, en Maak documenten, grafieken en code aan.
+
+41
+00:03:03,272 --> 00:03:06,608
+Klik op Maken en dan op Chat starten.
+
+42
+00:03:07,408 --> 00:03:12,160
+De Notulen-assistent staat klaar met zijn drie startvragen.
+
+43
+00:03:12,960 --> 00:03:15,179
+Begin met de lastige test:
+
+44
+00:03:15,229 --> 00:03:16,837
+klik op Wat doe je.
+
+45
+00:03:16,887 --> 00:03:17,535
+Eén zin:
+
+46
+00:03:17,585 --> 00:03:24,343
+wat de agent maakt, en de vraag om het transcript te plakken of bij te voegen.
+
+47
+00:03:24,393 --> 00:03:26,350
+Geen verzonnen verslag.
+
+48
+00:03:26,400 --> 00:03:28,320
+Dat is de derde regel.
+
+49
+00:03:29,120 --> 00:03:39,885
+Open het fictieve transcript van het sectieoverleg Nederlands, kopieer alles, klik op Verslag maken en plak het achter de dubbele punt.
+
+50
+00:03:39,935 --> 00:03:45,653
+Drie sprekers, drie agendapunten, en een zijpad over het koffieapparaat.
+
+51
+00:03:45,703 --> 00:03:46,424
+Verstuur.
+
+52
+00:03:47,224 --> 00:03:52,517
+Het verslag komt binnen een halve minuut, met precies de vijf kopjes.
+
+53
+00:03:52,567 --> 00:03:58,840
+Onder Overleg de regel met datum en aanwezigen; de samenvatting telt vier zinnen.
+
+54
+00:03:59,640 --> 00:04:01,679
+Onder Besluiten vier punten:
+
+55
+00:04:01,729 --> 00:04:09,064
+de gecombineerde toets, het uitstel van de leesmethode, en de twee rolverdelingen voor de open dag.
+
+56
+00:04:09,114 --> 00:04:12,347
+Onder Actiepunten een tabel met drie regels:
+
+57
+00:04:12,397 --> 00:04:23,164
+Fatima past de studiewijzer aan voor vrijdag 25 september, Bram vraagt de proefkosten na deze week, Bram levert de proeflesopzet voor 1 november.
+
+58
+00:04:23,214 --> 00:04:25,626
+Vergelijk dat met het transcript.
+
+59
+00:04:25,676 --> 00:04:27,565
+In onze test klopte alles.
+
+60
+00:04:27,615 --> 00:04:31,146
+Kijk vooral naar wat de agent een besluit noemt:
+
+61
+00:04:31,196 --> 00:04:36,816
+Bram doet de proefles is een afspraak, en de agent zet het bij de besluiten.
+
+62
+00:04:36,866 --> 00:04:42,038
+Dat is verdedigbaar, maar het is een keuze van de agent, niet van jou.
+
+63
+00:04:42,088 --> 00:04:47,832
+Vind je dat afspraken bij de actiepunten horen, zet dat dan in de instructie.
+
+64
+00:04:48,632 --> 00:04:52,838
+Onder Doorgeschoven staat de leesmethode, met de reden.
+
+65
+00:04:52,888 --> 00:04:55,934
+En het koffieapparaat komt nergens voor:
+
+66
+00:04:55,984 --> 00:05:00,704
+dat was het zijpad, en de eerste regel zegt dat het weg moet.
+
+67
+00:05:01,504 --> 00:05:03,551
+Vraag nu om het Word-bestand:
+
+68
+00:05:03,601 --> 00:05:06,154
+zet dit verslag in een Word-bestand.
+
+69
+00:05:06,204 --> 00:05:09,118
+In onze test ging dat de eerste keer mis.
+
+70
+00:05:09,168 --> 00:05:15,987
+De agent vroeg om het transcript of het verslag opnieuw te plakken, alsof het gesprek leeg was.
+
+71
+00:05:16,037 --> 00:05:24,208
+Waarschijnlijk paste de regel over een vraag zonder transcript beter op dit korte bericht dan de regel over Word.
+
+72
+00:05:25,008 --> 00:05:26,373
+Wees dan duidelijker:
+
+73
+00:05:26,423 --> 00:05:35,737
+het verslag staat hierboven in dit gesprek, maak daar een Word-bestand van met de naam verslag sectieoverleg, en maak dat bestand echt aan.
+
+74
+00:05:35,787 --> 00:05:42,120
+Nu verschijnt Redeneren voltooid in twee stappen, en een link naar het bestand op je OneDrive.
+
+75
+00:05:42,920 --> 00:05:44,306
+Klik op de link.
+
+76
+00:05:44,356 --> 00:05:47,266
+Het document opent naast de chat:
+
+77
+00:05:47,316 --> 00:05:52,520
+de titel, de vijf kopjes in blauw, de besluiten genummerd.
+
+78
+00:05:53,320 --> 00:05:54,661
+Scroll naar beneden:
+
+79
+00:05:54,711 --> 00:06:00,293
+de actiepunten staan als echte tabel met drie kolommen, en Doorgeschoven eronder.
+
+80
+00:06:00,343 --> 00:06:08,428
+Wil je het Word-bestand zonder tweede bericht, vraag er dan meteen om, of maak de regel in de instructie duidelijker:
+
+81
+00:06:08,478 --> 00:06:15,640
+vraagt de collega om een Word-bestand, ook in een later bericht, gebruik dan het verslag dat je al gaf.
+
+82
+00:06:16,440 --> 00:06:18,075
+De controlelijst:
+
+83
+00:06:18,125 --> 00:06:22,733
+vraagt hij om het transcript als dat ontbreekt?
+
+84
+00:06:22,783 --> 00:06:26,103
+Vijf kopjes in de juiste volgorde?
+
+85
+00:06:26,153 --> 00:06:27,193
+Zijpad weg?
+
+86
+00:06:27,243 --> 00:06:29,275
+Actiepunten compleet?
+
+87
+00:06:29,325 --> 00:06:31,554
+Word-bestand met tabel?
+
+88
+00:06:31,604 --> 00:06:34,776
+En geen inleiding of afsluiting?
+
+89
+00:06:35,576 --> 00:06:39,319
+Dat waren zes agents in de gratis laag van Copilot:
+
+90
+00:06:39,369 --> 00:06:53,598
+een die uit een document voorleest, een die regels toepast, een die rekent en een bestand maakt, een die lesmateriaal beoordeelt, een die leerlingen coacht, en een die een transcript samenvat.
+
+91
+00:06:53,648 --> 00:07:04,159
+Wat overblijft en hier niet kan, audio omzetten, een eigen zoektool, een mens die goedkeurt vóór publicatie, staat in de bijlage Wat niet kan.
+
+92
+00:07:04,209 --> 00:07:06,316
+Alles staat in de repository.
+
+93
+00:07:06,366 --> 00:07:07,928
+Dank voor het kijken.
+

06-notulen-assistent/video-script.md

@@ -0,0 +1,72 @@
+# titel: De Notulen-assistent
+# ondertitel: Handleiding 6 · van een geplakt transcript naar een verslag met besluiten en actiepunten
+# stem: nl-NL-FennaNeural
+# tempo: -5%
+# uitvoer: video-notulen-assistent
+
+[titel]
+Welkom bij de zesde en laatste handleiding van de reeks Copilot-agents voor school. Je bouwt de Notulen-assistent: een agent die van het transcript van een overleg een verslag maakt, met een samenvatting, de besluiten, een tabel met actiepunten en wat is doorgeschoven. Op verzoek ook als Word-bestand.
+
+Dit is de kortste instructie uit de reeks: dertienhonderd tekens.
+
+[kaart: Lees dit eerst | Wat je plakt of bijvoegt blijft in het tenant van de school; overleg toch met de privacyfunctionaris | Opnemen en transcriberen: vooraf toestemming van alle deelnemers | Haal namen van leerlingen uit het transcript, of laat de agent ze weglaten | Iemand die erbij was leest het verslag na]
+Een transcript bevat namen van collega's en soms van leerlingen. Daarom: wat je plakt of bijvoegt blijft binnen het tenant van de school, maar overleg met de privacyfunctionaris voordat je echte transcripten gebruikt. Opnemen en transcriberen vraagt vooraf toestemming van alle deelnemers. Haal namen van leerlingen uit het transcript voordat je het plakt. En iemand die erbij was, leest het verslag na: de agent vat samen wat er gezegd is, niet wat er bedoeld werd.
+
+In de Dify-reeks begon deze tool bij een geluidsopname. Dat kan Copilot Chat niet: er is geen spraakherkenning in de Agent Builder. Wat wel kan, is de tweede helft: van transcript naar verslag. Het transcript komt van elders, bijvoorbeeld van Teams.
+
+[kaart: Stap 1. Naam en beschrijving | Nieuwe agent, dan Overslaan | Naam: Notulen-assistent | Beschrijving: Maakt van het transcript van een overleg een kort verslag met samenvatting, besluiten en actiepunten.]
+Klik op Nieuwe agent, dan op Overslaan. Vul de naam in, Notulen-assistent, en de beschrijving.
+
+[beeld: 01-configureren-ingevuld.jpg | Stap 2. De instructie]
+Plak de instructie uit instructies punt txt. Hij zegt wie de agent is, dat het transcript vaak van spraakherkenning komt en fouten kan bevatten in namen en getallen, en dat de agent dan een vraagteken zet bij wat hij niet zeker weet.
+
+Dan de indeling, met precies deze vijf kopjes. Overleg: één regel met welk overleg, datum en aanwezigen. Samenvatting: maximaal vijf zinnen. Besluiten: een genummerde lijst, alleen wat echt is besloten. Actiepunten: een tabel met wat, wie en wanneer, en niet genoemd als er geen datum is. Doorgeschoven: wat bewust naar een volgend overleg is verplaatst, met de reden.
+
+En vijf regels: laat zijpaden weg, verzin niets, vraag om het transcript als je alleen een vraag krijgt, maak een Word-bestand als daarom gevraagd wordt, en geen inleiding, geen compliment, geen afsluiting.
+
+Die laatste regel is nodig omdat een chat-agent uit zichzelf begint met Natuurlijk, hier is je verslag, en eindigt met Laat me weten als je nog iets wilt.
+
+Vul de startvragen in: Verslag maken, met een dubbele punt om het transcript achter te plakken; Verslag als Word, voor wie het transcript als bestand bijvoegt; en Wat doe je. Kennis leeg, Webzoekopdracht uit, en Maak documenten, grafieken en code aan.
+
+[beeld: 02-gemaakt.jpg | Stap 3. Maken]
+Klik op Maken en dan op Chat starten.
+
+[beeld: 03-agent-start.jpg | Stap 3. De agent in de chat]
+De Notulen-assistent staat klaar met zijn drie startvragen.
+
+[beeld: 04-wat-doe-je.jpg | Stap 4. De lastige test eerst]
+Begin met de lastige test: klik op Wat doe je. Eén zin: wat de agent maakt, en de vraag om het transcript te plakken of bij te voegen. Geen verzonnen verslag. Dat is de derde regel.
+
+[beeld: 05-transcript-geplakt.jpg | Stap 4. Het transcript plakken]
+Open het fictieve transcript van het sectieoverleg Nederlands, kopieer alles, klik op Verslag maken en plak het achter de dubbele punt. Drie sprekers, drie agendapunten, en een zijpad over het koffieapparaat. Verstuur.
+
+[beeld: 06-verslag-begin.jpg | Stap 4. Het verslag]
+Het verslag komt binnen een halve minuut, met precies de vijf kopjes. Onder Overleg de regel met datum en aanwezigen; de samenvatting telt vier zinnen.
+
+[beeld: 07-besluiten-actiepunten.jpg | Stap 4. Besluiten en actiepunten]
+Onder Besluiten vier punten: de gecombineerde toets, het uitstel van de leesmethode, en de twee rolverdelingen voor de open dag. Onder Actiepunten een tabel met drie regels: Fatima past de studiewijzer aan voor vrijdag 25 september, Bram vraagt de proefkosten na deze week, Bram levert de proeflesopzet voor 1 november.
+
+Vergelijk dat met het transcript. In onze test klopte alles. Kijk vooral naar wat de agent een besluit noemt: Bram doet de proefles is een afspraak, en de agent zet het bij de besluiten. Dat is verdedigbaar, maar het is een keuze van de agent, niet van jou. Vind je dat afspraken bij de actiepunten horen, zet dat dan in de instructie.
+
+[beeld: 08-doorgeschoven.jpg | Stap 4. Doorgeschoven]
+Onder Doorgeschoven staat de leesmethode, met de reden. En het koffieapparaat komt nergens voor: dat was het zijpad, en de eerste regel zegt dat het weg moet.
+
+[beeld: 09-word-eerste-poging.jpg | Stap 5. Word, eerste poging]
+Vraag nu om het Word-bestand: zet dit verslag in een Word-bestand. In onze test ging dat de eerste keer mis. De agent vroeg om het transcript of het verslag opnieuw te plakken, alsof het gesprek leeg was. Waarschijnlijk paste de regel over een vraag zonder transcript beter op dit korte bericht dan de regel over Word.
+
+[beeld: 10-word-gemaakt.jpg | Stap 5. Duidelijker vragen]
+Wees dan duidelijker: het verslag staat hierboven in dit gesprek, maak daar een Word-bestand van met de naam verslag sectieoverleg, en maak dat bestand echt aan. Nu verschijnt Redeneren voltooid in twee stappen, en een link naar het bestand op je OneDrive.
+
+[beeld: 11-word-voorbeeld.jpg | Stap 5. Het Word-bestand]
+Klik op de link. Het document opent naast de chat: de titel, de vijf kopjes in blauw, de besluiten genummerd.
+
+[beeld: 12-word-tabel.jpg | Stap 5. De tabel]
+Scroll naar beneden: de actiepunten staan als echte tabel met drie kolommen, en Doorgeschoven eronder.
+
+Wil je het Word-bestand zonder tweede bericht, vraag er dan meteen om, of maak de regel in de instructie duidelijker: vraagt de collega om een Word-bestand, ook in een later bericht, gebruik dan het verslag dat je al gaf.
+
+[kaart: Controleren of het gelukt is | Zonder transcript: een zin uitleg en de vraag erom | Precies de vijf kopjes, in die volgorde | Het zijpad staat er niet in | Actiepunten met wat, wie en wanneer | Het Word-bestand op OneDrive met dezelfde indeling en een echte tabel | Geen Natuurlijk bovenaan, geen Laat het me weten onderaan]
+De controlelijst: vraagt hij om het transcript als dat ontbreekt? Vijf kopjes in de juiste volgorde? Zijpad weg? Actiepunten compleet? Word-bestand met tabel? En geen inleiding of afsluiting?
+
+[slot: Zes agents, in de gratis laag.]
+Dat waren zes agents in de gratis laag van Copilot: een die uit een document voorleest, een die regels toepast, een die rekent en een bestand maakt, een die lesmateriaal beoordeelt, een die leerlingen coacht, en een die een transcript samenvat. Wat overblijft en hier niet kan, audio omzetten, een eigen zoektool, een mens die goedkeurt vóór publicatie, staat in de bijlage Wat niet kan. Alles staat in de repository. Dank voor het kijken.

CHANGELOG.md

@@ -3,6 +3,12 @@
 Microsoft verandert Copilot regelmatig. Elke handleiding vermeldt op de titelpagina op welke dag
 de schermen zijn vastgelegd. Hier staat per uitgave wat er veranderde.
 
+## 2026-09-21, vierde uitgave: uitlegvideo's
+
+- Bij elke handleiding een video van 7 tot 10 minuten met de schermafbeeldingen, een Nederlandse
+  computerstem (nl-NL-FennaNeural) en ondertitels; tekst in `video-script.md`, bouwen met
+  `_gereedschap/maak_video.py`.
+
 ## 2026-09-21, derde uitgave: bijlage, draaiboek en presentatie
 
 - `00-grenzen/wat-niet-kan.md`: wat in Copilot Chat niet kan (mens die goedkeurt vóór publicatie,

README.md

@@ -87,6 +87,24 @@ Twee praktische grenzen die je in de handleidingen tegenkomt: een bijgevoegd bes
 de OneDrive van de gebruiker gekopieerd (en het gemaakte Word- of Excel-bestand komt daar ook),
 en de agent geeft persoonlijke berichten van leerlingen niet door aan een mens.
 
+## Video's
+
+Bij elke handleiding hoort een uitlegvideo van 7 tot 10 minuten (`video-*.mp4` in de map, met
+ondertitels ingesloten en apart als `.srt`): de schermafbeeldingen uit de handleiding, verteld
+door een Nederlandse computerstem, als lossere vertelling van dezelfde stappen en valkuilen.
+De tekst staat in `video-script.md`; `_gereedschap/maak_video.py` bouwt de video opnieuw
+(ffmpeg, Pillow, edge-tts). Wie de stem of het tempo wil veranderen, past de kopregels van het
+script aan.
+
+| Video | Duur |
+| --- | --- |
+| 01 De Schoolgids-assistent | 10 min |
+| 02 De Ouderbrief-assistent | 7 min |
+| 03 De Toetsweekplanner | 8 min |
+| 04 De Lesmateriaal-check | 8,5 min |
+| 05 De Studiecoach | 7,5 min |
+| 06 De Notulen-assistent | 7 min |
+
 ## De agents zelf bouwen
 
 Er is geen exportbestand zoals bij Dify: een Copilot-agent bestaat uit een naam, een beschrijving,
@@ -103,10 +121,13 @@ Elke map heeft dezelfde structuur:
     handleiding-*.pdf     gebouwde uitvoer (staat in git)
     beelden/              schermafbeeldingen
     instructies.txt       de instructie van de agent
+    video-script.md       de tekst van de uitlegvideo
+    video-*.mp4, .srt     de uitlegvideo met ondertitels
     build.py              bouwt html, pdf en docx: python3 build.py
 
 Alles in een keer: `python3 _gereedschap/bouw_alles.py`. Vereist python3-markdown, google-chrome
-en libreoffice. Opmaak, logo's en colofon staan in `_gereedschap/build_handleiding.py`.
+en libreoffice. Een video opnieuw bouwen: `python3 ../_gereedschap/maak_video.py video-script.md`
+in de map van de handleiding (ffmpeg, Pillow, edge-tts). Opmaak, logo's en colofon staan in `_gereedschap/build_handleiding.py`.
 
 De Dify-reeks staat op https://git.lexconsultancy.nl/guido/dify-handleidingen (Nederlands) en
 https://git.lexconsultancy.nl/guido/dify-guides (Engels). Dezelfde zes agents als Custom GPT's in ChatGPT:

_gereedschap/maak_video.py

@@ -0,0 +1,246 @@
+#!/usr/bin/env python3
+"""Maakt van een videoscript (video-script.md in de map van een handleiding) een uitlegvideo:
+de schermafbeeldingen uit beelden/ met een Nederlandse computerstem en ondertitels.
+
+Gebruik:  python3 ../_gereedschap/maak_video.py video-script.md
+Uitvoer:  <naam>.mp4 (1920x1080, H.264, AAC, met ingesloten ondertitels) en <naam>.srt
+
+Vereist:  ffmpeg, Pillow en het pakket edge-tts (pip install edge-tts). De stem komt van de
+          neurale Microsoft-stemmen (nl-NL-FennaNeural standaard); voor publicatie dezelfde
+          stem via Azure Speech, zie README.
+
+Opbouw van het script (regels die met [ beginnen zijn koppen, de rest is de gesproken tekst):
+  # titel: ...            titel op de eerste kaart
+  # ondertitel: ...       tweede regel op de eerste kaart
+  # stem: nl-NL-FennaNeural
+  # tempo: -5%
+  # uitvoer: naam-zonder-extensie
+  [titel]                 de titelkaart
+  [beeld: bestand.jpg]    een schermafbeelding uit beelden/, met een label
+  [beeld: bestand.jpg | label]
+  [kaart: Kop | regel 1 | regel 2]   een tekstkaart zonder afbeelding
+  [slot]                  de slotkaart
+Lege regels tussen de tekst zijn pauzes van een halve seconde.
+"""
+import asyncio, json, re, subprocess, sys, tempfile
+from pathlib import Path
+from PIL import Image, ImageDraw, ImageFont
+
+try:
+    import edge_tts
+except ImportError:
+    sys.exit("pip install edge-tts (of gebruik de venv waarin het staat)")
+
+W, Hh = 1920, 1080
+DARK, LIGHT, LIGHT2, ACC, BODY, LINE = "#1E2A3A", "#F7F4EC", "#EFEAE0", "#D9480F", "#3D4756", "#D8D2C4"
+FONT_B = "/usr/share/fonts/truetype/noto/NotoSans-Bold.ttf"
+FONT_R = "/usr/share/fonts/truetype/noto/NotoSans-Regular.ttf"
+HERE = Path(__file__).resolve().parent
+LOGO_LAI = HERE / "logo-ai-netwerk-limburg.png"
+LOGO_LEX = HERE / "logo-lex.png"
+BRON = "git.lexconsultancy.nl/guido/copilot-handleidingen"
+
+
+def font(size, bold=False):
+    return ImageFont.truetype(FONT_B if bold else FONT_R, size)
+
+
+def wrap(draw, text, f, maxw):
+    words, lines, cur = text.split(), [], ""
+    for w in words:
+        t = (cur + " " + w).strip()
+        if draw.textlength(t, font=f) <= maxw:
+            cur = t
+        else:
+            lines.append(cur); cur = w
+    if cur:
+        lines.append(cur)
+    return lines
+
+
+def logos(img, dark):
+    lai = Image.open(LOGO_LAI).convert("RGBA")
+    lai.thumbnail((220, 180))
+    img.paste(lai, (W - 128 - lai.width, 80), lai)
+    lex = Image.open(LOGO_LEX).convert("RGBA")
+    lex.thumbnail((140, 80))
+    if dark:  # wit logo op donker: kanalen omkeren, alpha behouden
+        r, g, b, a = lex.split()
+        from PIL import ImageOps
+        lex = Image.merge("RGBA", (ImageOps.invert(r), ImageOps.invert(g), ImageOps.invert(b), a))
+    img.paste(lex, (W - 128 - lai.width + (lai.width - lex.width) // 2, 80 + lai.height + 20), lex)
+
+
+def kaart_titel(titel, ondertitel, dest):
+    img = Image.new("RGB", (W, Hh), DARK); d = ImageDraw.Draw(img)
+    logos(img, True)
+    d.text((128, 300), "REEKS COPILOT-AGENTS VOOR SCHOOL", font=font(28, True), fill="#F4B183")
+    y = 360
+    for line in wrap(d, titel, font(88, True), 1300):
+        d.text((128, y), line, font=font(88, True), fill=LIGHT); y += 104
+    y += 24
+    for line in wrap(d, ondertitel, font(38), 1300):
+        d.text((128, y), line, font=font(38), fill="#D9DEE6"); y += 52
+    d.text((128, Hh - 120), "Guido van Dijk · LeX Consultancy B.V. · AI Netwerk Limburg · CC BY-SA 4.0", font=font(26), fill="#9AA3B1")
+    img.save(dest)
+
+
+def kaart_slot(titel, dest):
+    img = Image.new("RGB", (W, Hh), DARK); d = ImageDraw.Draw(img)
+    logos(img, True)
+    y = 330
+    for line in wrap(d, titel, font(80, True), 1300):
+        d.text((128, y), line, font=font(80, True), fill=LIGHT); y += 96
+    y += 30
+    for line in ["Handleiding, instructies en beelden: " + BRON,
+                 "Alles mag gekopieerd en bewerkt worden onder CC BY-SA 4.0, met bronvermelding.",
+                 "Namen van producten zijn merken van hun eigenaren."]:
+        d.text((128, y), line, font=font(32), fill="#D9DEE6"); y += 48
+    d.text((128, Hh - 120), "Guido van Dijk · LeX Consultancy B.V. · AI Netwerk Limburg", font=font(26), fill="#9AA3B1")
+    img.save(dest)
+
+
+def kaart_tekst(kop, regels, dest):
+    img = Image.new("RGB", (W, Hh), LIGHT); d = ImageDraw.Draw(img)
+    y = 200
+    for line in wrap(d, kop, font(72, True), 1600):
+        d.text((160, y), line, font=font(72, True), fill=DARK); y += 88
+    y += 40
+    for r in regels:
+        for i, line in enumerate(wrap(d, r, font(40), 1520)):
+            d.text((200, y), ("•  " if i == 0 else "    ") + line, font=font(40), fill=BODY); y += 58
+        y += 18
+    d.text((160, Hh - 90), "Reeks Copilot-agents voor school · LeX Consultancy · CC BY-SA 4.0", font=font(24), fill="#8A8F98")
+    img.save(dest)
+
+
+def kaart_beeld(pad, label, dest):
+    img = Image.new("RGB", (W, Hh), LIGHT2); d = ImageDraw.Draw(img)
+    shot = Image.open(pad).convert("RGB")
+    box_w, box_h = W - 2 * 96, Hh - 160 - 80
+    shot.thumbnail((box_w, box_h), Image.LANCZOS)
+    x = (W - shot.width) // 2; y = 130 + (box_h - shot.height) // 2
+    d.rectangle([x - 2, y - 2, x + shot.width + 1, y + shot.height + 1], outline=LINE, width=2)
+    img.paste(shot, (x, y))
+    if label:
+        d.text((96, 44), label, font=font(34, True), fill=DARK)
+    d.text((96, Hh - 60), "Reeks Copilot-agents voor school · LeX Consultancy · CC BY-SA 4.0", font=font(22), fill="#8A8F98")
+    img.save(dest)
+
+
+def lees_script(pad):
+    meta, segs, cur = {}, [], None
+    for raw in pad.read_text(encoding="utf-8").splitlines():
+        line = raw.rstrip()
+        if line.startswith("# ") and ":" in line and cur is None:
+            k, v = line[2:].split(":", 1); meta[k.strip()] = v.strip(); continue
+        m = re.match(r"^\[(titel|slot|beeld|kaart)(?::\s*(.*))?\]$", line)
+        if m:
+            cur = {"soort": m.group(1), "arg": (m.group(2) or "").strip(), "tekst": []}
+            segs.append(cur); continue
+        if cur is not None:
+            cur["tekst"].append(line)
+    for s in segs:
+        # lege regels worden een pauze in de spraak
+        s["spraak"] = re.sub(r"\n\s*\n", "\n\n", "\n".join(s["tekst"])).strip()
+    return meta, [s for s in segs if s["spraak"]]
+
+
+async def spreek(tekst, stem, tempo, mp3):
+    """Spreekt tekst uit en geeft de woordgrenzen (offset, duur in seconden, woord) terug."""
+    comm = edge_tts.Communicate(tekst, stem, rate=tempo)
+    woorden = []
+    with open(mp3, "wb") as f:
+        async for chunk in comm.stream():
+            if chunk["type"] == "audio":
+                f.write(chunk["data"])
+            elif chunk["type"] == "WordBoundary":
+                woorden.append((chunk["offset"] / 1e7, chunk["duration"] / 1e7, chunk["text"]))
+    return woorden
+
+
+def _norm(w):
+    return re.sub(r"[^\w]", "", w.lower())
+
+
+def cues_uit_woorden(tekst, woorden, totaal):
+    """Verdeelt de tekst in zinnen en koppelt elke zin aan de tijd van zijn woorden (woordgrenzen
+    van de spraakdienst; woorden die niet matchen worden overgeslagen, zonder grenzen valt hij
+    terug op een verdeling naar tekstlengte)."""
+    zinnen = [z.strip() for z in re.split(r"(?<=[.!?:])\s+", tekst.replace("\n", " ")) if z.strip()]
+    cues, i, vorige_eind = [], 0, 0.0
+    for z in zinnen:
+        start = eind = None
+        for w in z.split():
+            nw = _norm(w)
+            if not nw:
+                continue
+            for k in range(i, min(i + 4, len(woorden))):
+                if _norm(woorden[k][2]) == nw or nw.startswith(_norm(woorden[k][2])) or _norm(woorden[k][2]).startswith(nw):
+                    start = woorden[k][0] if start is None else start
+                    eind = woorden[k][0] + woorden[k][1]; i = k + 1
+                    break
+        if start is None:  # niets gevonden: naar tekstlengte
+            aandeel = len(z) / max(1, sum(len(x) for x in zinnen))
+            start, eind = vorige_eind, vorige_eind + aandeel * totaal
+        cues.append((start, eind, z)); vorige_eind = eind
+    return cues
+
+
+def duur(pad):
+    out = subprocess.run(["ffprobe", "-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", str(pad)],
+                         capture_output=True, text=True).stdout.strip()
+    return float(out)
+
+
+def srt_tijd(t):
+    h, r = divmod(t, 3600); m, s = divmod(r, 60)
+    return f"{int(h):02d}:{int(m):02d}:{int(s):02d},{int(round((s - int(s)) * 1000)):03d}"
+
+
+def main():
+    script = Path(sys.argv[1]).resolve()
+    map_ = script.parent
+    meta, segs = lees_script(script)
+    stem = meta.get("stem", "nl-NL-FennaNeural"); tempo = meta.get("tempo", "-5%")
+    naam = meta.get("uitvoer", script.stem.replace("video-script", "video"))
+    pauze = 0.8  # seconden stilte na elk segment
+    tmp = Path(tempfile.mkdtemp(prefix="video-"))
+    clips, cues, t0 = [], [], 0.0
+    for n, s in enumerate(segs, 1):
+        png, mp3, clip = tmp / f"{n:02d}.png", tmp / f"{n:02d}.mp3", tmp / f"{n:02d}.mp4"
+        if s["soort"] == "titel":
+            kaart_titel(meta.get("titel", ""), meta.get("ondertitel", ""), png)
+        elif s["soort"] == "slot":
+            kaart_slot(s["arg"] or "Kies het eenvoudigste patroon dat werkt.", png)
+        elif s["soort"] == "kaart":
+            delen = [d.strip() for d in s["arg"].split("|")]
+            kaart_tekst(delen[0], delen[1:], png)
+        else:
+            delen = [d.strip() for d in s["arg"].split("|")]
+            kaart_beeld(map_ / "beelden" / delen[0], delen[1] if len(delen) > 1 else "", png)
+        woorden = asyncio.run(spreek(s["spraak"], stem, tempo, mp3))
+        d = duur(mp3)
+        for a, b, z in cues_uit_woorden(s["spraak"], woorden, d):
+            cues.append((t0 + a, t0 + min(b + 0.15, d), z))
+        subprocess.run(["ffmpeg", "-v", "error", "-y", "-loop", "1", "-framerate", "25", "-i", str(png), "-i", str(mp3),
+                        "-af", f"apad=pad_dur={pauze}", "-t", f"{d + pauze:.3f}",
+                        "-c:v", "libx264", "-tune", "stillimage", "-pix_fmt", "yuv420p", "-r", "25",
+                        "-c:a", "aac", "-b:a", "128k", "-ar", "44100", "-ac", "1", str(clip)], check=True)
+        clips.append(clip); t0 += d + pauze
+        print(f"{n:02d} {s['soort']:6s} {d:5.1f}s  {s['spraak'][:60]}")
+    lijst = tmp / "lijst.txt"
+    lijst.write_text("".join(f"file '{c}'\n" for c in clips))
+    # ondertitels mogen elkaar niet overlappen
+    cues = [(a, min(b, cues[i + 1][0] - 0.05) if i + 1 < len(cues) else b, z) for i, (a, b, z) in enumerate(cues)]
+    srt = map_ / f"{naam}.srt"
+    srt.write_text("".join(f"{i}\n{srt_tijd(a)} --> {srt_tijd(b)}\n{z}\n\n" for i, (a, b, z) in enumerate(cues, 1)), encoding="utf-8")
+    mp4 = map_ / f"{naam}.mp4"
+    subprocess.run(["ffmpeg", "-v", "error", "-y", "-f", "concat", "-safe", "0", "-i", str(lijst), "-i", str(srt),
+                    "-c:v", "copy", "-c:a", "copy", "-c:s", "mov_text", "-metadata:s:s:0", "language=nld",
+                    "-metadata", f"title={meta.get('titel', naam)}", str(mp4)], check=True)
+    print(f"{mp4.name}: {mp4.stat().st_size // 1024} kB, {t0 / 60:.1f} min, {len(cues)} ondertitels")
+
+
+if __name__ == "__main__":
+    main()