Guido van Dijk
90 lines
5.6 KiB
Markdown
90 lines
5.6 KiB
Markdown
# Copilot-handleidingen
|
|
|
|
Stap-voor-stap handleidingen voor het bouwen van AI-agents in Microsoft 365 Copilot (de Agent
|
|
Builder) voor het onderwijs. De tegenhanger van de Dify-handleidingen: dezelfde fictieve school,
|
|
dezelfde voorbeelden, maar gebouwd in de omgeving die de meeste scholen al hebben. Gemaakt door
|
|
LeX Consultancy B.V. Alle voorbeelden spelen op Het Voorbeeldcollege (fictief); schermen vastgelegd
|
|
in Microsoft 365 Copilot Chat op 21 september 2026, in een werkaccount zonder de betaalde
|
|
Microsoft 365 Copilot-licentie.
|
|
|
|
Licentie: CC BY-SA 4.0 (documenten en beelden) en MIT (scripts), zie LICENSE.md.
|
|
Eigenaar en contact: Guido van Dijk, guido@l-e-x.nl, guido@ai-netwerk-limburg.nl.
|
|
|
|
## Inhoud
|
|
|
|
| Map | Titel | Voor wie | Omvang |
|
|
| --- | --- | --- | --- |
|
|
| 01-schoolgids-assistent | Bouwen in Microsoft 365 Copilot: de Schoolgids-assistent (agent die uit een document voorleest, met de kennis in de instructie) | Beginners | 20 pp. |
|
|
| 02-ouderbrief-assistent | Bouwen in Microsoft 365 Copilot: de Ouderbrief-assistent (agent die de schrijfwijzer toepast op een brief, en berichten maakt voor ouderapp en website) | Mentoren, teams communicatie | 13 pp. |
|
|
| 03-toetsweekplanner | Bouwen in Microsoft 365 Copilot: de Toetsweekplanner (agent die vragen stelt, plant en een Excel-bestand maakt) | Mentoren, Experimenteerruimte | 15 pp. |
|
|
|
|
Elke handleiding heeft een ingevulde ontwerpkaart, groene kaders "Zelf kiezen", een hoofdstuk
|
|
"Maak hem van jou" met aanpassingen, opdrachten en een checklist, en een vergelijking met de
|
|
Dify-versie van dezelfde app.
|
|
|
|
## Waarvoor is welke agent
|
|
|
|
| Agent | Wat hij doet | Voor wie | Patroon |
|
|
| --- | --- | --- | --- |
|
|
| Schoolgids-assistent (01) | Beantwoordt vragen over de schoolregels uit de schoolgids, met hoofdstukverwijzing; verwijst door als het antwoord er niet in staat | Collega's, leerlingen met schoolaccount | Kennis in de instructie |
|
|
| Ouderbrief-assistent (02) | Herschrijft een conceptbrief volgens de schrijfwijzer (B1, u, opbouw, lengte) en maakt er berichten voor ouderapp, website of sociale media van | Mentoren, teamleiders, team communicatie | Regels toepassen op een tekst |
|
|
| Toetsweekplanner (03) | Vraagt leermomenten en moeilijkheid, verdeelt de toetsstof over de dagen volgens vijf planregels en levert een Excel-bestand op OneDrive | Mentoren, leerlingen met schoolaccount | Vragen, rekenen, bestand maken |
|
|
|
|
## Wat je nodig hebt
|
|
|
|
- Een werkaccount van school met Microsoft 365 en toegang tot Copilot Chat (m365.cloud.microsoft).
|
|
- In het linkermenu van Copilot het kopje **Agents** met **Nieuwe agent**. Ontbreekt dat, dan heeft
|
|
de beheerder het maken van agents uitgezet.
|
|
- Geen betaalde Microsoft 365 Copilot-licentie. Alles in deze reeks werkt in de gratis laag
|
|
(Copilot Chat); waar de betaalde licentie iets toevoegt (bestanden en SharePoint als kennis),
|
|
staat dat in een groen kader. Zie de tabel hieronder.
|
|
|
|
## Gratis laag: wat kan wel en wat niet
|
|
|
|
Dit is het belangrijkste om te weten voordat je begint. De drie agents in deze reeks zijn bewust
|
|
zo ontworpen dat ze werken met wat elke school al heeft: Copilot Chat bij een gewone
|
|
Microsoft 365-licentie. Linksonder in Copilot zie je welke laag je hebt.
|
|
|
|
| Wat je wilt | Copilot Chat (gratis laag) | Microsoft 365 Copilot (betaalde licentie) | Copilot Studio (apart product) |
|
|
| --- | --- | --- | --- |
|
|
| Een agent met instructie en startvragen | Ja | Ja | Ja |
|
|
| Kennis meegeven | In de instructie (maximaal 8.000 tekens) of een openbare website via Bing | Bestanden, SharePoint, OneDrive, Teams-kanalen | Alles, plus databases en externe bronnen |
|
|
| Meerdere lange documenten | Past niet | Ja | Ja |
|
|
| Bestanden maken (Word, Excel, PowerPoint) | Ja | Ja | Ja |
|
|
| Delen met collega's in het tenant | Ja | Ja | Ja |
|
|
| Agent in Teams of Outlook | Nee | Ja | Ja |
|
|
| Acties in andere systemen (formulier, ticket, leerlingvolgsysteem) | Nee | Beperkt | Ja |
|
|
| Meerstaps-controle, mens in de lus | Nee | Nee | Deels |
|
|
| Ouders zonder schoolaccount | Nee | Nee | Ja, via een website |
|
|
| Gesprekken teruglezen | Alleen tellingen | Tellingen | Transcripten |
|
|
| Kosten | In de licentie die je al hebt | Per gebruiker per maand | Per bericht |
|
|
|
|
Wat de gratis laag dus goed kan: alles wat in een instructie past, met tekst erin en tekst of een
|
|
bestand eruit. Dat is meer dan het lijkt: de drie agents hier, en met dezelfde aanpak ook een
|
|
lesmateriaal-check, een studiecoach met de lesbrief in de instructie, of een notulen-assistent
|
|
die een geplakt transcript samenvat. Wat niet kan zonder Copilot Studio of Dify: audio omzetten,
|
|
eigen zoektools naar externe API's, meerstaps-flows met een poortwachter, en een docent die via
|
|
e-mail meebeslist. Daarvoor staan handleidingen 5 tot en met 8 in de Dify-reeks.
|
|
|
|
## De agents zelf bouwen
|
|
|
|
Er is geen exportbestand zoals bij Dify: een Copilot-agent bestaat uit een naam, een beschrijving,
|
|
een instructie en drie startvragen. Elke map bevat `instructies.txt` met de volledige instructie
|
|
om te plakken; de rest staat in de handleiding. Vijf minuten per agent.
|
|
|
|
## Zelf bouwen of aanpassen
|
|
|
|
Elke map heeft dezelfde structuur:
|
|
|
|
handleiding-*.md bron (dit bewerk je)
|
|
handleiding-*.pdf gebouwde uitvoer (staat in git)
|
|
beelden/ schermafbeeldingen
|
|
instructies.txt de instructie van de agent
|
|
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`.
|
|
|
|
De Dify-reeks staat op https://git.lexconsultancy.nl/guido/dify-handleidingen (Nederlands) en
|
|
https://git.lexconsultancy.nl/guido/dify-guides (Engels).
|