gemini-handleidingen/03-toetsweekplanner/handleiding-gemini-toetsweekplanner.md

Bouwen in Google Gemini: de Toetsweekplanner

Handleiding 3 van de reeks Gemini-agents voor school
LeX Consultancy B.V. · 22 september 2026

Je bouwt 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 de leerling met één klik naar Google Spreadsheets zet.

Dit is de tegenhanger van handleiding 4 uit de Dify-reeks en handleiding 3 uit de Copilot-reeks. Het 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 staan hier, met de oplossing.

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

---

De ontwerpkaart van deze app

1. Voor wie	2. Wat gaat erin
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.	Het toetsrooster (als bestand in de Gem), de datum van vandaag, de momenten waarop de leerling kan leren, en per vak makkelijk/gemiddeld/moeilijk.

3. Wat komt eruit	4. Waar moet hij zich aan houden
Een plan per dag in de chat (blok, vak, tijd, stof) en een tabel met de knop Export to Sheets. Afsluiting met de vraag of er iets moet schuiven.	Vijf planregels (moeilijke vakken dubbel, elk vak twee keer, blokken van 25-45 minuten met pauze, avond voor de toets alleen herhalen, niets buiten de opgegeven momenten); geen cijfers of oordelen; geen naam vragen.

5. Waaraan zie je dat het werkt

Test	Wat gaat erin	Wat moet eruit komen
1	Datum, leermomenten en moeilijkheid	Een plan dat de momenten respecteert, plus een tabel die naar Spreadsheets kan
2	"Op zondag staat Engels als nieuwe stof, terwijl de toets dinsdag is. Klopt dat met je regels?"	De Gem controleert zichzelf aan de regels en stelt een correctie voor
3 (de lastige)	"Ga ik mijn wiskundetoets halen?"	Geen voorspelling; terug naar het plan

Lees dit eerst: wat mag en wat niet

Wat	Afspraak
Echte leerlingen	Alleen 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 ben jij de "leerling".
Wat de Gem zegt	Geen cijfers, oordelen of voorspellingen over toetsen. Dat staat in de instructie en blijft erin.
Het rooster	Een rooster is geen persoonsgegeven. Zet er geen klassenlijst bij.
Voor wie	Als de planner ooit voor leerlingen gaat: voor alle leerlingen, niet alleen voor wie een ondersteuningsbehoefte heeft.

---

Voorbereiding

• Handleiding 1 gedaan.
• toetsrooster-voorbeeld.txt uit deze map: zes toetsen van maandag 12 tot en met vrijdag 16 oktober 2026, als zinnen. De csv-versie staat er ook bij, om te lezen; die gaat niet in de Gem (zie stap 1).
• Geduld: een compleet plan duurde in onze test twee tot drie minuten.

Zelf kiezen: het rooster. Zet het echte toetsrooster van een klas in een tekstbestand, per regel dag, datum, vak, begintijd, duur en stof. Zonder leerlinggegevens, want het is een rooster, geen klassenlijst.

---

Stap 1. Maak de Gem, met het rooster als tekstbestand

1. Gems, New Gem. Vul in:

Veld op het scherm	Wat je intypt
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.

2. Plak in Instructions de tekst uit instructies.txt:

Je bent de Toetsweekplanner voor leerlingen in de onderbouw van het voortgezet onderwijs. Je helpt een leerling een persoonlijk studieplan te maken voor de toetsweek. Je spreekt de leerling aan met je, in korte zinnen en gewoon Nederlands.

Wat je nodig hebt van de leerling:
1. Het toetsrooster. Het rooster van deze toetsweek staat in het bestand toetsrooster-voorbeeld.txt in je kennis; vat het kort samen. Geeft de leerling een ander rooster, gebruik dan dat.
2. De momenten waarop de leerling kan leren, per dag, vanaf vandaag tot de laatste toets. Vraag ook welke datum het vandaag is als je dat niet weet.
3. Per vak hoe moeilijk de leerling het vindt: makkelijk, gemiddeld of moeilijk.

Stel deze vragen een voor een, niet allemaal tegelijk. Ga pas plannen als je alle drie hebt.

Planregels:
- Moeilijke vakken krijgen ongeveer twee keer zoveel tijd als makkelijke vakken.
- Elk vak komt minstens twee keer terug, met minimaal een dag ertussen; de laatste keer is de dag voor de toets.
- Een leerblok duurt 25 tot 45 minuten, met daarna 10 minuten pauze. Nooit meer dan drie blokken achter elkaar.
- De avond voor een toets alleen herhalen, geen nieuwe stof.
- Plan niets op momenten die de leerling niet heeft opgegeven.

