Zes video's van 9 tot 10,5 minuten met de schermafbeeldingen, de stem nl-NL-FennaNeural en ondertitels (mp4 en srt). Tekst per handleiding in video-script.md; _gereedschap/maak_video.py bouwt ze opnieuw. README-tabel Video's en CHANGELOG bijgewerkt. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
9.9 KiB
titel: De Toetsweekplanner
ondertitel: Handleiding 3 · een Gem bouwen in Google Gemini
stem: nl-NL-FennaNeural
tempo: -5%
uitvoer: video-toetsweekplanner
reeks: Reeks Gemini-agents voor school
bron: git.lexconsultancy.nl/guido/gemini-handleidingen
[titel] Welkom bij de derde handleiding van de reeks Gemini-agents voor school. Je bouwt een Toetsweekplanner: een Gem die met een leerling een studieplan voor de toetsweek maakt. De Gem kent het toetsrooster als bestand, vraagt wanneer de leerling kan leren en hoe moeilijk de vakken zijn, en levert een plan per dag plus een tabel die met één klik naar Google Spreadsheets gaat.
Dit is ook de handleiding waarin het misging. Twee keer zelfs, en allebei leerzaam. Een csv-bestand als kennis zette de Gem aan het programmeren en liet hem het gesprek vergeten. En bij lange antwoorden brak Gemini af en begon opnieuw zonder geheugen. Beide zie je in deze video, met de oplossing.
[kaart: Wat je gaat maken | Een Gem met het toetsrooster als tekstbestand onder Knowledge | Hij vraagt de leermomenten en per vak makkelijk, gemiddeld of moeilijk | Vijf planregels: moeilijke vakken dubbel, elk vak twee keer, blokken met pauze | Een plan per dag in de chat en een tabel met Export to Sheets | Geen cijfers, oordelen of voorspellingen] Voor wie is dit? Een leerling uit klas 2, drie weken voor de toetsweek, die niet weet waar te beginnen. Heeft het rooster, een telefoon en anderhalf uur per avond.
Wat eruit komt: een plan per dag, met blok, vak, tijd en stof, en een tabel die de leerling naar Spreadsheets exporteert. De Gem houdt zich aan vijf planregels: moeilijke vakken krijgen twee keer zoveel tijd, elk vak komt minstens twee keer terug, blokken van 25 tot 45 minuten met pauze, de avond voor een toets alleen herhalen, en niets buiten de opgegeven momenten.
En hij geeft geen cijfers, oordelen of voorspellingen. Dat staat in de instructie en blijft erin.
[kaart: Lees dit eerst | Echte leerlingen alleen als de beheerder Gemini voor leerlingen aanzet | In deze handleiding ben jij de leerling | Een rooster is geen persoonsgegeven; zet er geen klassenlijst bij | Voor alle leerlingen, niet alleen voor wie ondersteuning nodig heeft | Geduld: een compleet plan duurt twee tot drie minuten] Een paar afspraken. Echte leerlingen kunnen de Gem alleen gebruiken als de beheerder Gemini voor leerlingen heeft aangezet. Dan chat de leerling in zijn eigen schoolaccount en komt de spreadsheet in zijn eigen Drive. In deze handleiding speel jij de leerling.
Je hebt het bestand toetsrooster-voorbeeld punt txt nodig: zes toetsen van maandag 12 tot en met vrijdag 16 oktober 2026, als zinnen. De csv-versie zit er ook bij, om te lezen. Die gaat niet in de Gem. Waarom niet, zie je zo.
[kaart: Stap 1. Naam en beschrijving | Name: Toetsweekplanner | Description: Maakt met een leerling een persoonlijk studieplan voor de toetsweek: verdeelt de toetsstof over de beschikbare momenten en levert het plan als tabel voor Google Spreadsheets.] Ga naar Gems, New Gem. Vul de naam in: Toetsweekplanner. En de beschrijving.
Plak in Instructions de tekst uit instructies punt txt. De instructie heeft vier delen. Wat de Gem nodig heeft van de leerling: het rooster, dat in het bestand staat, de leermomenten per dag, en per vak hoe moeilijk. Dan de vijf planregels. Dan wat hij oplevert: een overzicht per dag, een tabel voor Spreadsheets, en de vraag of er iets moet schuiven. En als laatste: geen cijfers, oordelen of voorspellingen, en niet naar de naam vragen.
Eén verschil met de Copilot-versie: geen Excel-bestand, maar een tabel die de leerling zelf exporteert. Een Gem maakt geen bestanden. Gemini zet wel elke tabel met één klik in Spreadsheets.
[beeld: 02-gem-kennis-txt.jpg | Stap 1. Het rooster als tekstbestand] Klik onder Knowledge op de plus, Upload files, en kies toetsrooster-voorbeeld punt txt. Het bestand staat als kaartje onder Knowledge met TXT erbij.
Zo ziet de goede versie eruit. Maar dit was niet onze eerste versie.
[beeld: 01-gem-kennis-csv.jpg | Stap 1. Wat we eerst deden: csv] Eerst hadden we het csv-bestand uit de Dify-reeks als kennis toegevoegd. Gemini accepteert dat gewoon. Het kaartje zegt CSV, en er lijkt niets aan de hand.
Let op: dat gaat mis, en je ziet zo hoe. Onthoud alvast: csv, Excel en andere tabellen als kennis zijn iets voor een Gem die moet rekenen op data, niet voor een Gem die een rooster moet kennen.
[beeld: 03-chat-start.jpg | Stap 1. Save en Start chat] Klik op Save en Start chat. Je bent in de chat van de Gem. Onder het invoerveld staan de eerdere chats met deze Gem.
[beeld: 04-rooster-show-code.jpg | Wat er misging: Show code] Dit is wat er met het csv-bestand gebeurde. Bij elke vraag verscheen Show code: de Gem schreef een programma om het csv-bestand te lezen. Dat werkte voor de eerste vraag, het rooster werd netjes samengevat.
[beeld: 06-draad-kwijt.jpg | Wat er misging: de draad kwijt] Maar na het derde bericht begon de Gem opnieuw bij stap 1, met een rooster dat niet klopte, alsof het gesprek nooit had plaatsgevonden.
Met hetzelfde rooster als zinnen in een txt-bestand leest de Gem het gewoon, met het label TXT bij het antwoord, en blijft het gesprek heel. Daarom: tekst of pdf als kennis, tenzij je juist wilt dat de Gem rekent.
[kaart: Stap 2. Alles in één bericht | Datum van vandaag: maandag 5 oktober 2026 | Leren van woensdag 7 tot en met donderdag 15 oktober, 16:00 tot 18:00 | Zaterdag niet; zondag 10:00 tot 12:00 en 15:00 tot 17:00 | Nederlands en Engels makkelijk, geschiedenis en biologie gemiddeld | Wiskunde en Frans moeilijk] Nu de test als leerling. De instructie zegt: stel de vragen een voor een. Dat doet de Gem ook. Maar in onze test brak Gemini in een gesprek van drie beurten twee keer af terwijl het plan al op het scherm stond, en begon opnieuw met Hoi, ik ga je helpen, zonder de eerdere berichten. Een keer kwam er alleen: daar ben ik niet voor ontwikkeld, ik ben maar een taalmodel.
Het model maakte geen verschil, Flash of Thinking. Wat wel hielp: alles in één bericht geven, zodat de Gem in één beurt kan plannen.
Stuur dus alles tegelijk: de datum van vandaag, de leermomenten per dag, en per vak hoe moeilijk. Het volledige bericht staat in de handleiding.
[beeld: 07-plan-begin.jpg | Stap 2. Het plan begint] De Gem vat eerst het rooster samen, met TXT-labels, en gaat dan plannen. Het plan verschijnt per dag, met blokken, pauzes en per blok de stof.
Wacht tot het antwoord klaar is. Dat duurt twee tot drie minuten.
[beeld: 08-tabel.jpg | Stap 2. De tabel] Onderaan staat een exporteerbare tabel, met de kolommen dag, datum, begintijd, eindtijd, vak en stof.
[beeld: 09-export-menu.jpg | Stap 2. Export to Sheets] Klik op de knop met drie puntjes onder de tabel. Kies Export to Sheets. Linksonder verschijnt: New spreadsheet created, met de knop Open Sheets.
[beeld: 10-sheets.jpg | Stap 2. Het plan in Spreadsheets] Klik op Open Sheets. De tabel staat in een nieuwe spreadsheet in je Drive, met de naam van je vraag als titel.
Let op: komt er daar ben ik niet voor ontwikkeld, klik dan op het pijltje onder het antwoord en kies Try again. In onze test kwam het plan de tweede keer wel. Begint de Gem halverwege opnieuw met Hoi, stuur dan hetzelfde bericht in een nieuwe chat. Dit gedrag zit in Gemini, niet in jouw instructie.
[beeld: 11-regelcheck.jpg | Stap 3. Controleer het plan] Lees het plan tegen de vijf regels. In onze test stond Engels op zondagochtend als nieuwe stof, een dag voor de laatste herhaling, met de toets op dinsdag. Leg dat de Gem voor: klopt dat met je regels?
[beeld: 12-regelcheck-vervolg.jpg | Stap 3. De Gem controleert zichzelf] De Gem citeert de twee regels waar het om gaat, legt uit wat er mis is en vraagt of hij de planning voor Engels mag aanpassen.
Dit is de les van de hele reeks: een Gem 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.
Zelf kiezen: voeg aan Wat je oplevert toe: loop het plan voordat je het geeft na op alle vijf de planregels. Dat vangt een deel van de fouten af. Niet alles.
[kaart: Controleren of het gelukt is | De Gem vat het rooster samen met TXT-labels | Het plan gebruikt alleen de opgegeven momenten; kijk zelf na | Onder het plan een tabel met Export to Sheets | De spreadsheet staat in je Drive | Op een vraag naar een regel legt de Gem uit en biedt hij een correctie aan] Loop de lijst na. Zie je Show code bij elk antwoord, dan staat er nog een csv in Knowledge. Plant de Gem vanaf een verkeerde datum, dan weet hij niet welke dag het is: geef de datum in je bericht. Ontbreekt Export to Sheets, dan is het een lijst en geen tabel. Vraag om een echte tabel met kolommen.
Eerlijk is eerlijk: Gemini is in september 2026 de makkelijkste omgeving om een Gem te bouwen, en niet de stabielste voor lange gesprekken. Voor een leerling is dat vervelend maar overkomelijk. Vertel het ze vooraf: alles in één bericht, en bij Try again niet schrikken.
[kaart: Maak hem van jou | Het echte rooster van een klas, als tekstbestand | Je eigen planregels van de studielessen | Alleen de tabel, geen overzicht per dag: korter, minder kans op afbreken | Zelfcontrole op de regels in de instructie | Een eigenaar die het rooster elke toetsweek vervangt] De Gem wordt van jou met het echte rooster van een klas, als tekstbestand zonder namen. Vraag twee mentoren welke drie planregels zij hun leerlingen meegeven en zet die in de instructie.
Wil je minder kans op afbreken, vraag dan alleen de tabel en geen overzicht per dag. Kortere antwoorden, stabieler gesprek.
En een opdracht die de kern raakt: loop een plan regel voor regel na en leg de Gem de fouten voor. Jij blijft de controleur.
[slot: De Gem plant, jij controleert. Een regel is geen programma.] Dat was de Toetsweekplanner. Handleiding, instructie, rooster en beelden staan in de repository, inclusief wat er misging.
In de volgende video plakt de docent een lesbrief en beoordeelt een Gem hem op toegankelijkheid. Daar komt het lange antwoord terug, en de oplossing: in porties.