feat: Gemini-reeks, zes handleidingen voor Gems in Google Gemini (eerste uitgave)

Schoolgids-assistent, Ouderbrief-assistent, Toetsweekplanner, Lesmateriaal-check, Studiecoach en Notulen-assistent als Gems, met instructies, kennisbestanden, vervaagde schermafbeeldingen, README met vergelijking Gemini/Copilot/Dify en CHANGELOG. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-21 17:17:39 +02:00
commit ccb209f5c1
99 changed files with 2171 additions and 0 deletions
@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""Bouwt handleiding-gemini-notulen-assistent.html, .pdf en .docx. Gebruik: python3 build.py
+Het echte werk staat in ../_gereedschap/build_handleiding.py (gedeeld door alle handleidingen)."""
+import runpy, sys
+from pathlib import Path
+sys.argv = ["build_handleiding.py", str(Path(__file__).resolve().parent / "handleiding-gemini-notulen-assistent.md")]
+runpy.run_path(str(Path(__file__).resolve().parent.parent / "_gereedschap" / "build_handleiding.py"), run_name="__main__")
@@ -0,0 +1,250 @@
+<!--
+VOOR DE BEWERKER
+
+Handleiding 6 van de Gemini-reeks: de Notulen-assistent als Gem in Google Gemini. Beelden in
+beelden/, vastgelegd op 22 september 2026 (Gemini in een Google Workspace for Education-account,
+Engelse interface; de zijbalk met eerdere chats is vervaagd).
+
+Omzetten naar HTML, PDF en Word:  python3 build.py
+
+Bestanden in deze map:
+  sectieoverleg-transcript.txt   het fictieve transcript (zelfde tekst als de opname in de Dify-reeks, handleiding 5)
+  instructies.txt                de volledige instructie van de Gem, om te plakken
+-->
+
+# Bouwen in Google Gemini: de Notulen-assistent
+
+**Handleiding 6 van de reeks Gemini-agents voor school**  
+LeX Consultancy B.V. · 22 september 2026
+
+Je bouwt een Gem die van het transcript van een overleg een verslag maakt met vijf vaste kopjes: Overleg, Samenvatting, Besluiten, Actiepunten (als tabel) en Doorgeschoven. Het transcript plak je in de chat; het verslag zet je met **Export to Docs** in Google Documenten. De kortste instructie uit de reeks, en de Gem die het meest direct tijd oplevert.
+
+Dit is de tegenhanger van handleiding 5 uit de Dify-reeks (waar de opname zelf werd omgezet naar tekst) en handleiding 6 uit de Copilot-reeks. Een Gem kan geen audio transcriberen; het transcript komt uit Meet, uit een telefoon, of uit de Dify-versie.
+
+Deze handleiding volgt Gemini zoals het er op 22 september 2026 uitziet, in een Google Workspace for Education-account met Engelse interface. Wijkt je scherm af, volg dan wat je ziet.
+
+**Zo lees je deze handleiding**
+
+| Vorm | Betekenis |
+| --- | --- |
+| 1. 2. 3. | Wat je doet: klikken, kiezen, openen |
+| **Vet** | Een knop, menu of veld zoals het op je scherm staat |
+| Tabel *Wat je intypt* | Waarden die je in een formulierveld zet |
+| Grijs kader *Intypen* | Tekst die je letterlijk overtypt of plakt |
+| Oranje kader | Een valkuil die je anders zelf ontdekt |
+| Groen kader *Zelf kiezen* | Een plek waar je ons voorbeeld kunt vervangen door je eigen materiaal, stijl of prompt |
+
+---
+
+<!-- ontwerpkaart -->
+## De ontwerpkaart van deze app
+
+| 1. Voor wie | 2. Wat gaat erin |
+| --- | --- |
+| De notulist van een sectieoverleg die het verslag altijd twee weken later pas af heeft. Heeft een transcript van drie kwartier en een kwartier tijd. | Het transcript, geplakt in de chat. |
+
+| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
+| --- | --- |
+| Een verslag met vijf kopjes (Overleg, Samenvatting, Besluiten, Actiepunten met wie en wanneer, Doorgeschoven), en met Export to Docs een Google-document. Onzekere namen en getallen met een vraagteken. | Niets verzinnen; zijpaden weglaten; "niet genoemd" als een datum ontbreekt; geen inleiding of afsluiting; iemand leest het verslag na. |
+
+**5. Waaraan zie je dat het werkt**
+
+| Test | Wat gaat erin | Wat moet eruit komen |
+| --- | --- | --- |
+| 1 | "Wat kun je voor mij doen?" | Eén zin uitleg en de vraag om het transcript |
+| 2 | Het transcript van het sectieoverleg | Vijf kopjes, drie actiepunten met eigenaar, het koffieapparaat weggelaten |
+| 3 (de lastige) | Een transcript met een verkeerd verstane naam | De meest waarschijnlijke naam, met (?) erachter |
+<!-- /ontwerpkaart -->
+
+## Lees dit eerst: wat mag en wat niet
+
+| Wat | Afspraak |
+| --- | --- |
+| Wat erin gaat | Transcripten van overleggen van medewerkers, in het schoolaccount. Geen gesprekken met of over individuele leerlingen of ouders. |
+| Opnemen | Vooraf toestemming van alle deelnemers. Structureel opnemen: de medezeggenschapsraad informeren. |
+| Bewaren | Het transcript staat na het plakken in je chatgeschiedenis. Verwijder de chat als het verslag klaar is (drie puntjes bij de chat onder Recent, Delete). |
+| Nalezen | De Gem schrijft, de notulist leest na en stuurt rond. Vraagtekens in het verslag zijn de plekken waar dat het hardst nodig is. |
+
+---
+
+## Voorbereiding
+
+- Handleiding 1 gedaan.
+- `sectieoverleg-transcript.txt` uit deze map: een fictief sectieoverleg Nederlands van drie personen, met drie agendapunten, een zijpad over het koffieapparaat en een doorgeschoven besluit. Drie minuten leestijd.
+
+> **Zelf kiezen: het transcript.** Transcripten uit Google Meet (Meet-notities, of de transcriptie in Drive) plakken net zo. Kijk vooraf even of er geen namen van leerlingen in staan.
+
+---
+
+## Stap 1. Maak de Gem
+
+1. **Gems**, **New Gem**. Vul in:
+
+| Veld op het scherm | Wat je intypt |
+| --- | --- |
+| Name | `Notulen-assistent` |
+| Description | `Maakt van het transcript van een overleg een kort verslag met samenvatting, besluiten en actiepunten.` |
+
+2. Plak in **Instructions** de tekst uit `instructies.txt`:
+
+```
+Je bent de Notulen-assistent van Het Voorbeeldcollege. Een collega plakt het transcript van een overleg (of voegt het als bestand bij) en jij maakt er een verslag van.
+
+Het transcript komt vaak van automatische spraakherkenning en kan fouten bevatten in namen en getallen; schrijf dan op wat het meest waarschijnlijk is en zet een vraagteken tussen haakjes achter wat je niet zeker weet.
+
+Schrijf in het Nederlands, zakelijk en kort. Gebruik precies deze indeling met deze kopjes:
+
+## Overleg
+Een regel: welk overleg, datum, aanwezigen (als dat uit het transcript blijkt).
+
+## Samenvatting
+Maximaal vijf zinnen over wat er is besproken.
+
+## Besluiten
+Genummerde lijst. Alleen wat echt is besloten, geen voornemens.
+
+## Actiepunten
+Tabel met kolommen: Wat, Wie, Wanneer. Staat er geen datum, schrijf dan "niet genoemd".
+
+## Doorgeschoven
+Punten die bewust naar een volgend overleg zijn verplaatst, met de reden.
+
+Regels:
+- Laat zijpaden en informele opmerkingen weg.
+- Verzin niets wat niet in het transcript staat.
+- Krijg je geen transcript maar een vraag, leg dan in een zin uit wat je doet en vraag om het transcript.
+- Vraagt de collega om het verslag als bestand, zeg dan dat het verslag met Exporteren naar Documenten (onder het antwoord) in Google Documenten komt te staan.
+- Geen inleiding, geen compliment, geen afsluiting van jouw kant: alleen het verslag.
+```
+
+De indeling staat letterlijk in de instructie, met de kopjes; dat is waarom elk verslag er hetzelfde uitziet. De regel over vraagtekens is er voor transcripten uit spraakherkenning, waar namen en getallen het vaakst misgaan.
+
+![De ingevulde Gem](beelden/01-gem-ingevuld.jpg)
+
+3. Geen kennis, geen default tool. **Save**, **Start chat**.
+
+![De Notulen-assistent in de chat](beelden/02-chat-start.jpg)
+
+---
+
+## Stap 2. Test
+
+1. Vraag wat de Gem doet.
+
+| Bericht | Wat je intypt |
+| --- | --- |
+| 1 | `Wat kun je voor mij doen?` |
+
+Eén zin: wat hij maakt en met welke kopjes, en de vraag om het transcript te plakken. Dat is de derde regel.
+
+![Eén zin uitleg en de vraag om het transcript](beelden/03-wat-doe-je.jpg)
+
+2. Open `sectieoverleg-transcript.txt`, kopieer alles en plak het achter "Maak een verslag van dit transcript:". Verstuur.
+
+![Het transcript in het invoerveld](beelden/04-transcript-geplakt.jpg)
+
+Na ongeveer een minuut staat het verslag er, met de vijf kopjes.
+
+![Overleg en Samenvatting](beelden/05-verslag-begin.jpg)
+
+Let op:
+
+- Achter de datum staat **(?)**: "dinsdag 22 september(?)". Het jaar staat niet in het transcript, dus de Gem markeert de datum als onzeker. Precies wat de instructie vraagt, en een goed voorbeeld van hoe letterlijk een Gem een regel neemt.
+- De **Samenvatting** is vier zinnen.
+- Onder **Besluiten** staan drie besluiten: de gecombineerde toets, het doorschuiven van de leesmethode, de rolverdeling op de open dag. Het voornemen om beide pakketten uit te proberen staat er niet bij; dat was geen besluit.
+
+![Samenvatting en Besluiten](beelden/06-samenvatting-besluiten.jpg)
+
+- **Actiepunten** is een tabel met drie regels: Fatima (studiewijzer, vrijdag 25 september), Bram (kosten opvragen, deze week), Bram (proeflesopzet, voor 1 november).
+- **Doorgeschoven** noemt de leesmethode, met de reden.
+- Het koffieapparaat komt nergens voor.
+
+![Actiepunten als tabel, en Doorgeschoven](beelden/07-actiepunten-doorgeschoven.jpg)
+
+3. Zet het verslag in Google Documenten. Klik op **...** onder het antwoord en kies **Export to Docs**. Wacht op **New document created** en klik op **Open Docs**.
+
+![Het menu onder het antwoord met Export to Docs](beelden/08-export-menu.jpg)
+
+> **Draft in Gmail** staat direct onder **Export to Docs**. Wie te snel klikt, heeft het verslag als conceptmail in Gmail staan. Verwijder het concept en kies opnieuw.
+
+Het verslag staat als document in je Drive: de kopjes als koppen, de besluiten als genummerde lijst, de actiepunten als tabel.
+
+![Het verslag in Google Documenten](beelden/09-docs.jpg)
+
+> Een tabel in het antwoord heeft ook een eigen knop **...** met **Export to Sheets**. Wie de actiepunten in een spreadsheet bijhoudt, exporteert alleen de tabel.
+
+4. De lastige test: een fout in het transcript.
+
+| Bericht | Wat je intypt |
+| --- | --- |
+| 3 | Plak het transcript opnieuw, maar vervang één keer "Fatima" door "Fatma" en "12 oktober" door "12 november". |
+
+Een goed verslag noemt Fatima (of Fatma) met (?) en zet een vraagteken bij de datum, of houdt de datum aan die het vaakst voorkomt. Verzint de Gem er iets omheen, dan is de regel "Verzin niets" niet streng genoeg.
+
+---
+
+## Controleren of het gelukt is
+
+- Op een vraag zonder transcript volgt één zin en de vraag om het transcript
+- Het verslag heeft precies de vijf kopjes, in die volgorde
+- Actiepunten staan in een tabel met Wat, Wie, Wanneer
+- Het koffieapparaat staat er niet in; de leesmethode staat onder Doorgeschoven, met reden
+- Export to Docs geeft een document met koppen, lijst en tabel
+
+## Als het misgaat
+
+| Wat je ziet | Wat er aan de hand is |
+| --- | --- |
+| De Gem vat samen in eigen kopjes | De indeling in de instructie is niet letterlijk overgenomen (de dubbele hekjes horen erbij) |
+| Er staat een inleiding of een compliment boven het verslag | De laatste regel ontbreekt |
+| Actiepunten zonder eigenaar | Het transcript noemt geen eigenaar; kijk in het transcript. Staat hij er wel, voeg dan toe: "Zoek de eigenaar in de zin waarin het actiepunt wordt toegezegd" |
+| Het verslag breekt af en de Gem begint opnieuw | Een lang transcript geeft een lang antwoord (zie handleiding 3). Plak het transcript in twee delen, of vraag eerst alleen Besluiten en Actiepunten |
+| **Export to Docs** ontbreekt | Het menu **...** staat onder het antwoord, niet onder de tabel. Onder de tabel staat Export to Sheets |
+| Het document heeft geen tabel | Export to Docs neemt gewone tabellen mee. Vraag anders om de actiepunten als lijst |
+
+---
+
+## Gemini naast Dify en Copilot
+
+| | Dify (handleiding 5) | Copilot Chat (handleiding 6) | Gemini Gem |
+| --- | --- | --- | --- |
+| Audio omzetten | Ja, met Speech To Text en eigen sleutel | Nee | Nee |
+| Transcript aanleveren | Als opname | Plakken of bijvoegen | Plakken |
+| Verslag als bestand | Downloadbare tekst | Word op OneDrive (tweede poging) | Export to Docs, één klik |
+| Actiepunten apart | Nee | Nee | Export to Sheets onder de tabel |
+| Bewaren | Dify bewaart uploads; zelf wissen | Chat in het tenant | Chat in Drive-account; zelf wissen |
+
+Voor wie het transcript al heeft, is dit de handigste van de drie: plakken, exporteren, klaar. Voor wie alleen een opname heeft, blijft de Dify-versie nodig, of de transcriptie van Google Meet.
+
+---
+
+## Maak hem van jou
+
+| Aanpassing | Waar | Moeilijkheid | Wat je ervoor terugkrijgt |
+| --- | --- | --- | --- |
+| Andere kopjes (bijvoorbeeld "Ter informatie") | Stap 1, de indeling | makkelijk | Een verslag in het format van jullie sectie |
+| Een vaste verzendlijst bovenaan | Stap 1, nieuwe regel | makkelijk | Minder handwerk |
+| Actiepunten ook in een spreadsheet | **...** onder de tabel, Export to Sheets | makkelijk | Een actielijst die je kunt filteren |
+| Twee talen (Nederlands en Engels) | Stap 1, nieuwe regel | gemiddeld | Verslagen voor een internationale sectie |
+| Transcript uit Google Meet | Meet-notities of het transcript uit Drive plakken | gemiddeld | Van vergadering naar verslag in tien minuten |
+| Opname omzetten | Niet in een Gem | moeilijk | Daarvoor Google Meet of de Dify-versie |
+
+**Drie opdrachten**
+
+1. **Jouw overleg.** Plak een eigen transcript (zonder leerlingnamen) en vergelijk het verslag met wat de notulist zelf zou schrijven. Wat mist er, en staat dat in het transcript?
+2. **Vraagtekens.** Zet drie fouten in het transcript (een naam, een datum, een bedrag). Vindt de Gem ze alle drie? Welke niet, en waarom niet?
+3. **Van Meet naar verslag.** Neem een kort overleg op in Google Meet met transcriptie aan, plak het transcript in de Gem en exporteer. Hoeveel tijd kost het van einde overleg tot verslag in Drive?
+
+**Checklist voordat je eigen materiaal gebruikt**
+
+- [ ] Alle deelnemers weten dat het overleg wordt opgenomen
+- [ ] Het transcript bevat geen namen van leerlingen of ouders
+- [ ] De notulist leest het verslag na, vooral de plekken met (?)
+- [ ] De chat met het transcript wordt na afloop verwijderd
+- [ ] Er is een eigenaar die de indeling bijhoudt en op **Update** klikt
+
+---
+
+## En verder
+
+Zes Gems, zes patronen: voorlezen uit een document (1), regels toepassen op een tekst (2), vragen en plannen (3), beoordelen en herschrijven (4), coachen met de stof als bestand (5), en samenvatten in een vast format (6). Alles in Gemini zoals het bij elke school met Google Workspace for Education zit, zonder extra licentie. Wat niet kan in een Gem: audio omzetten, een mens in de lus, gesprekken teruglezen, en lange antwoorden zonder haperen. Daarvoor staan de Dify-reeks (handleiding 5 en 8) en, voor Microsoft-scholen, de Copilot-reeks.
@@ -0,0 +1,27 @@
+Je bent de Notulen-assistent van Het Voorbeeldcollege. Een collega plakt het transcript van een overleg (of voegt het als bestand bij) en jij maakt er een verslag van.
+
+Het transcript komt vaak van automatische spraakherkenning en kan fouten bevatten in namen en getallen; schrijf dan op wat het meest waarschijnlijk is en zet een vraagteken tussen haakjes achter wat je niet zeker weet.
+
+Schrijf in het Nederlands, zakelijk en kort. Gebruik precies deze indeling met deze kopjes:
+
+## Overleg
+Een regel: welk overleg, datum, aanwezigen (als dat uit het transcript blijkt).
+
+## Samenvatting
+Maximaal vijf zinnen over wat er is besproken.
+
+## Besluiten
+Genummerde lijst. Alleen wat echt is besloten, geen voornemens.
+
+## Actiepunten
+Tabel met kolommen: Wat, Wie, Wanneer. Staat er geen datum, schrijf dan "niet genoemd".
+
+## Doorgeschoven
+Punten die bewust naar een volgend overleg zijn verplaatst, met de reden.
+
+Regels:
+- Laat zijpaden en informele opmerkingen weg.
+- Verzin niets wat niet in het transcript staat.
+- Krijg je geen transcript maar een vraag, leg dan in een zin uit wat je doet en vraag om het transcript.
+- Vraagt de collega om het verslag als bestand, zeg dan dat het verslag met Exporteren naar Documenten (onder het antwoord) in Google Documenten komt te staan.
+- Geen inleiding, geen compliment, geen afsluiting van jouw kant: alleen het verslag.
@@ -0,0 +1,37 @@
+Sectieoverleg Nederlands, dinsdag 22 september. Aanwezig zijn Karin, Bram en Fatima. Karin zit voor.
+
+Karin: Goedemiddag allemaal. We hebben drie punten: de toetsweek van oktober, de nieuwe leesmethode voor de brugklas, en de rolverdeling bij de open dag. Laten we beginnen met de toetsweek. Bram, jij had de conceptplanning gemaakt.
+
+Bram: Klopt. De toets leesvaardigheid voor de tweede klassen staat nu op maandag 12 oktober om negen uur, zestig minuten. Ik stel voor dat we die zo laten. Wat ik wel wil voorstellen is dat we de spellingstoets samenvoegen met de leestoets, dus één toets van zestig minuten in plaats van twee losse toetsen.
+
+Fatima: Daar ben ik het mee eens. Twee losse toetsen in één week is voor de tweedeklassers te veel. Maar dan moet de studiewijzer wel worden aangepast, want daar staan nu nog twee toetsen in.
+
+Karin: Goed. Dan besluiten we dat: één gecombineerde toets leesvaardigheid en spelling op maandag 12 oktober, zestig minuten. Fatima, pas jij de studiewijzer aan?
+
+Fatima: Doe ik. Vrijdag heb ik hem klaar.
+
+Karin: Prima, vrijdag 25 september dus. Dan punt twee, de leesmethode. We hebben twee proefpakketten gekregen. Bram heeft ze bekeken.
+
+Bram: Ja, en eerlijk gezegd vind ik het lastig kiezen. Het ene pakket heeft veel betere teksten voor zwakke lezers, het andere heeft een digitale omgeving die veel beter werkt. Ik zou eigenlijk willen dat we ze allebei een periode uitproberen in één klas.
+
+Fatima: Kunnen we dat wel betalen? En hebben we daar de tijd voor met de toetsweek eraan?
+
+Karin: Ik denk dat we dit niet vandaag moeten beslissen. Ik stel voor dat we dit doorschuiven naar het volgende overleg, en dat Bram in de tussentijd bij de uitgevers navraagt wat een proefperiode kost. Akkoord?
+
+Bram: Akkoord. Ik mail ze deze week nog.
+
+Karin: Dan schuiven we de keuze van de leesmethode door naar het overleg van 6 oktober. Even tussendoor, heeft iemand nog gehoord hoe het zit met het koffieapparaat in de docentenkamer? Hij doet het al een week niet.
+
+Fatima: Ik heb het gemeld bij de conciërge, die zou er iemand naar laten kijken.
+
+Karin: Goed, dan hoeven we daar niks mee. Punt drie, de open dag op zaterdag 7 november. We moeten twee mensen hebben bij de stand van Nederlands, en iemand die de proefles verzorgt.
+
+Bram: Ik doe de proefles wel, dat heb ik vorig jaar ook gedaan.
+
+Fatima: Ik kan bij de stand staan in de ochtend, tot half een.
+
+Karin: Dan doe ik de middag bij de stand. Dan is het rond. Bram, jij stuurt de proeflesopzet voor 1 november naar mij, dan kan ik hem in het programmaboekje zetten.
+
+Bram: Ja, komt voor elkaar.
+
+Karin: Dan hebben we alles gehad. Samengevat: één gecombineerde toets op 12 oktober, Fatima past de studiewijzer aan voor vrijdag, de leesmethode schuiven we door naar 6 oktober en Bram vraagt de proefkosten op, en voor de open dag doet Bram de proefles en staan Fatima en ik bij de stand. Bedankt allemaal, tot volgende week.