Wat je oplevert:
- Een overzicht in de chat: per dag de blokken met vak, tijd en wat er precies geleerd wordt (welke hoofdstukken of paragrafen).
- Een tabel met per rij: dag, datum, begintijd, eindtijd, vak, stof, die de leerling naar Google Spreadsheets kan exporteren. Zeg erbij dat dat kan met de knop Exporteren naar Spreadsheets onder het antwoord.
- Sluit af met een vraag of de leerling iets wil verschuiven.

Je geeft geen cijfers, oordelen of voorspellingen over hoe de toetsen zullen gaan. Je vraagt niet naar de naam van de leerling en bewaart niets.

Dezelfde vier delen als in de Copilot-versie, met één verschil in "Wat je oplevert": 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.

3. Onder Knowledge: +, Upload files, toetsrooster-voorbeeld.txt.

Waarom een tekstbestand en geen csv? Dat hadden we eerst gedaan: het csv-bestand uit de Dify-reeks als kennis. Gemini accepteert dat, maar bij elke vraag verscheen Show code: de Gem schreef een programma om het csv-bestand te lezen. Dat werkte voor de eerste vraag en ging daarna mis: 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 (label TXT bij het antwoord) en blijft het gesprek heel. Csv, Excel en andere tabellen als kennis zijn dus iets voor een Gem die moet rekenen op data, niet voor een Gem die een rooster moet kennen.

4. Save, Start chat.

---

Stap 2. Test als leerling: alles in één bericht

De instructie zegt "stel deze vragen een voor een", en 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 (Flash of Thinking) maakte geen verschil. Wat wel hielp: alles in één bericht geven, zodat de Gem in één beurt kan plannen.

1. Stuur alles tegelijk.

Bericht	Wat je intypt
1	Hoi, ik wil een studieplan voor de toetsweek. Het is vandaag maandag 5 oktober 2026. Ik kan leren van woensdag 7 tot en met donderdag 15 oktober, elke dag van 16:00 tot 18:00. Zaterdag 10 oktober niet. Zondag 11 oktober van 10:00 tot 12:00 en van 15:00 tot 17:00. Nederlands vind ik makkelijk, wiskunde moeilijk, Engels makkelijk, geschiedenis gemiddeld, biologie gemiddeld, Frans moeilijk.

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.

2. Wacht tot het antwoord klaar is (twee tot drie minuten). Onderaan staat Exporteerbare tabel, met de kolommen dag, datum, begintijd, eindtijd, vak en stof.

3. Klik op de knop ... onder de tabel. Kies Export to Sheets. Linksonder verschijnt New spreadsheet created met Open Sheets.

4. Klik op Open Sheets. De tabel staat in een nieuwe spreadsheet in je Drive, met de naam van je vraag als titel.

Komt er "Daar ben ik niet voor ontwikkeld, ik ben maar een taalmodel", 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.

---

Stap 3. Controleer het plan aan de regels

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.

Bericht	Wat je intypt
2	Op zondagochtend 11 oktober staat Engels unit 3 en 4 als nieuwe stof, terwijl de toets Engels dinsdag is en Engels daarna nog maar een keer terugkomt. Klopt dat met je regels?

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: laat de Gem zichzelf controleren. Voeg aan "Wat je oplevert" toe: "Loop het plan voordat je het geeft na op alle vijf de planregels en verbeter het waar het niet klopt." Dat vangt een deel van de fouten af, niet alles.

---

Wat er misging, en wat je daarvan leert

Twee dingen die in de Copilot- en Dify-versie niet voorkwamen:

1. Het csv-bestand. Zie stap 1. Een tabelbestand als kennis zet Gemini aan het programmeren (Show code), en dat kost het gesprek. Tekst of pdf als kennis, tenzij je juist wilt dat de Gem rekent.

2. Lange antwoorden. Een studieplan van negen dagen is een lang antwoord. Twee keer brak de stroom halverwege af en begon de Gem opnieuw zonder de eerdere berichten. Dat gebeurde met Flash en met Thinking, met csv en met txt. Alles in één bericht geven maakt het gesprek korter en daarmee de kans kleiner; Try again helpt als het toch gebeurt. Handleiding 4 heeft hetzelfde probleem bij een lange leerlingversie en lost het op met "in porties".

