# 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.

## 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).