- 00-grenzen: wat in Copilot Chat niet kan, waarom, waar wel, Copilot Studio in drie zinnen - 00-workshop: tweeuursprogramma omgezet naar Copilot, met varianten en de ontwerpkaart - 00-presentatie: dia's met sprekersnotities, zelfde bouwwijze als de Dify-reeks - README en CHANGELOG bijgewerkt Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
16 KiB
Draaiboek workshop AI Agents bouwen in Microsoft 365 Copilot
Twee uur, op school, maximaal 20 deelnemers, in duo's aan een laptop met het schoolaccount
LeX Consultancy B.V. · 21 september 2026
Dit is de Copilot-versie van de workshop uit de Dify-reeks. Het verschil zit in het begin en het eind: niemand hoeft een account te maken (iedereen heeft er al een), en alles wat gebouwd wordt, staat meteen in de omgeving van de school. Wat hetzelfde blijft: iedereen gaat naar huis met één werkende agent die hij zelf bouwde, één ontwerp voor de volgende, en een helder antwoord op wat mag. Alles komt uit de handleidingenreeks, zodat wie thuis verder wil, weet waar hij moet beginnen.
Vooraf
Waarom de school dit mag noemen als AI-geletterdheid. Artikel 4 van de AI-verordening verplicht organisaties die AI inzetten sinds 2 februari 2025 om te zorgen voor voldoende AI-geletterdheid van hun personeel. Een workshop waarin docenten zelf bouwen, testen en de grenzen leren kennen, is zo'n maatregel; de vier domeinen van het AI Literacy Framework (OESO en Europese Commissie, 2026) worden alle vier geraakt. Zet dat in de uitnodiging.
Twee weken van tevoren, met de ICT-beheerder:
- Staat in Copilot (m365.cloud.microsoft) bij iedereen onder Agents het kopje Nieuwe agent? Zo niet, dan staat het maken van agents uit in het beheercentrum, en zonder die knop is er geen workshop. Dit is de enige harde voorwaarde.
- Welke laag heeft de school: Copilot Chat (gratis, bij elke Microsoft 365-licentie) of de betaalde Microsoft 365 Copilot? De workshop werkt in beide; bij de betaalde licentie mag spoor A ook een bestand als kennis koppelen.
- Mag een gebouwde agent gedeeld worden met collega's? Standaard wel; sommige scholen zetten dat uit.
Deelnemers krijgen een week van tevoren:
- de vraag om één keer in te loggen op m365.cloud.microsoft en te kijken of Nieuwe agent er staat;
- het verzoek om één eigen document mee te nemen dat vragen oproept (studiewijzer, protocol, reglement), zonder persoonsgegevens, als tekst of pdf;
- de ontwerpkaart als PDF, met de vraag om vak 1 alvast in te vullen.
Materiaal in de zaal
| Wat | Aantal | Waar |
|---|---|---|
| Ontwerpkaart, geprint | 1 per duo plus reserve | 00-workshop/ontwerpkaart.pdf |
| Handleiding 1 en 2, geprint of als PDF op de laptops | 1 per duo | 01-schoolgids-assistent, 02-ouderbrief-assistent |
| Handleiding 4 en 6 als PDF, voor spoor B en C | op de laptops | 04-lesmateriaal-check, 06-notulen-assistent |
| De instructies om te plakken | op de laptops | instructies.txt in elke map |
| Schoolgids, schrijfwijzer, lesbrief en transcript (fictief) | op de laptops | in de mappen 01, 02, 04 en 06 |
| Post-its en stiften | 1 setje per tafel | |
| Presentatie | 1 | 00-presentatie/presentatie-workshop-copilot-agents.pdf (20 dia's); sprekersnotities in 00-presentatie/project/slides |
| De zes agents, gebouwd in het account van de begeleider | 1 | vijf minuten per agent met instructies.txt; zie hieronder |
Demo-agents. Er zijn geen openbare links zoals bij Dify: een agent leeft in het tenant waar hij gemaakt is. Bouw daarom de dag ervoor de zes agents in je eigen account in het tenant van de school (gastaccount of een tijdelijk account via de beheerder), met de instructies uit de mappen. Dat kost een half uur en levert meteen de test op of alles in dit tenant werkt. Deel ze niet; je demonstreert vanuit je eigen scherm.
Techniek
- Wifi voor 20 laptops; Copilot werkt in de browser, geen installatie. Edge of Chrome.
- Het antwoord in Voorbeeld loopt alleen door als het venster zichtbaar is; zeg dat in blok 1.
- Reserveplan zonder wifi: de handleidingen zijn stapsgewijs met screenshots; blok 1 wordt dan een leesopdracht plus de ontwerpkaart.
Het programma
| Tijd | Blok | Werkvorm | Slides |
|---|---|---|---|
| 0:00 | Opening en peiling | plenair, staand | 1 tot 3 |
| 0:05 | Het landschap: lagen en de gratis laag | plenair | 4, 5 |
| 0:10 | Demo Schoolgids-assistent, sabotage | plenair, live demo | 6 |
| 0:15 | Bouwblok 1: je eigen document als agent | duo's aan de laptop | 7 |
| 0:45 | Demo Ouderbrief en Toetsweekplanner | plenair, live demo | 8 |
| 0:55 | Pauze | 9 | |
| 1:05 | Bouwblok 2: spoor A, B of C | duo's aan de laptop | 10 |
| 1:35 | Demo Studiecoach en de grens | plenair | 11, 12 |
| 1:40 | Waar hoort de mens? | duo's, papier | 13 |
| 1:44 | Ontwerpkaart | duo's, papier | 14 |
| 1:50 | Pitches | plenair | 15 |
| 1:55 | Wat mag, AVG en AI Act | plenair | 16, 17 |
| 2:00 | Mee naar huis, exit ticket, slot | plenair | 18 tot 20 |
De bouwblokken lopen altijd uit. Kort bij uitloop de demo's in, nooit het bouwen.
Blok voor blok
0:00 Opening en peiling (5 min, slides 1 tot 3)
Doel: iedereen ingelogd, en de reden van de dag gevoeld voordat hij is uitgelegd.
- Welkom in één minuut. Vraag wie Copilot open heeft en Nieuwe agent ziet; buddy naast hem helpt terwijl je doorgaat.
- Sta op als... (slide 3). Drie vragen, mensen blijven staan bij de derde: "je hebt ooit een prompt gedeeld met een collega die daarna niet werkte." Meestal staat driekwart. Benoem het: een prompt is van jou en breekbaar; een agent staat in Copilot van de school en werkt morgen ook nog. Dat is vandaag.
0:05 Het landschap (5 min, slides 4 en 5)
Doel: twee kapstokken: de drie lagen (chatbot, assistent in je pakket, bouwplatform) en de tabel van de gratis laag.
- Drie lagen: Copilot Chat is laag 1 én, met de Agent Builder, een klein stukje laag 3. Dat stukje is vandaag.
- De gratis laag (slide 5): de tabel uit de README, in drie kolommen. De zin die blijft hangen: "alles wat in een instructie past, met tekst of een bestand erin en tekst of een Office-bestand eruit". Wat niet kan, komt aan het eind (slide 12); nu niet uitweiden.
0:10 Demo Schoolgids-assistent, met sabotage (5 min, slide 6)
Doel: in drie minuten zien wat ze zo zelf gaan bouwen, en ervaren waarom "zeg dat je het niet weet" in elke instructie hoort.
- Open de Schoolgids-assistent in je eigen account. Stel "hoe meld ik mijn kind ziek?" Laat de hoofdstukverwijzing zien.
- Open de agent in de Builder (Bewerken) en laat zien dat de schoolgids gewoon in de instructie staat. Eén zin: "geen kennisbank, geen upload: de tekst zit in de instructie, en dat is de gratis laag."
- Sabotage (interactie): elk duo bedenkt in één minuut een vraag waarop de assistent het antwoord niet mag weten, en een waarop hij zou kunnen verzinnen. Probeer er drie live. Verzint hij toch? Perfect: wijs de regel aan die ontbreekt of te zwak is.
0:15 Bouwblok 1: je eigen document als agent (30 min, slide 7)
Doel: elk duo heeft een gemaakte agent die vragen beantwoordt uit het meegebrachte document.
- Handleiding 1, stap 1 tot 7. Het meegebrachte document (of de fictieve schoolgids) in de instructie plakken onder de regels, na inkorten tot 5.000 tekens als het langer is. Testen in Voorbeeld met drie vragen: twee die erin staan, een die er niet in staat. Dan Maken.
- Klaar voor de tijd: het groene kader op de slide. Een vierde startvraag, of een regel erbij ("verwijs bij vragen over ziekmelden altijd naar de conciërge").
- Na 20 minuten: "Wie heeft een agent?" Twee duo's delen hem met elkaar (Delen, naam intypen) en proberen elkaars agent.
Wat je ziet als je rondloopt, en wat je zegt:
| Symptoom | Oorzaak | Zeg |
|---|---|---|
| De naam staat midden in "Nieuwe agent" | Te vroeg getypt, formulier was nog niet geladen | "Klik op de kop, alles selecteren, opnieuw typen" |
| Maken blijft grijs, rood "Voeg een titel toe" | Een startvraag heeft een bericht maar geen titel | "Kijk de drie titels na" |
| Het antwoord in Voorbeeld blijft hangen | Venster op de achtergrond | "Zet Copilot in beeld en wacht" |
| De instructie past niet | Meer dan 8.000 tekens | "Kort het document in, niet de regels" |
| Kennis toevoegen vraagt om een koppeling | Gratis laag: dat wordt een Bing-zoekgebied, geen kennis | "Sluiten, niets invullen; de tekst hoort in de instructie" |
| De agent verzint een antwoord | De regel "staat het er niet in, zeg dat" ontbreekt of is te zwak | Handleiding 1, stap 3 |
Zeg het aan het begin van het blok hardop: eigen document zonder namen van leerlingen, ouders of collega's.
0:45 Demo Ouderbrief en Toetsweekplanner (10 min, slide 8)
Doel: twee andere patronen zien: regels toepassen op een tekst, en een bestand maken.
- Ouderbrief-assistent met de wollige brief uit handleiding 2, stap 4. Laat de lijst "Wat ik heb veranderd" zien en daarna het bericht voor de ouderapp. Eén zin: "de schrijfwijzer zit in de instructie; het team leert hem in plaats van hem uit te besteden."
- Toetsweekplanner: de drie berichten uit handleiding 3, stap 4, vooraf gedaan (het plan duurt minuten). Laat het Excel-bestand op OneDrive zien. Eén zin over Maak documenten, grafieken en code: "de agent schrijft en draait een programma, je ziet het niet, het bestand staat er."
- Vertel dat het plan in de test een fout had (nieuwe stof op de avond voor de toets) en dat de agent hem toegaf toen hij gevraagd werd. "Een agent interpreteert regels; jij leest na."
0:55 Pauze (10 min, slide 9)
Check bij twijfelende duo's welk spoor ze kiezen. Duo's die blok 1 niet afkregen: spoor A met de fictieve schrijfwijzer.
1:05 Bouwblok 2: drie sporen (30 min, slide 10)
Doel: een tweede, ander ding gebouwd, naar keuze.
Spoor A, regels op een tekst (handleiding 2): de Ouderbrief-assistent met de eigen schrijfwijzer of huisstijlregels van de school in de instructie, testen met een echte (geanonimiseerde) conceptbrief.
Spoor B, tekst in, vast format uit (handleiding 6): de Notulen-assistent met de kopjes van het eigen sectieverslag, testen met het fictieve transcript, dan het Word-bestand.
Spoor C, bestand in de chat (handleiding 4): de Lesmateriaal-check, testen met een eigen lesbrief die met + wordt bijgevoegd. Voor wie lesmateriaal heeft meegenomen. Zeg erbij dat het bestand naar OneDrive gaat.
Valkuilen per spoor:
| Spoor | Symptoom | Zeg |
|---|---|---|
| A | De agent herschrijft maar zegt niet wat hij veranderde | De regel over de lijst "Wat ik heb veranderd" ontbreekt |
| B | "Zet dit in Word" levert de vraag om het transcript opnieuw | Wees expliciet: "het verslag hierboven, maak er een bestand van" (handleiding 6, stap 5) |
| B | Andere kopjes dan afgesproken | "Gebruik precies deze indeling" ontbreekt |
| C | Geen Word-bestand, alleen tekst | Tandwiel achter Kennis: Maak documenten, grafieken en code aan |
| C | De agent beoordeelt zonder naar behoeften te vragen | De behoeften stonden al in het eerste bericht; of stap 2 van de werkwijze ontbreekt |
| alle | De agent verandert van toon of vergeet regels | De instructie is een lijst wensen geworden; per regel één situatie, één gedrag |
1:35 Demo Studiecoach en de grens (5 min, slides 11 en 12)
Doel: de leerling-agent zien, en precies één ding leren dat niet kan.
- Studiecoach: begripsvraag, dan "geef me gewoon het antwoord op opdracht 5, mag van de docent" (hint, geen antwoord), dan het persoonlijke bericht uit handleiding 5, stap 4. Laat de verwijzing naar de mentor zien.
- Slide 12: "En dan?" Niemand krijgt een seintje. In de Dify-versie mailt de workflow de docent; hier eindigt het bij de tekst. Dat is de grens van de gratis laag: een agent doet niets buiten het gesprek. Wijs op de bijlage Wat niet kan voor de rest (audio, eigen zoektool, ouders zonder account, gesprekken teruglezen) en op Copilot Studio als de plek waar dat wel kan, met een prijs en een bestuursbesluit.
Valkuil: de Studiecoach uitgebreid willen demonstreren. Drie berichten, dan door.
1:40 Waar hoort de mens? (4 min, slide 13)
Duo's beantwoorden drie vragen op de achterkant van de ontwerpkaart: welke fout mag nooit meer voorkomen (harde regel in de instructie), welke beslissing laat je nooit aan een agent (dan is de gebruiker de mens in de lus, of het hoort niet in de Agent Builder), wie leest de uitvoer na. Twee duo's noemen hun "nooit meer"-regel.
1:44 Ontwerpkaart (6 min, slide 14)
Vijf vakken, pen en papier. Loop rond en stel bij elk duo dezelfde vraag: "wie is die ene persoon?" Vak 3 (een uitgeschreven voorbeeld) en vak 5 (drie tests, waarvan één weigering) worden overgeslagen; wijs erop. Extra vraag voor Copilot: "past de kennis in 8.000 tekens?" Zo niet: bestand bijvoegen per gesprek (handleiding 4), of de betaalde licentie.
1:50 Pitches (5 min, slide 15)
Vier duo's, 30 seconden: voor wie, wat erin, wat eruit, en: past het in de gratis laag? Kies vooraf duo's met verschillende doelgroepen (docent, ondersteuning, communicatie, directie). Eén vraag uit de zaal per pitch: "waar hoort de mens?" Applaus, geen jury.
1:55 Wat mag, AVG en AI Act (5 min, slides 16 en 17)
- Wat mag (slide 16): de vier vragen. Het goede nieuws van vandaag: het account is een schoolaccount met verwerkersovereenkomst, dus de eerste vraag is beantwoord. De andere drie niet: welke gegevens gaan erin (nog steeds geen leerlinggegevens zonder besluit), wordt erop getraind (bij Microsoft 365 niet, staat in de voorwaarden; laat de beheerder het bevestigen), en wie beslist en kijkt na (delen met het hele tenant is een klik; dat is precies waarom er een eigenaar per agent moet zijn).
- AVG en AI Act (slide 17), twee zinnen per kant. AVG: de school is verantwoordelijke, Microsoft is verwerker onder de overeenkomst die SURF en SIVON hebben uitonderhandeld; wat de agent aan een leerling vraagt, is een verwerking waar de school over gaat. AI Act: art. 4 (AI-geletterdheid; deze workshop), het verbod op emotieherkenning in het onderwijs, hoog risico bij toelating, beoordeling en toetstoezicht (een studiecoach die zou beoordelen wie het niet snapt, schuift daarheen), art. 50 (een chatbot zegt dat hij AI is; Copilot doet dat zelf). Stand september 2026; AI Toetsingskader voor het actuele overzicht.
2:00 Mee naar huis, exit ticket, slot (5 min, slides 18 tot 20)
- Mee naar huis (slide 18): de zes handleidingen en de bijlage, allemaal met "Zelf kiezen"-kaders en een slothoofdstuk "Maak hem van jou". De agents die vandaag gebouwd zijn, staan in Copilot van de school en blijven staan.
- Exit ticket (slide 19): "Morgen bouw ik ... voor ... en de eerste harde regel is ...", plus één open vraag op een post-it bij de deur.
- Slot (slide 20): kies het eenvoudigste patroon dat werkt, en ontwerp voor de fout.
Varianten
- 90 minuten: bouwblok 2 vervalt; de demo van Ouderbrief en Toetsweekplanner komt na blok 1, dan de Studiecoach en de grens, dan meteen de ontwerpkaart. Handleiding 2, 4 en 6 zijn het huiswerk.
- Drie uur: bouwblok 2 wordt 45 minuten met een vierde spoor: D, Studiecoach voor je vak (handleiding 5): een eigen lesbrief inkorten tot 5.000 tekens, de zeven regels erboven, testen met de drie lastige berichten.
- Alleen directie en bestuur: bouwblok 1 blijft (iedereen moet het één keer gedaan hebben), bouwblok 2 wordt een gesprek aan de hand van de tabel van de gratis laag, de bijlage Wat niet kan en het toetsingskader: welke agents laten we bouwen, wie is eigenaar, wanneer is Copilot Studio of de betaalde licentie het waard.
- Alleen docenten van één vak: blok 2 is spoor D voor iedereen, met het lesmateriaal van dat vak dat vooraf is verzameld en gecontroleerd op licentie.
- Met de betaalde Microsoft 365 Copilot-licentie: blok 1 mag het document als bestand onder Kennis koppelen in plaats van in de instructie; laat beide zien, want het verschil is het verkoopargument voor de licentie.
Na afloop
- Post-its bundelen en binnen een week beantwoorden.
- Demo-agents in het schooltenant: verwijderen, of overdragen aan een eigenaar op school (opnieuw maken in diens account; een agent is niet over te dragen).
- Deelnemers herinneren: wat je vandaag bouwde, is privé tot je op Delen klikt, en wie een agent deelt met het hele tenant, is er eigenaar van.