Voor een leerling is dat vervelend maar overkomelijk. Voor de handleiding is het de reden om eerlijk te zijn: Gemini is in september 2026 de makkelijkste omgeving om een Gem te bouwen, en niet de stabielste voor lange gesprekken.

---

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 staat een tabel met ... en daarin 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

Als het misgaat

Wat je ziet	Wat er aan de hand is
Show code bij elk antwoord, en de Gem vergeet het gesprek	Er staat een csv- of Excel-bestand in Knowledge. Vervang het door tekst of pdf
"Daar ben ik niet voor ontwikkeld, ik ben maar een taalmodel"	Het antwoord is mislukt. Pijltje onder het antwoord, Try again
De Gem begint halverwege opnieuw met "Hoi!"	Afgebroken stroom. Nieuwe chat, alles in één bericht
De Gem plant vanaf een verkeerde datum	Hij weet niet welke dag het is. Geef de datum in je bericht
Geen tabel, alleen tekst	De zin over de tabel in "Wat je oplevert" ontbreekt. Vraag: "Zet het plan in een tabel"
Export to Sheets ontbreekt onder de tabel	Het is een lijst, geen tabel. Vraag om een echte tabel met kolommen
De Gem noemt een cijfer of een kans	De laatste alinea van de instructie ontbreekt

---

Gemini naast Dify en Copilot

	Dify (handleiding 4)	Copilot Chat (handleiding 3)	Gemini Gem
Rooster meegeven	Bestand bij de agent	In de instructie	Tekstbestand in de Gem (geen csv)
Datum weten	Tool CurrentTime	Niet; de leerling geeft de datum	Niet; de leerling geeft de datum
Bestand maken	Sandbox, xlsx en ics	CodeInterpreter, Excel op OneDrive	Geen; tabel met Export to Sheets
Waar komt het bestand	Link in de chat	OneDrive van de gebruiker	Drive van de gebruiker
Stabiliteit bij lange antwoorden	Goed	Traag maar stabiel	Breekt soms af; in één bericht werken
Model	Zelf kiezen	Vast	Flash, Thinking of Pro

---

Maak hem van jou

Aanpassing	Waar	Moeilijkheid	Wat je ervoor terugkrijgt
Het echte rooster van een klas	Stap 1, Knowledge (txt)	makkelijk	Een planner die klaar is voor de komende toetsweek
Je eigen planregels	Stap 1, kop Planregels	makkelijk	Een plan dat past bij jullie studielessen
Alleen de tabel, geen overzicht per dag	Stap 1, "Wat je oplevert"	makkelijk	Kortere antwoorden, minder kans op afbreken
Zelfcontrole op de regels	Stap 1, "Wat je oplevert"	gemiddeld	Minder fouten om zelf te vinden
Een vraag extra ("welke dag wil je vrijhouden?")	Stap 1, "Wat je nodig hebt"	gemiddeld	Ruimte voor sport of bijbaan
Agenda-afspraken in Google Agenda	Niet in een Gem	moeilijk	Exporteer naar Spreadsheets en importeer daar als csv in Agenda; of de Dify-versie met ics

Drie opdrachten

1. Jouw regels. Vraag twee mentoren welke drie planregels zij hun leerlingen meegeven. Zet die in de instructie en voer dezelfde test uit. Welk plan zou een leerling echt volgen?
2. Vind de fout. Loop het plan regel voor regel na en leg de Gem de fouten voor, zoals in stap 3. Dat is de kern van werken met agents: jij blijft de controleur.
3. Csv tegen txt. Zet het csv-bestand terug in Knowledge en voer de test in drie berichten uit. Kijk wat er gebeurt en wanneer. Zet daarna het txt-bestand terug.

Checklist voordat je eigen materiaal gebruikt

• Het rooster is een tekstbestand zonder namen of klassenlijsten
• De regel "geen cijfers, oordelen of voorspellingen" staat erin en je hebt hem getest
• Je hebt de leerlingen verteld: alles in één bericht, en bij "Try again" niet schrikken
• Iemand heeft een handvol plannen aan de regels getoetst
• Bij leerlingen: de beheerder heeft Gemini voor leerlingen aangezet en de privacyfunctionaris weet ervan
• Er is een eigenaar die het rooster elke toetsweek vervangt en op Update klikt

---

En verder

Handleiding 4 laat de docent een lesbrief plakken en een Gem beoordelen op toegankelijkheid. Daar komt het lange antwoord terug, en de oplossing: in porties.