Copilot Studio Guide

Wat is Copilot Studio?

Microsoft Copilot Studio is het Low-Code-platform van Microsoft voor het bouwen van Custom Copilots en AI-agents op basis van het Power Platform. Je ontwerpt er conversationele en autonome agents, van eenvoudige FAQ-bots tot agents die zelfstandig afspraken plannen, tickets verwerken of documenten bewerken.

Technisch zit Studio in de Power Platform-stack, naast Power Apps en Power Automate. Het maakt gebruik van 1.400+ connectors, Dataverse, Microsoft 365 Graph en sinds 2025 van MCP-servers. Studio is de directe tegenhanger van LangDock Workflows of Zapier met LLM's, maar dan diep geïntegreerd in de Microsoft-tenant.

Uitlevering gebeurt in Teams, Microsoft 365 Copilot Chat, op het web, in Power Apps, in eigen kanalen via de Direct Line API of als Voice Agent in Dynamics 365 Contact Center.

Licentieroutes (stand augustus 2026)

Microsoft heeft in september 2025 het oude "per bericht"-model vervangen door een Credit-model:

Credits worden tenant-breed gepoold, niet per gebruiker. Een eenvoudige scripted FAQ-bot kost ongeveer 1 Credit per conversatie ($0,01). Een agent met Generative Orchestration, Tenant Grounding en Deep Reasoning kan $0,25 tot $2,00 of meer per conversatie kosten.

Voor Power Automate-flows als Tools geldt: klassieke Cloud-flows blijven Power Automate-licenties nodig hebben. Agent Flows (in Studio gebouwde flows) worden volledig via Copilot Credits afgerekend, dus geen apart PA-gebruikersplan nodig.

Microsoft biedt sinds april 2026 een Agent Usage Estimator (microsoft.github.io/copilot-studio-estimator) voor Credit-prognoses op basis van agent-type, verkeer, orchestration, Knowledge en Tools. Gebruik die voor elke pilot.

Platforms en kanalen

• Web Studio (copilotstudio.microsoft.com), authoring
• Microsoft Teams (persoonlijke chat, met toolkit ook kanalen en groepschats)
• Microsoft 365 Copilot Chat (M365 Copilot-app)
• Web Chat / Custom Web (React Web Chat of WebChat JS)
• Direct Line API voor eigen apps en kanalen
• SharePoint (ingebed op pagina's)
• Power Apps (als agent-component)
• Power Pages (publieke sites)
• Voice Channel in Dynamics 365 Contact Center (IVR, Real-time Voice Agents)
• Facebook, Slack en meer via Azure Bot Service Adapter

Feature-tijdlijn 2025/2026

Wanneer loont Copilot Studio?

Loont, als:

• Je diep in M365, Teams, SharePoint of Dataverse zit en Azure AD-login met permissions wilt "erven".
• Je autonome agents nodig hebt op SharePoint-, Outlook- of Forms-events (bijvoorbeeld "auto-triage van nieuwe tickets").
• Je een conversationele UI in Teams wilt in plaats van CLI of custom web-app.
• Je compliance en audit via Microsoft Purview nodig hebt (bijvoorbeeld AVG- of AZAV-context).
• Je Voice-IVR in een Dynamics 365 Contact Center nodig hebt.
• Je bestaande Power Automate-flows als Tools wilt blijven gebruiken.

Loont NIET als vervanging voor:

• Puur API-orkestreren zonder conversatie. Daar volstaat Power Automate (Cloud Flow) of Logic Apps.
• Maximale LLM-controle over prompts, modellen, providers. Daar ben je beter af in Azure AI Foundry, LangDock of direct met OpenAI/Anthropic.
• Self-hosted of on-prem LLM's. Studio is cloud-only.
• Een volwaardig customer service-platform. Studio is alleen de bot-frontend. De human handoff, ticketing en routing komt van Dynamics 365 Customer Service (of een derde systeem via Generic Handoff).
• Pixel-perfect web-UI's. Adaptive Cards zijn de grens. Alles daarboven is Power Apps of Custom Web.

Het conceptmodel

Een Studio-agent is de top-level-eenheid. Hij bestaat uit Persona, Instructions, Topics, Tools, Knowledge en Channels, en leeft in een Power Platform-environment met eigen DLP- en audit-configuratie.

                ┌──────────────────────────────────────┐
                │           AGENT (= "Copilot")        │
                │                                      │
                │  ┌─────────────┐   ┌──────────────┐  │
                │  │ INSTRUCTIONS│   │ ORCHESTRATION│  │
                │  │  (System    │   │  (Classic vs │  │
                │  │   Prompt)   │   │  Generative) │  │
                │  └─────────────┘   └──────────────┘  │
                │                                      │
                │  ┌──────────┐ ┌──────────┐ ┌──────┐  │
                │  │  TOPICS  │ │  TOOLS / │ │KNOW- │  │
                │  │ (Dialog) │ │ ACTIONS  │ │LEDGE │  │
                │  └──────────┘ └──────────┘ └──────┘  │
                │       │           │           │      │
                │       ▼           ▼           ▼      │
                │   Nodes:      Connector    Web/SP/   │
                │   - Message   Action       Dataverse/│
                │   - Question  PA-Flow      Files/    │
                │   - Condition Agent-Flow   Graph/    │
                │   - Variable  Prompt       MCP/      │
                │   - Action    REST/HTTP    Azure AI  │
                │   - Adaptive  MCP-Tool      Search   │
                │     Card                             │
                │                                      │
                │  ┌──────────────┐  ┌──────────────┐  │
                │  │   TRIGGERS   │  │  CHANNELS    │  │
                │  │ user / event │  │ Teams / Web /│  │
                │  │ /schedule    │  │ Voice / ...  │  │
                │  └──────────────┘  └──────────────┘  │
                └──────────────────────────────────────┘
                              │
                              ▼
                    ┌────────────────────┐
                    │ POWER PLATFORM ENV │
                    │ (DLP, Solutions,   │
                    │  Audit via Purview)│
                    └────────────────────┘

Wat je in Copilot Studio bouwt

Microsoft heeft het productoverzicht in september 2026 opnieuw ingedeeld en benoemt sindsdien uitdrukkelijk meerdere bouwstenen die je los gebruikt of tot een doorlopende oplossing combineert. Een workflow mag bijvoorbeeld een agent aanroepen voor één stap. Voor de projectpraktijk is dat meer dan cosmetica: wie "Copilot Studio" in een klantworkshop nog steeds vertaalt met "chatbot-bouwdoos", verkoopt het platform sinds deze indeling onder de waarde.

Apps als nieuwe bouwsteen (Public Preview sinds september 2026)

Op 10 september 2026 heeft Microsoft aangekondigd dat je in Copilot Studio niet langer alleen agents en workflows bouwt, maar ook apps. Je beschrijft het bedrijfsresultaat, de gebruikersgroep, de data en de gewenste acties in natuurlijke taal, itereert in het gesprek, ziet een preview en publiceert pas daarna. Wie dieper wil ingrijpen, kan de gegenereerde code inzien.

Technisch zijn dat volgens Microsoft full-stack apps op open standaarden, geen canvas apps in de klassieke Power Apps-zin. Ze ondersteunen Git-gebaseerd versiebeheer, deployment stages en version isolation, zodat teams aan de volgende versie kunnen doorbouwen zonder de lopende te verstoren. Identiteit via Microsoft Entra en organisatie- en connector-policies gelden standaard. Bedrijfsdata wordt gekoppeld via connectors en Work IQ.

Voor de IT-kant: gepubliceerde apps verschijnen als inventaris met operationele sturing in het Microsoft 365 Admin Center. Gebruikers vinden vrijgegeven, bedrijfswaardige apps onder managedapps.cloud.microsoft.com.

Copilot Managed Runtime: waar de apps draaien (public preview sinds 25 september 2026)

Sinds 25 september 2026 heeft de infrastructuur onder de apps een naam: Copilot Managed Runtime (in de Licensing Guide voorheen "Microsoft-managed host"). Het is gestart als public preview en host apps uit Copilot Studio, Copilot Cowork en de CLI; via de Copilot Managed Runtime SDK kunnen ook apps uit tools van derden zoals GitHub Copilot of Claude Code in je eigen tenant draaien. Elke app krijgt Entra-authenticatie, toegang tot meer dan 1.500 connectors en een Git-repository, en erft automatisch Conditional Access, DLP, advanced connector policies en deellimieten. Gegevenstoegang loopt altijd via de identiteit van de aangemelde gebruiker.

Voor admins: het maken van apps in Copilot Studio staat standaard aan. Je beheert dit in het Microsoft 365-beheercentrum onder Apps > Overview > Set up app creation spaces (of via PowerShell met de tenantinstelling enableManagedAppsMcsPreview), en je kunt het met een beveiligingsgroep beperken tot geselecteerde makers. Het CLI-pad staat standaard uit, Cowork hangt af van de Frontier-onboarding. Global admins en Power Platform-admins mogen dit beheren.

Begrippenkader

Een Studio-agent kan op twee fundamenteel verschillende manieren starten:

• (a) Een gebruiker stelt een vraag of stuurt een bericht, de agent matcht een Topic.
• (b) Ergens gebeurt een event, de agent start autonoom (geen gebruiker in de loop).

Gebruikersgeïnitieerde triggers

Autonome triggers en event-triggers (sinds 2025 GA)

Voorwaarde: Generative Orchestration moet actief zijn op de agent. Anders toont de UI de event-triggers niet.

Wat event-triggers kosten, vereisen en stilzwijgend meebrengen

Microsoft heeft de trigger-documentatie in september 2026 flink uitgebreid. Vier punten daaruit bepalen in projecten vaker succes of ergernis dan de vraag welke connector je kiest:

• Elke payload is een message. Microsoft telt elke trigger-payload als een bericht aan de agent – ook als niemand met hem praat. Het voorbeeld in de documentatie is ondubbelzinnig: een recurrence-trigger op een ritme van 10 minuten stuurt elke 10 minuten een payload en verbruikt dienovereenkomstig. Een autonome agent die in de leegloop "even kijkt of er iets is", wordt zo snel de duurste agent in de tenant.
• Minder dan 15 actions of topics achter elkaar. Microsoft raadt uitdrukkelijk aan minder dan 15 actions of topics achter elkaar aan te roepen: complexe agents die veel stappen als één sequentie draaien, lopen onbetrouwbaar. Ligt je blueprint daarboven, splits hem dan in Agent Flows of child agents in plaats van aan de instructions te sleutelen.
• Triggers draaien altijd op maker-credentials. Event-triggers kunnen uitsluitend de inloggegevens van de agent-auteur gebruiken, en voor een autonome run moet ook elke geauthenticeerde action daarover lopen. Gebruikers van een gepubliceerde agent kunnen daarmee bij data en systemen komen die met de rechten van de maker worden geopend. Copilot Studio toont hierover vóór het publiceren een waarschuwing – dat is geen formaliteit, maar de kernvraag van de vrijgave.
• Zonder solution-aware cloud flow sharing zijn er helemaal geen triggers. Makers kunnen event-triggers alleen aanmaken in environments waar deze instelling aanstaat. Lukt het niet een trigger toe te voegen terwijl de data policies triggers wel toestaan, dan is dat vrijwel altijd de oorzaak. Los daarvan kunnen admins event-triggers via data policy volledig blokkeren voor een environment.

Topics

Een Topic is de kleinste zinvolle "conversatielus". Het heeft (1) een trigger, (2) een reeks Nodes en (3) optioneel input- en output-variabelen.

Topic-typen:

• Custom Topics, zelf gebouwd.
• System Topics, Microsoft-defaults (Greeting, Goodbye, Escalate, Confused, Reset Conversation, On Error, Multiple Topics Matched, ...).
• Generative Answer Topic, fallback die bij geen match Knowledge Sources doorzoekt.

Nodes binnen een Topic

Actions / Tools

Een action is een "werktuig" dat de agent aanroept. Sinds 2025 spreekt Microsoft primair van Tools.

Knowledge Sources

Knowledge is "wat de agent weet", niet "wat de agent doet".

Belangrijk om te weten: Files met sensitivity labels confidential of highly confidential worden wel als "ready" getoond, maar leveren geen antwoorden. Sensitivity labels (MIP) zijn sinds juli 2025 zichtbaar in connectors, Test Chat, Teams en M365 Copilot.

Pagina-precieze citaten voor PDF's

Antwoordt de agent vanuit een PDF, dan verwijst het citaat normaal naar het hele document. Bij een collectieve arbeidsovereenkomst van 200 pagina's helpt dat niemand. Voor één pad wordt het preciezer: PDF's die zijn ingebonden via Bestanden uploaden, SharePoint (dus opgeslagen en geïndexeerd in Dataverse) leveren pagina-precieze citaten. Een klik op de bronvermelding opent de PDF in een nieuw tabblad direct op de geciteerde pagina, en de gebruiker kan het antwoord controleren zonder het document te doorzoeken.

De grenzen daarbij, omdat ze in projecten regelmatig verwarring geven: het geldt alleen voor PDF's, alle andere bestandstypen vallen terug op citaten op documentniveau. Het geldt alleen voor dat ene inbindpad: de volledig geïntegreerde SharePoint Knowledge Source en losse geüploade bestanden citeren nog steeds op documentniveau. En het bestand moet de indexerings-drempel van ongeveer 4 KB halen, kleinere PDF's vallen ook terug. Als pagina-precieze traceerbaarheid een compliance-argument in je project is, bepaalt dus de keuze van het inbindpad of je die krijgt.

Attachments en gegenereerde bestanden (Preview sinds juli 2026)

Sinds juli 2026 kunnen gebruikers bestanden aan een bericht koppelen, en kan de agent tijdens het gesprek zelf bestanden genereren. Beide gelden voor agents op de GitHub Copilot Harness en lopen via Copilot Credits, dus ook bij testen in het Preview-tab.

Het belangrijkste punt eerst, omdat het in projecten regelmatig verward wordt: Een attachment is geen Knowledge Source.

Wat mag worden gekoppeld: afbeeldingen (.png, .jpg, .gif, .webp, de agent gebruikt vision-modellen), PDF's (tekst wordt geëxtraheerd), tekstdocumenten (.txt, .csv, .html, .md) en URL's. Bij een URL downloadt de agent het bestand voor die turn. De download moet binnen 30 seconden klaar zijn en de URL moet publiek bereikbaar zijn. Links achter login of firewall werken niet. Mislukt een bijlage, dan slaat de agent hem over en verwerkt de rest van het bericht. Het bericht gaat toch door.

Gegenereerde bestanden configureer je niet, ze ontstaan als de taak een bestand vraagt: een rapport, een tabel, een grafiek, een codesnippet of de bewerkte versie van een gekoppeld bestand. De agent hangt een Created File Card met bestandsnaam, preview en download-actie onder het antwoord. Gebruikers kunnen er in een volgende turn naar verwijzen ("maak de grafiek hoger"), de agent leest het bestand terug en genereert een nieuwe versie.

Bijlagen leven dus niet alleen voor één turn: binnen de bewaartermijn kan de agent terugvallen op een eerder gestuurd bestand ("vergelijk dat met het bestand van eerder"). Beide functies zijn beschikbaar op alle plekken waar de agent draait: Preview-tab, Microsoft Teams, Microsoft 365 Copilot, Web Chat, mits het kanaal bijlagen ondersteunt.

Variables / Slots

• Topic Variable, alleen in dat Topic zichtbaar. Default voor User.Name-achtige vars.
• Global Variable, overal in de agent, persistent over topic-wissels heen.
• System Variable, beheerd door Studio (bijvoorbeeld System.User.Id, System.Conversation.Id, System.LastMessage, System.Activity.Channel).
• Environment Variable, solution-level, ALM-vriendelijk, bijvoorbeeld API-URL's per environment.

Slot Filling: als de gebruiker de vraag van de agent "proactief" beantwoordt (bijvoorbeeld: gebruiker zegt direct "boek Amsterdam naar Berlijn op vrijdag", de agent extraheert City, City, Date in één keer), spreekt Microsoft van slot filling. Entities (prebuilt of custom) zijn de voorwaarde.

Authenticatie-bouwstenen

• No Authentication, anoniem. Alleen zinvol voor public Web Chat of Power Pages.
• Authenticate manually met Microsoft Entra ID v2, de standaard voor enterprise. Federated credentials aanbevolen (geen opgeslagen client secret).
• Authenticate with Microsoft (SSO), user-token wordt doorgegeven. Tools en knowledge draaien in de context van de gebruiker (permissies erven!).
• Microsoft Entra External ID, voor B2C-scenario's (klantlogin).
• Generic OAuth 2.0, voor eigen identity providers.

Hoe stromen data?

Data stroomt via variabelen tussen Nodes en Topics. Power Fx is de formuletaal.

Ask Question ─► Topic.Name (string)
                │
                ▼
Set Variable   ─► Global.Customer = Topic.Name
                │
                ▼
Condition      ─► If Global.Customer in adminList
                │
                ▼
Call Action    ─► Input: Global.Customer, Output: Action.Result
                │
                ▼
Send Message   ─► "Status: {Action.Result.status}"

Variable scopes

Power Fx in Studio

Power Fx is de Excel-achtige formuletaal van het Power Platform. In Studio gebruik je die voor Set Variable, condition-expressies, string-manipulatie en datum- en getallen-logica.

// Set Variable: brutobedrag berekenen
Set(Topic.Bruto, Topic.Netto * 1.19)

// Condition: gebruiker is admin EN bedrag > 1000
Topic.IsAdmin = true And Topic.Amount > 1000

// String-manipulatie: mail-domein extraheren
Last(Split(System.User.Email, "@"))

// Datum: 7 dagen in de toekomst
DateAdd(Now(), 7, Days)

Valkuil: Power Fx gebruikt US-formatting, komma als parameter-scheider, punt als decimaalteken. Wie uit een Nederlandstalige Excel komt, struikelt hier regelmatig over.

LangDock-modi gemapt

In LangDock kun je velden vullen als auto, manual of AI prompt. Studio mapt dat zo:

De belangrijkste architectuur-switch in Studio: kies je Topics via vastgeschroefde trigger-phrases (Classic) of laat je het LLM kiezen op basis van Topic-descriptions (Generative)?

Vergelijkingstabel

Primair model kiezen – sinds september 2026 twee aparte lijsten: welke modellen je überhaupt ziet, hangt inmiddels af van de harness en niet meer van het product. Microsoft onderhoudt sinds september 2026 twee eigen beschikbaarheidspagina's: een voor de Standard Harness en een voor de GitHub Copilot Harness. De twee rosters overlappen maar deels, en een defaultmodel wijst Microsoft uitsluitend voor de Standard Harness aan. De belangrijkste wijziging in september: GPT-5.5 Chat heeft GPT-4.1 als default vervangen, in alle regio's tegelijk (documentatiestand 18 september 2026).

Een uitgefaseerd model blijft na het retirement nog tot een maand bruikbaar. Externe modellen zijn na admin-vrijgave als primair model toe te voegen, en hier wijken de twee documentatiepagina's van elkaar af: de Standard-Harness-pagina noemt Anthropic, xAI en Mistral, terwijl de pagina van de GitHub Copilot Harness in de lopende tekst alleen nog Anthropic en Mistral voert en xAI uitsluitend in de admin-controls noemt. Wie Grok voor de nieuwe ervaring heeft ingepland, controleert dat beter in de eigen tenant voordat hij het toezegt.

Hoe de modelkeuze hier kwam: sinds okt 2025 kies je in de agent-settings het Generative Orchestration-model. De categorie Auto (dynamisch routeren per conversatiestap tussen snelle en diepe modellen) kwam er in het voorjaar van 2026 bij. GPT-4o werd in oktober 2025 uitgefaseerd, Claude Sonnet 4.5 na afloop van de migratietermijn op 30-06-2026.

Harnesses: de runtime-laag tussen agent en model

Sinds eind juli 2026 documenteert Microsoft een laag die eerder impliciet was: de Harness. Jij bouwt de agent, het model levert reasoning en tekst, en daartussen zit de harness als runtime. Die bepaalt wanneer het model wordt aangeroepen, welke componenten meegaan, hoe het antwoord wordt geïnterpreteerd en welke tools draaien. In de praktijk betekent dat: de harness bepaalt welke features je überhaupt krijgt en hoe er wordt afgerekend. Dat is inmiddels een belangrijkere keuze dan de oude vraag "Classic of Generative Orchestration".

De "nieuwe ervaring" op de Copilot Studio-homepage is precies de omschakelaar tussen GitHub Copilot Harness en Standard Harness. Via de toggle New experience op de homepage (of Other ways to build) kom je terug bij klassieke agents en Agent Flows. Beide werelden bestaan naast elkaar.

GitHub Copilot Harness: sinds september 2026 algemeen beschikbaar

Op 2 september 2026 heeft Microsoft de GitHub Copilot Harness algemeen beschikbaar verklaard. De runtime zelf is daarmee uit Preview en volgens Microsoft de aanbevolen basis voor agents en workflows die meerstaps werken, bestanden genereren en een proces van begin tot eind moeten automatiseren. Voor projectpraktijk verandert dat vooral de argumentatie: een GA-feature laat zich anders verkopen in gesprek met ondernemingsraad, privacy en inkoop dan een Preview.

Oplossingen in natuurlijke taal beschrijven (Preview)

Het productoverzicht bevat sinds 9 september 2026 een eigen sectie Build with natural language als Preview: je beschrijft het bedrijfsdoel en Copilot Studio beslist zelf welke combinatie van agents en workflows dat oplost. Verfijnen gebeurt via vervolgvragen en correcties in hetzelfde gesprek, en er kunnen meerdere assets in één sessie ontstaan, zonder dat je vooraf het type vastlegt of tussen designers wisselt.

Voor workshops is dat een echte winst: de vraag "Hebben we hier een agent of een flow nodig?" mag aan het begin open blijven in plaats van de discussie te blokkeren. Voor de kostenplanning geldt het omgekeerde: precies dit genereren per prompt is op de GitHub Copilot Harness credit-plichtig, en wel vanaf de eerste poging (zie hoofdstuk 10).

Skills: herbruikbare instructie-bouwstenen

Een Skill is een zelfstandige vaardigheid uit naam, beschrijving en instructies in markdown. Hij is daarmee duidelijk afgebakend van de andere bouwstenen: Instructions beschrijven het generieke gedrag, Knowledge is kennis, Tools zijn acties via externe diensten en een Skill is een taakspecifieke werkwijze die de orchestration bij behoefte activeert. De beschrijving is de trigger, daaraan beslist de runtime of de skill grijpt. Zorgvuldigheid loont dus juist daar.

Het format is bewust portabel: een bestand SKILL.md met YAML-frontmatter (naam, beschrijving) plus markdown-instructies. Als skill-pakket komt het geheel als ZIP met optionele begeleidende bestanden zoals scripts, templates en referentiedocumenten. Je kunt Skills in Copilot Studio schrijven, in een willekeurige editor bouwen en uploaden of bestaande GitHub Copilot- en Claude Code-skills overnemen. Een Skill wordt één keer gebouwd en in meerdere agents gebruikt.

Memory: persistente context per gebruiker

Memory is een productiewaardige Preview en draait alleen op de GitHub Copilot Harness. De agent houdt voor elke gebruiker een eigen geheugen in door Microsoft beheerde storage: hij vangt voorkeuren en relevante context (Capture), legt ze als bestanden vast in de gebruikerseigen map (Store) en leest ze bij latere interacties opnieuw in (Apply). In- en uitschakelen gebeurt per agent via de toggle in de Build-tab.

Voor privacy-gesprekken zijn vooral deze punten relevant:

• De herinneringen van een gebruiker zijn privé. Noch de maker, noch andere gebruikers kunnen ze inzien.
• Na 28 dagen zonder interactie verwijdert het systeem automatisch de herinneringen van die gebruiker voor die agent.
• In groepschats en Teams-kanalen is Memory uitgeschakeld.
• Elke gebruiker kan in het Memory-portal alles wat opgeslagen is inzien en volledig verwijderen, of de agent in de chat vragen om iets aan te passen of te vergeten. Bij het eerste contact in een nieuw kanaal laat de agent de portal-link zelf zien.

Wanneer wat?

Classic Orchestration is je default voor:

• Sterk gereguleerde customer-facing bots waarbij elk antwoord voorspelbaar moet zijn
• FAQ- en routing-scenario's met helder gedefinieerde intents
• Bots die custom data sources of Bing Custom Search nodig hebben
• Compliance-cases waarbij het audit-verhaal "de user zei X, dus Topic Y wordt getriggerd" beslissend is

Generative Orchestration is je default voor:

• Interne productiviteitsagents met veel tools (10+)
• Autonome agents op event-triggers (voorwaarde!)
• Multi-tool chaining, waarbij een tool de input voor het volgende levert
• Scenario's waarin Topics vergelijkbaar klinken, maar in detail andere acties nodig hebben

AI Builder Prompts als sub-prompt

Binnen beide modi kun je gerichte LLM sub-prompts inbinden als AI Builder-actions, bijvoorbeeld voor "Classificeer mail" of "Extraheer datum uit deze tekst". Dat geeft je punctuele LLM-inzet, zonder de agent in de volle Generative-modus te dwingen.

DLP-policies (Data Loss Prevention)

DLP-policies komen uit het Power Platform en gelden ook voor Copilot Studio. Je categoriseert connectors in drie klassen:

Tenant-brede policies hebben voorrang op env-policies en zijn niet overschrijfbaar. Sinds begin 2025 is DLP-enforcement actief voor alle agents. Eerdere uitzonderingen (exemption) zijn afgeschaft.

Aanvullend kun je via policy sturen:

• Welke Tools of Actions zijn toegestaan (bijvoorbeeld "geen HTTP-request").
• Welke Knowledge Sources zijn toegestaan (bijvoorbeeld "geen public web").
• Welke Channels gepubliceerd mogen worden.
• Of agents No Authentication mogen gebruiken.

Sturen gebeurt in de praktijk via connector-namen, en die heten in het Power Platform Admin Center anders dan je ze zoekt. Daarom hier de vertaaltabel:

Twee mechanismen die projecten vaak over het hoofd zien: in plaats van een connector volledig te blokkeren, kun je voor SharePoint, publieke websites en HTTP endpoint-filtering gebruiken en individuele doelen toestaan of verbieden. En bij een overtreding wordt de Publish-button uitgeschakeld. Via Details, Download op de Channels-pagina krijgt de maker een bestand met één regel per overtreding, dat hij direct kan doorsturen naar de admin. Met Set-PowerAppDlpErrorSettings leg je in die foutmeldingen tenantbreed een admin-mailadres en een "Learn more"-link vast, een van de effectiefste kleine ingrepen tegen ticket-pingpong.

Environment-strategie

Aanbevolen zijn minimaal 3 Power Platform-environments:

Optioneel: persoonlijke dev-envs per developer. Elke env heeft eigen DLP-policies, eigen connectors en eigen audit-trails. Entra security groups beperken de toegang.

Authenticatie (recap)

• No Authentication, pas op: externe kanalen (Direct Line) breken als intern "No Auth" staat.
• Entra ID v2 met federated credentials is de aanbevolen default, geen client secret-rotatie-stress.
• SSO met Entra in Teams, user-identiteit wordt automatisch doorgegeven.
• Entra External ID, voor klant- of partnerlogins (B2C).
• Teams en Microsoft 365 verdragen maar één optie. De kanalen Teams + Microsoft 365 ondersteunen uitsluitend Authenticate with Microsoft. Kies je een andere optie, dan gaan deze kanalen in blocked status. Omgekeerd is Authenticate with Microsoft niet beschikbaar voor agents die met Dynamics 365 Customer Service zijn geïntegreerd. Wie beide nodig heeft, heeft twee agents nodig.
• Het variabelenverschil kost je de publish. Onder Authenticate with Microsoft bestaan alleen User.ID en User.DisplayName; User.AccessToken en User.IsLoggedIn ontbreken. Schakel je van handmatige auth over naar Microsoft, dan verschijnen die variabelen in alle topics als Unknown en moeten ze vóór het publiceren worden gecorrigeerd. Voor een access token heb je Authenticate manually nodig. De providerlijst daar telt inmiddels vijf items: Entra ID V2 met federated credentials, met certificaten of met client secrets, plus Entra ID (V1) en Generic OAuth 2.
• Nieuw gedocumenteerd (stand 17-09-2026): Power BI en Entra-auth sluiten elkaar uit. Agents met Microsoft-authenticatie zijn niet via iframe-gebaseerde visuals in Power BI-rapporten in te bedden. En bij Generic OAuth2 kan iedereen die inlogt met de agent praten – afzonderlijke gebruikers zijn dan via agent sharing niet meer te sturen. Beide komen pas tijdens de uitrol aan het licht als niemand het vooraf heeft gecontroleerd.

Microsoft Entra Agent ID (verplicht, rollout mei tot juli 2026)

Copilot Studio integreert met Microsoft Entra Agent ID: per agent wordt automatisch een eigen identity in Entra aangemaakt, vergelijkbaar met service principals, maar met eigen audit-story en lifecycle. Voordelen:

• Audit log in Microsoft Entra (sign-in events per agent).
• Connector-permissies verschijnen als API Permissions op de agent-identiteit. Entra- en M365-admins zien zonder Power Platform-login wat een agent kan.
• Conditional Access voor connector-scopes (network location, device compliance, risk conditions).
• Integratie met Entra ID Governance.

Wat dat concreet in de tenant triggert: met de eerste agent na de rollout legt Copilot Studio een blueprint aan met de naam Microsoft Copilot Studio agent identity blueprint plus bijbehorende blueprint principal in de tenant (blueprint-ID 25664c89-cea5-4ab6-b924-a54fd8a19ae0). Elke afzonderlijke agent-identiteit hangt als kind onder dit globale blueprint. Schrik dus niet als er in Entra plotseling een principal opduikt die niemand bewust heeft aangemaakt. Dat is het verwachte pad, geen audit-bevinding.

Bestaande agents: agents die voor de rollout zijn ontstaan, blijven via App Registrations draaien. Microsoft migreert ze op een later moment naar Agent IDs. In de overgangstijd werken de governance-functies voor beide varianten. Je hoeft dus niet zelf te migreren, maar je inventarislijst bevat een tijdje twee identiteitstypen naast elkaar. Wie niet wil wachten, kan bestaande agents ook zelf omzetten: via het Power Platform Admin Center, met PowerShell-scripts of via de Power Platform-API's. Bij het verwijderen van een agent verwijdert Copilot Studio de bijbehorende Entra Agent ID mee.

Hoe de connector-scopes echt werken: bij het publish-moment hangt Copilot Studio voor elke geconfigureerde Power Platform-connector API-permissions aan de agent-identity. Deze scopes worden uitsluitend door de Power Platform-connector-runtime gehonoreerd en op runtime opnieuw gecheckt tegen Advanced Connector Policies (ACP) en DLP. Ze zijn dus een zichtbaarheids- en conditional-access-werktuig, geen manier om je governance-policies te omzeilen. En omgekeerd vervangt hun aanwezigheid ook geen DLP-policy.

GUID opzoeken: in Copilot Studio onder Settings, Advanced, Metadata staat de GUID van de agent-identity als Entra Agent ID. Daarmee kun je in het Entra Admin Center controleren of de identities daadwerkelijk zijn gevuld.

Microsoft Agent 365 (GA 1 mei 2026)

Sinds 1 mei 2026 is Microsoft Agent 365 algemeen beschikbaar voor het commerciële segment (per-user licentiëring, Microsoft E5 als aanbevolen basis). Het is de centrale governance- en control plane voor enterprise-agents tenant-breed, niet alleen voor Copilot Studio-agents, maar ook M365-, Foundry- en partner-agents. Je ziet inventory, permissies, gedrag en activiteit op één plek en kunt gedeelde policies, security controls en lifecycle-oversight toepassen. In Copilot Studio verschijnen admin-statusinfo's nu direct in het authoring (security posture per agent, auth gaps, policy impact).

Wat je concreet in de tenant moet controleren

• Advanced Hunting: de tabel AIAgentsInfo wordt vervangen door de nieuwe tabel AgentsInfo (Agent 365 is nu single source of truth voor de agent-inventaris). AIAgentsInfo is uitgefaseerd, maar nog niet verwijderd. Opgeslagen queries, custom detections en workbooks moeten worden gemigreerd.
• Block-regels: tenants die op de oude Agent 365-regels op Block stonden, blokkeren sinds 1 juli 2026 niet meer. Regels opnieuw definiëren onder Settings, Security for AI, Policies & rules, Real-time protection. Dit betreft uitsluitend Agent 365 real-time protection, niet het Defender for Cloud Apps-pad.
• Defender-portal: de subtab AI Agents onder Cloud Assets is voor alle klanten verwijderd, onafhankelijk van de licentie. Alle Security for AI-functies zitten nu onder de gemeenschappelijke schakelaar Security for AI Agents.
• Third-party agents zijn niet meer via Defender for Cloud connectors vindbaar. Gebruik in plaats daarvan Registry Sync in de Microsoft 365 Agent Registry (Preview).
• Customer Lockbox dekt de governance-, telemetrie- en audit-events niet die via Agent 365 lopen, en evenmin het security audit logging van Copilot Studio zelf (details verderop).

MCP-certificering (Preview sinds juli 2026)

Een MCP-server is vanuit governance-perspectief een vreemde dienst waar je tool-aanroepen en daarmee vaak data aan toevertrouwt. Sinds juli 2026 bestaat daar een officieel keurmerk voor: de Microsoft MCP server certification. Microsoft valideert pakket en runtimegedrag van een ingediende server voordat hij breed beschikbaar wordt, en de publisher blijft daarna verantwoordelijk voor het onderhoud van de gecertificeerde ervaring.

Inzending gebeurt via het Partner Center-aanbodtype Apps and Agents for M365 and Copilot. Het oude inzendpad was nog tot eind juli 2026 bruikbaar. Reeds gecertificeerde MCP-servers hoeven vanwege de omschakeling niets te doen, Microsoft brengt ze zelf over. Voorwaarde is een verified publisher met afgeronde business-verificatie in Partner Center, enrollment in het Microsoft 365 en Copilot-programma en eigendom of controle over de ingediende endpoint. Independent publishers zonder eigen dienst mogen niet inzenden.

Wat je er als klant aan hebt: de lijst met gecertificeerde MCP-servers staat in de connector-referentie en is bruikbaar als whitelist-basis. Voor de beoordeling van een niet-gecertificeerde server verandert niets: hij blijft toegestaan, maar de toetsing doe je zelf. Een zinvolle governance-zin luidt daarom niet "alleen gecertificeerde MCP-servers", maar "gecertificeerd of eigen gedocumenteerde vrijgave". Terzijde: Microsoft ondersteunt in manifest- en tool-bestanden alleen ASCII-headernamen en -waarden. Diakritische tekens in het manifest laten de validatie mislukken.

Knowledge Source-permissies

Als SSO actief is en je SharePoint, Graph of Dataverse als Knowledge inbindt, erft de agent de permissies van de gebruiker. Dat is een van de belangrijkste security-features: een medewerker ziet alleen kennis die hij toch al mag zien.

Zonder SSO draait alles in de context van een maker- of service-account, en dat is meestal NIET wat je wilt, maar juist de bron van veel data-lekken.

Protection Status: het veiligheidsstoplicht per agent

Governance faalt zelden op ontbrekende policies, maar op het feit dat niemand ziet welke agent er tegen ingaat. Precies daarvoor bestaat op de Agents-pagina in Copilot Studio de kolom Protection status. Voor elke gepubliceerde agent toont die één van drie toestanden: Protected (groen schild, geen actie nodig volgens gedetecteerde signalen), Needs review (policy-overtreding of onvoldoende authenticatie) of Unknown. De clou voor maker-enablement: het stoplicht staat waar de maker toch al werkt, niet in het Admin Center.

Een klik op de status opent een samenvatting die het beveiligingsprofiel in drie categorieën uiteenlegt, elk weer met Protected, Needs review of Unknown:

Staat Authentication of Policies op Needs review, dan slaat dat door naar de totaalstatus in de agents-lijst. Content moderation doet dat bewust niet.

Security analytics: wat er daadwerkelijk werd geblokkeerd

Via See details kom je in de dialog Security analytics met statistieken en trends over de laatste 7, 14 of 30 dagen (perioden zonder data verschijnen niet in de picker). Twee weergaven zijn praktijkrelevant: het gestapelde staafdiagram Reason for block splitst alle geblokkeerde berichten uit naar blokkeergrond: potentiële bedreigingen, policy-overtredingen, content moderation. De grafiek Session block rate trend toont per categorie het aandeel sessies met een geblokkeerde aanvraag over de tijd, dus of een uitschieter een incident is of een patroon.

Automatische security-scan voor het publish

Agents zijn bij uitlevering veilig geconfigureerd. Omdat makers deze defaults om begrijpelijke redenen versoepelen zonder het risico te kennen, loopt voor het publiceren een automatische security-scan die de maker waarschuwt. Drie afwijkingen triggeren de waarschuwing:

• Authenticatie op No authentication gezet. Default is Authenticate with Microsoft. Met No Auth kan iedereen met de link met de agent praten.
• Bij connectors en flows omgezet naar Maker-provided credentials. Default zijn end user credentials, dus de rechten van de betreffende gebruiker. De wissel betekent: iedereen ziet wat de maker mag zien.
• Agent met iedereen in de organisatie gedeeld. Default is "met niemand gedeeld".

De scan is een waarschuwing, geen gate: hij blokkeert het publiceren niet, maar dwingt een bewuste beslissing af. Voor een governance-concept betekent dat, dat je deze drie punten toch hard via data policies moet afdekken als ze in je organisatie niet onderhandelbaar zijn. Aanvullend beoordeelt Copilot Studio knowledge, tools en actions al tijdens de configuratie doorlopend op mogelijke data-uitstroom en security-risico's, zodat bevindingen voor het publish zichtbaar worden in plaats van erna.

Audit-logs via Microsoft Purview

Studio-agents loggen in het Purview Audit Log. Het loggen gebeurt op SDK-niveau, dus één actie triggert vaak meerdere events. Ruwweg drie klassen:

• Admin- en maker-acties op de agent zelf: BotCreate, BotDelete, BotDeleteCleanup plus de BotUpdateOperation-varianten voor naam, icoon, authenticatie, Publish en Share.
• Component-wijzigingen: BotComponentCreate, -Update, -Delete voor Topics, Skills en Entities, plus Component Collections, AIPluginOperation* voor AI Plugins, EnvironmentVariable* voor environment variables en BotAppInsightsUpdate voor wijzigingen aan de Application Insights-configuratie.
• Gebruik: CopilotInteraction voor elke interactie van een gebruiker met een agent.

Compliance-admins werken in de Purview-portal onder Solutions, Audit. Developers komen via de Office 365 Management API aan dezelfde data.

Uitzetten gaat maar half. Het loggen van administratieve activiteiten is op alle tenants standaard actief en kan niet worden uitgezet. Wat je wel kunt doen: het audit log in Purview tenantbreed uitzetten en via een data lifecycle management-richtlijn met bewaring 0 dagen voor "Copilot Experiences" voorkomen dat gebruikers- en antwoordtekst wordt bewaard. Twee voorwaarden zijn makkelijk over het hoofd te zien: gebruikers hebben een toegewezen Microsoft 365-licentie nodig om überhaupt events en transcripts te laten schrijven, en in FedRAMP-tenants werkt het geheel niet.

Twee extra details voor de praktijk: bij agents met Entra Agent ID landt de authenticatie-activiteit ook in Microsoft Entra ID en is zichtbaar in het Entra Admin Center. De governance-story ligt dus op twee portalen. En losse kanalen zijn uitgesloten van logging. Welk kanaal een event heeft gegenereerd, staat in de audit-oplossing in het JSON-veld CopilotEventData als AppHost, in DSPM for AI als App accessed in. Ontbreken er events, dan is het kanaal de eerste verdachte, niet de policy.

Overige governance-controls in het kort

Microsoft noemt in het governance-overzicht een reeks controls die in projecten zelden allemaal bekend zijn. De relevantste naast DLP, Entra Agent ID en Purview:

MIP-labels en Sensitivity (Preview sinds juli 2025)

Microsoft Information Protection (MIP) sensitivity labels worden sinds juli 2025 in Copilot Studio doorgegeven: connectors, Test Chat, Teams en M365 Copilot tonen het label van het brondocument. Files met label confidential of highly confidential leveren in Generative Answers geen inhoud, goed voor oversharing prevention, maar kan wel knowledge-gaten geven. Purview-integratie met Dataverse classificeert gevoelige data automatisch.

Responsible AI-guardrails

• Topics deactiveren, single-click, zonder te verwijderen.
• Allowed of Disallowed Topics definiëren, wat de agent principieel wel of niet mag beantwoorden.
• Content Moderation op Generative Answers, standaard toxiciteits- of PII-filter.
• Restrict to defined topics toggle, generatieve antwoorden alleen als een Topic is gematcht.
• Conversation Boosting Off, geen vrije LLM-praat buiten de Topics om.
• Citations verplicht voor Generative Answers, gebruiker ziet de bron.

Studio biedt vier manieren om een mens in de workflow te halen, plus sinds nov 2025 approval-gates per toolstap voor autonome agents.

1. Adaptive Card met approval-button

Je stuurt met "Ask with Adaptive Card" een card ("Approve / Reject"). De agent wacht op de submit, parseert het antwoord in een variabele en gaat verder.

• Geschikt voor: snelle inline-bevestigingen in de chat.
• Limiet: alleen in de actieve chatcontext.

2. Power Automate "Approvals" action

Klassieke PA approval-action (Teams- of Outlook-approval-card): de agent roept een flow aan die de approval blokkeert en wacht op antwoord.

• Geschikt voor: asynchrone goedkeuringen (uren of dagen).
• Limiet: PA-licentie kost extra.

3. Agent Flow "Request for Information"

In Agent Flow bestaat sinds 2025 een specifieke HITL-action: de flow pauzeert, stuurt een gestructureerde mail (via Outlook) met invulvelden, verzamelt het antwoord direct uit de mail en gaat verder.

• Geschikt voor: gestructureerde off-system reviews.
• Limiet: momenteel alleen Outlook als kanaal.

4. Handoff naar live agent

Bij een handoff gaat de volledige conversatiecontext mee (variabelen en transcript), zodat de menselijke agent niet "vanaf nul" hoeft te beginnen.

Approval-gates per toolstap (nov 2025)

Sinds nov 2025 kun je in autonome agents per tool of action een approval-gate zetten: de agent zet de stap pas als een gedefinieerde approver akkoord geeft.

Belangrijk voor: kostendrempels, policy-validation, gevoelige data-operaties.

Human supervision voor Computer Use

Computer Use-tools hebben een eigen human supervision-veld: bij herkende "potentieel schadelijke instructions" (bijvoorbeeld prompt injection op een website) wordt een gedefinieerde reviewer via Outlook op de hoogte gesteld. Belangrijk om te weten: de reviewer ziet de run-context alleen als hij hem zelf heeft geïnitieerd, anders ontbreekt het zicht op wat er gebeurt. Een response time limit-configuratie bepaalt of de run wacht of afbreekt.

Smart approval met condities

Combineer condities met HITL om alleen bij behoefte om goedkeuring te vragen:

Agent Flow: factuurbedrag extraheren

Condition: bedrag > 1.000 €?
├─ Ja → Request for Information (manager-goedkeuring per mail)
│       → SAP-connector: betaling boeken
└─ Nee → SAP-connector: betaling direct boeken

Zo heb je automatisering voor routinegevallen en controle voor uitzonderingen.

Draft vs. Published

• Draft, de in Studio bewerkbare versie. Tests in het test-pane draaien tegen draft.
• Published, de live uitgezette versie die gebruikers op kanalen zien.
• Elke "Publish"-klik maakt een nieuwe published version. Studio bewaart de historie (restore mogelijk).

Solutions (ALM-container)

Best practice: altijd in een solution werken met eigen publisher en prefix. Een solution kan bevatten:

• Agents
• Topics
• Agent Flows / Cloud Flows
• Connection References (in plaats van vaste verbindingen)
• Environment Variables (in plaats van vaste waarden)
• Dataverse-tabellen, AI-prompts, custom connectors

Dev, Test, Prod

Vier deploy-mechanismen:

Component Collections (nov 2025): quick export en import van Topic-, tool- en knowledge-bundles via de sidebar, ook voor child-agents en MCP-connector-types. Handig voor hergebruik over meerdere agents heen.

Agent Evaluations als CI/CD-gate (GA maart 2026, REST API als Preview april 2026): verplichte test sets voor prod-deploy, custom graders voor domeinspecifieke pass/fail-criteria, multi-turn conversatietests. Testresultaten 89 dagen zichtbaar in Studio, exporteerbaar als CSV.

Uitbreiding van de Evaluations in september 2026: Microsoft rolt via het Message Center (RM569607) een uitgebreide evaluations-ervaring uit als algemeen beschikbaar. Nieuw zijn uitgebreidere onderbouwing per resultaat, reasoning traces van de agent, de geciteerde Knowledge Sources per testcase, het vergelijken van twee evaluations-runs, ondersteuning voor grotere datasets, configureerbare testcase-generatie en het genereren van testdata direct uit Knowledge Sources. Daarnaast een preflight-validatie die configuratiefouten meldt voordat een run start.

Twee details uit de evaluations-documentatie die in projecten vaak worden gezocht: Copilot Studio meet per interactie de Response Time in seconden, end-to-end inclusief reasoning-, tool-, connector- en workflow-stappen. Een pure meetgrootheid zonder pass/fail-werking, goed geschikt voor voor-na-vergelijkingen. En er is een eigen deel-rol Agent Viewer: wie die krijgt, mag test sets van andere makers zien, starten, hernoemen, afbreken en verwijderen, maar de agent zelf niet wijzigen, niet publiceren en geen deelinstellingen beheren. Status en kengetallen van een run zien alle makers, de agent-antwoorden en resultaat-onderbouwing alleen degene die de run heeft gestart.

Best practices:

• Managed solution in Test en Prod, unmanaged alleen in Dev.
• Environment variables voor API-URL's, connector-endpoints enz.
• Connection references voor connector-verbindingen (solution kan zonder hardgecodeerde credentials verhuizen).
• Na deploy: post-deploy config voor Application Insights-koppeling en handmatige auth-settings (die zijn env-specifiek).

Model lifecycle: het deploy-geval dat bijna iedereen vergeet

Microsoft heeft in augustus 2026 een eigen guidance-reeks over de model lifecycle gepubliceerd. Die dicht een gat dat in bijna elk project bestaat: een modelwissel wordt behandeld als een dropdown-wijziging, maar gedraagt zich als een migratie. Een nieuwer model interpreteert instructies letterlijker, kiest tools anders, antwoordt met andere lengte en opmaak en heeft andere latentie. De kernboodschap van de documentatie: flexibel bouwen, conservatief opereren, elke upgrade via een evaluation onderbouwen.

De gedocumenteerde cyclus voor productie-agents heeft zeven stappen: Discover (nieuwe, gewijzigde, nieuwe default- en aflopende modellen vinden), Inventory (welke agents, environments, owners en bedrijfsprocessen zitten eraan vast), Evaluate (kandidaat meten tegen een vastgestelde baseline), Approve (op basis van gedocumenteerde kwaliteits- en operationele criteria), Deploy (via het reguliere ALM-pad), Monitor (productie observeren, nieuw ontdekte gevallen in de regressie-suite opnemen) en Repeat. Je stoot bovendien een review aan als een model in jouw regio beschikbaar wordt, als de default verandert, als een uitfasering of automatische upgrade wordt aangekondigd, of als monitoring kwaliteits-, latentie- of verbruiksproblemen laat zien.

Wat je per agent moet vastleggen, zodat een aangekondigde uitfasering geen brandweer-inzet wordt: naam, agent-ID, environment en environment-type, businesskritikaliteit, functioneel en technisch owner plus tester en fiatteur, het geconfigureerde model met release-tag, of de agent aan de default hangt of een vast model gebruikt, Cross-Geo-behoefte en regionale eisen, de gebruikte harness (die bepaalt welke evaluations-methoden überhaupt beschikbaar zijn), de opslaglocatie van de regressie-test set met de datum van de laatste baseline-run, plus de vraag of het retired-model-window wordt gebruikt, wanneer dat afloopt en wie het heeft vrijgegeven.

Inventariseren hoef je niet met de hand te doen. In het Power Platform Admin Center toont Manage, Copilot Studio een kolom Model over alle agents van de tenant, filterbaar en exporteerbaar. Onder Licensing, Copilot Studio, Environment, Message consumption details staat aanvullend de kolom LLM Model plus verbruik. Programmatisch levert de Inventory API naam, weergavenaam, environment en model in één tenantbrede query. Voorwaarden: de rol Power Platform- of Dynamics 365-administrator, een access token voor https://api.powerplatform.com/ en een voor de tenant geactiveerd Agent Inventory.

POST https://api.powerplatform.com/resourcequery/resources/query?api-version=2024-10-01
Authorization: Bearer <access-token>
Content-Type: application/json

{
  "TableName": "PowerPlatformResources",
  "Clauses": [
    { "$type": "where", "FieldName": "type", "Operator": "in~",
      "Values": ["'microsoft.copilotstudio/agents'"] },
    { "$type": "project", "FieldList": [
        "name",
        "properties.displayName",
        "properties.model",
        "environmentId = tostring(properties.environmentId)"
      ] }
  ],
  "Options": { "Top": 200 }
}

// Antwoord: properties.model komt terug als properties_model.
// Bij meer treffers dan Top: skipToken uit het antwoord als
// Options.SkipToken terugsturen en herhalen.

Groepeer je het resultaat op properties_model, dan zie je in één oogopslag waar welk model in de tenant zit. Bij een uitfasering filter je dezelfde lijst op het aflopende model en heb je de betrokken agents met environment-ID voor de owner-uitvraag. Voor een enkele omgeving volstaat pac copilot list --environment <id> uit de Power Platform CLI. Dat commando levert echter geen model, daarvoor heb je de Inventory API nodig.

Channel-publishing

Per kanaal een aparte publish-pipeline:

• Teams / M365 Copilot, Studio genereert een app-manifest. Dat moet door de Teams-admin worden goedgekeurd voordat gebruikers het kunnen installeren. Eerst personal scope, daarna team/channel scope optioneel via manifest-tweak.
• Web, embed-code voor eigen sites.
• Custom (Direct Line), geheime Direct Line-token, te gebruiken in een eigen app.
• Voice, D365 Contact Center-provisioning.
• Teams Phone Agent (Preview sinds juni 2026), de Copilot Studio Voice Agent hangt zich aan een Teams Phone Agent en neemt gespecialiseerde vragen over zoals facturatie, bestelstatus of receptenherhaling. Overdracht en teruggave verlopen naadloos, transfer-doelen komen als tags uit een tag-template in het Teams Admin Center, in plaats van hardgecodeerd in de agent. Het kanaal is gated: de tenant moet via Microsoft Support worden vrijgeschakeld, anders verschijnt de optie niet.
• SharePoint / Power Pages, embed webpart.

Environment-level telemetrie met Application Insights (Preview sinds juli 2026, in september herzien)

Tot juli 2026 moest je Application Insights per agent koppelen. Sinds juli 2026 kun je de export in het Power Platform Admin Center aanzetten voor een hele managed environment: één export-package met type Copilot Studio, en alle agents in de omgeving leveren traces. Voor beheer is dat de echte sprong: je ziet agent-runs, node- en tool-executies, kunt alerts bouwen en eigen dashboards en queries schrijven, zonder dat elke maker eraan hoeft te denken. Sinds de documentatiestand van 17 september 2026 geldt dat uitdrukkelijk voor agents op beide harnesses, de Standard Harness zowel als de GitHub Copilot Harness.

Twee details die bestaande dashboards breken: na afloop van de private preview zendt Microsoft de root-aanroepen van een agent (invoke_agent) als dependencies uit in plaats van zoals eerder als requests. Oudere root-traces kunnen daarom nog in de requests-tabel opduiken – wie over beide periodes analyseert, moet dat in de query opvangen. En de levering duurt bij een nieuw ingerichte configuratie tot 24 uur: komt er na het inschakelen niets binnen, dan is dat eerst een kwestie van geduld en pas daarna een storing. Wie uitsluitend op environment-niveau wil analyseren, kan de agent-level telemetrie volgens de documentatie gericht uitschakelen.

Rollback / Restore

Studio bewaart published versies, je kunt terugkeren naar een eerdere. Maar: solution-deployments zijn "forward-only". Rollback tussen environments loopt via een re-deploy van een eerdere solution-versie.

Prijsmodellen in detail

Sinds sept 2025 is de eenheid Copilot Credit, niet meer "Message".

Credits worden tenant-breed gepoold. Microsoft publiceert sinds maart 2026 officiële billing rates:

Reasoning-modellen worden dubbel afgerekend: feature-rate + AI-Tools-Premium-rate (bijvoorbeeld Generative Answer met deep-model = 2 Credits + 100 Credits / 10 responses).

Voice-afrekening per minuut: Classic Voice (klassieke orchestration) 10 Credits/min, GenAI Voice 35 Credits/min, Premium GenAI Voice 75 Credits/min. De core-agent-activiteit (Classic- of Generative Answer, Agent Action) is in de minuten-rate al inbegrepen.

Vuistregel: een conversationele sales lead qualifier kost $0,15 tot $0,80 per conversatie. Een autonome mail-triage-agent $0,30 tot $2,00 per mail. Een Computer Use-run met 10 stappen ongeveer $0,50 (standard) tot $1,50 (premium).

Usage-based billing van de GitHub Copilot Harness

Alles hierboven geldt voor de Standard Harness: vaste billing rates per feature, afrekening vanaf publicatie. Agents, workflows en apps op de GitHub Copilot Harness rekenen anders af, en dat is momenteel de duurste denkfout in projecten.

De billing-documentatie (stand 27 augustus 2026) noemt als toepassingsgebied letterlijk agents, workflows, and apps. Met de start van app-building in september 2026 valt daarmee ook elke gegenereerde app onder dit model. Reken ze in pilots vanaf het begin mee, in plaats van ze als gratis bijproduct te behandelen.

Wat er in september bij komt: Microsoft publiceerde op 15 september 2026 drie roadmap-items over kostentransparantie, alle met GA-doel september 2026 en status In development: RM571194 toont de kosten voortaan direct in de preview-chat en de agent-historie, RM571195 splitst ze in de Agent Evaluations uit naar eval-generatie, testruns en model-grading, en RM571196 brengt ze per agent in de Monitor-tab, inclusief geschatte verdeling over de levenscyclus van authoring via testing en evaluations tot productie. Precies dat ontbreekt vandaag: het bouwbudget is op, maar niemand kan zeggen waaraan. Tot dit is uitgerold blijft de verbruiksweergave in het Power Platform Admin Center het enige betrouwbare zicht.

Enforcement is hier harder dan de 125-procent-regel: heeft een environment geen toegewezen credits meer of zijn ze allemaal opgemaakt, dan stopt elke functie die credits nodig heeft. Eindgebruikers krijgen geen antwoorden meer, makers kunnen niet meer via natural language authoren, niet meer in preview testen en geen evaluations meer genereren. Beide groepen zien dezelfde melding dat credits ontbreken. Microsoft staat wat overage toe als coulance-buffer zodat bedrijfsprocessen niet abrupt afbreken, maar garandeert geen bedrag. De drie uitwegen: capaciteit vanuit tenant of andere environment herverdelen, capaciteit bijkopen, of een PAYG-meter voor de overage inrichten.

Credit-governance: de environment is de eenheid

Sinds 17 september 2026 is hier een eigen guidance-artikel over. De kernboodschap: omdat de GitHub Copilot Harness al credits verbruikt tijdens het bouwen, testen en evalueren, is het niet genoeg om alleen gepubliceerde agents te sturen. Governance begint vanaf dag één op environment-niveau. Belangrijk daarbij: developer- en trial-environments vallen sinds 1 september 2026 onder usage-based billing. Verbruiksgegevens van daarvoor zijn alleen een richtwaarde, geen kostenprognose.

Microsoft raadt aan elke environment in te delen in een van drie klassen: exploratie en prototyping (vaste grens, ontwikkellimiet per agent, gedocumenteerde weg naar meer capaciteit), test en validatie (tijdelijke capaciteit voor representatieve evaluaties) en gefinancierde productie (duidelijke kostenverantwoordelijke, limieten op basis van kritikaliteit). Voor een harde prepaid-grens wijs je een vaste hoeveelheid toe, zet je Draw from the available capacity in my tenant uit en koppel je geen PAYG. De betreffende agents vind je via Power Platform Inventory: het veld properties.harness met de waarde GitHub Copilot filtert ze eruit.

Overage enforcement van de Standard Harness (125%-regel)

Als de tenant 125% van zijn prepaid capacity bereikt, deactiveert Microsoft alle custom agents (conversation-end wordt afgewacht). Notificatie aan admin per mail en in het Power Platform Admin Center. Workaround: PAYG-meter activeren of capacity herallokeren. Agent Flow enforcement is apart: bij volle capacity worden nieuwe flow-runs geblokkeerd, andere agent-features blijven doorlopen. Tip: monthly spend limit per agent in het Admin Center instellen, voor het escaleert.

Bekende limieten (stand augustus 2026)

Rate Provisioning: doorvoer is niet licentie

Sinds juni 2026 scheidt Microsoft in de architectuur-guidance twee dingen netjes die in projecten vaak worden verward. License Provisioning is de commerciële vraag: licenties, credits, prepaid capacity, PAYG. Rate Provisioning is de technische vraag: hoe snel aanvragen mogen binnenkomen voordat throttling grijpt. Je kunt genoeg credits hebben en toch worden afgeknepen.

De limieten in de tabel hierboven gelden per dienst op agent-, environment-, tool-, connector- of kanaal-niveau. En het laagste limiet in het runtimepad bepaalt de gebruikerservaring. De agent kan binnen zijn grenzen blijven, terwijl een flow, een connector, een Dataverse-aanroep of een downstream-API al afknijpt. Messages naar een agent worden bijvoorbeeld per Dataverse environment geteld, dus inclusief alle andere agents en autonome workloads erin.

Reken daarom niet in maandvolumes, maar in piekvensters: aanvragen per minuut en per uur. Een campagne-piek van een uur kantelt een setup dat op weekgemiddelde onschuldig oogt. Als eerste reactie zijn ontwerp-optimalisaties nodig, geen limiet-aanvraag: externe aanroepen bewust plaatsen, agents met hoog volume over eigen environments verdelen, autonome runs via queues, batches en trigger-filters spreiden, reporting en telemetrie uit het interactieve pad trekken. Pas als dat staat, loont het support-verzoek in het Power Platform Admin Center. Dat is nodig voor UAT en loadtest, niet na de eerste productiefout, en een verhoging is nooit gegarandeerd.

Nieuw sinds september 2026: de guidance beschrijft nu hoe je een verhogingsaanvraag onderbouwt: draai een representatieve pilotfase, meet de piekbelasting, extrapoleer naar het volledige aantal gebruikers en voeg precies die cijfers bij de aanvraag. Zonder pilotdata blijft de aanvraag een schatting.

Kostendrijvers

1. Generative Orchestration, elke user-turn = minimaal 1 LLM-aanroep voor topic/tool-picking.
2. Knowledge Querying, elke Generative Answer = embedding + retrieve + synthesis = meerdere credits.
3. Autonome agents met hoog event-volume, bijvoorbeeld mail-triage op 10.000 mails/dag = vierstellige credits per dag.
4. Deep Reasoning, multi-step planning is duidelijk duurder dan single-shot.
5. Tool chaining, elke tool-call kan opnieuw LLM-reasoning uitlokken.

Vuistregel: schat credits = (conversaties per maand x gemiddelde user-turns x ongeveer 5 credits per turn) plus knowledge-hits.

1. Start met Classic Orchestration voor gereguleerde use cases. Generative is krachtig maar minder voorspelbaar, en compliance houdt van deterministische paden.
2. Elke agent in een eigen solution. Anders krijg je bij ALM-deploy een verzamelchaos en onbedoelde co-deployments.
3. Environment variables voor alles wat env-specifiek is. API-endpoints, group-IDs, SP-URL's. Zo verhuist een solution netjes tussen environments.
4. Activeer SSO zodra je Knowledge koppelt aan SharePoint, Graph of Dataverse. Anders draait alles in maker-context en zien gebruikers dingen die ze niet mogen zien.
5. Topic-descriptions zijn in Generative Orchestration net zo belangrijk als hun inhoud. Beschrijf precies wanneer een Topic gekozen moet worden, niet wat het doet.
6. Per tool maximaal 1 heldere taak. Een "hulp-tool dat ook nog X kan" wordt door Generative Orchestration verward. Splits het op.
7. HITL vanaf de eerste stap inbouwen als de agent autonoom is. Liever te veel approval-gates aan het begin, wegwerken is makkelijker dan achteraf incidenten opvangen.
8. Conversation Boosting Off plus Generative Answers alleen uit geconfigureerde Knowledge Sources. Anders hallucineert de agent "creatief" over thema's die je niet controleert.
9. Power Fx is je vriend voor logica, maar overdrijf het niet. Complexere logica in Agent Flow uitplaatsen (beter testbaar).
10. Test in multi-channel modus, niet alleen in het Studio-pane. Adaptive Cards, SSO en auth-tokens gedragen zich in Teams, Web en Direct Line anders dan in de test-bot.

Top 5 foutbeelden

Veelvoorkomende valkuilen

Valkuil 1: "Topic gevonden, maar er gebeurt niets"

Meestal connector-auth: connection references met kapotte credential geven stille fouten. Eerst de connection controleren, dan het topic.

Valkuil 2: Adaptive Card ziet er goed uit in Studio, maar kapot in Teams

Teams heeft een oudere card-schema-versie en een 28 KB-limiet. Altijd in Teams testen, niet alleen in Studio.

Valkuil 3: Generative Orchestration "verliest" topics

Bij 50+ topics gaan de descriptions te veel op elkaar lijken en pakt het LLM de verkeerde. Oplossing: scherpere descriptions of terug naar Classic.

Valkuil 4: SharePoint Knowledge toont alleen snippets, geen heel bestand

Als je alleen een M365-E3-licentie hebt (geen M365 Copilot) geldt de 7 MB-limiet. Grotere files? Opsplitsen of licentie upgraden.

Valkuil 5: "Why is my agent answering things it shouldn't?"

Conversation Boosting staat aan (default). Toggle uit en "Restrict to defined topics" aan.

Valkuil 6: Publicatie in Teams blijft wekenlang hangen

De Teams-admin moet de app catalog-entry goedkeuren. Vaak is dat approval-proces niet ingericht. Eerst het proces oplossen, dan deployen.

Valkuil 7: Power Automate-flow doet niets in het run-log

Als je een oude PA cloud flow als tool gebruikt, draait die onder een ander service-account. Permissies kunnen ontbreken waar ze in je eigen test wel werkten.

Valkuil 8: MCP via SSE breekt na augustus 2025

SSE is in augustus 2025 uitgefaseerd. Streamable HTTP is nu verplicht voor MCP-server-koppeling.

Valkuil 9: "Mijn autonome agent vuurt niet."

Generative Orchestration moet aan staan, anders zijn event-triggers niet zichtbaar in de UI.

Valkuil 10: "Agent disabled, billing issue"

Je hebt 125% van de prepaid capacity overschreden, overage enforcement grijpt in. Bevestig in het Power Platform Admin Center of je capacity herallokeert of PAYG activeert. Bij Agent Flows: aparte enforcement, blokkeert alleen nieuwe runs.

Valkuil 11: Real-time Voice werkt niet in EU-tenant

Real-time Agents zijn alleen gehost in Noord-Amerika (GPT-Realtime) en sinds juni 2026 in Australië (GPT-Realtime-Mini). EU Data Boundary-tenants kunnen die feature niet gebruiken, want het Cross-Geo-processing dat daarvoor nodig is, is in de EU verboden. Buiten NA/Australië moet Cross-Geo-processing expliciet toegestaan zijn.

Valkuil 12: "Generative Answer levert geen antwoord ondanks aanwezig SP-bestand"

Vermoedelijke oorzaak: het document draagt een MIP sensitivity label confidential of highly confidential. Deze bestanden worden wel als "ready" getoond, maar leveren geen inhoud.

Valkuil 13: Generative Orchestration negeert Conversational Boosting-systeem-topic

Bekende limitatie: in Generative Orchestration worden aanpassingen aan het Conversational Boosting-systeem-topic niet meegenomen. Custom data sources en Bing Custom Search werken ook alleen via de Classic data-optie in de Generative Answers-node.

Valkuil 14: Multiple Topics Matched-systeem-topic disambigueert niet

Generative Orchestration roept het Multiple Topics Matched-systeem-topic momenteel niet aan. Tijdens testen het topic uitschakelen. Weer inschakelen wanneer Microsoft de disambiguation-fix uitlevert.

Valkuil 15: De agent antwoordt dubbel, of helemaal niet

Microsoft heeft eind augustus 2026 gedocumenteerd waarom dat gebeurt, en de oorzaak is structureel, geen bug. De Standard Harness verdeelt de context over de betrokken componenten. Elke component werkt vanuit zijn eigen context, en de orchestration-laag stemt de context niet op het hoogste niveau af. Zolang een component draait, ziet de orchestration-laag de berichten die die component aan de gebruiker stuurt niet. Gevolg: een aanvraag lijkt onbeantwoord, dus beantwoordt iemand hem een tweede keer.

Context stroomt op twee manieren naar binnen (expliciete inputs plus impliciet meegestuurde conversatiecontext) en op twee manieren terug (expliciete outputs plus impliciete context). Wat een component alleen aan de gebruiker toont of alleen in eigen variabelen houdt, bereikt de orchestration-laag nooit. Volgens Microsoft gaat ongeveer de helft van de gevallen met dubbele of ontbrekende antwoorden terug op dit impliciete doorgeven.

Adaptive Cards zijn de meest voorkomende trigger. Uit topics komt alleen platte tekst impliciet terug (Message-nodes, Question-nodes, card-inhoud, getypte gebruikersantwoorden), en zonder de info of de gebruiker het heeft gezien. Action buttons op een Adaptive Card en de klikken daarop bereiken de context van de Standard Harness helemaal niet. Vertrouw daarom nooit op card-inhoud als context. Geef alles wat een latere stap nodig heeft terug als Topic Output, en zet daarnaast een output die de "beantwoord"-status vastlegt.

Sub-agents zijn de tweede trigger. Een Child Agent draait in de parent en krijgt de conversatiecontext altijd mee, zonder mogelijkheid om dat uit te zetten. Bij de Connected Agent stuur je dat via een instelling. Staat in de doorgegeven context een aanvraag die er onbeantwoord uitziet, dan probeert de sub-agent te compenseren, en antwoordt een tweede keer.

Valkuil 16: Activity.Text is leeg terwijl de gebruiker wel iets heeft geschreven

Wie Activity.Text gebruikt om te loggen, krijgt in productie gaten, en de oorzaak is geen bug. Roept de agent bij gebrek aan context een knowledge source aan, dan blijft Activity.Text voor die beurt leeg: de agent formuleert geen eigen antwoord omdat hij de beslissing aan de kennisbron overlaat. Hetzelfde gebeurt bij tools die technisch als activity zijn uitgevoerd. De variabele pikt namelijk elke activity op die bij de agent binnenkomt, niet het vorige gebruikersbericht. De gedocumenteerde oplossing is simpel: gebruik LastMessage.Text als je het laatste gebruikersbericht nodig hebt, en Activity.Text alleen daar waar je echt de activity bedoelt.

Twee verscherpingen daarbij. De trigger OnPlanComplete draait pas als het tool klaar is. Is er een knowledge source gebruikt, dan schrijft de output daarvan rechtstreeks in de activity – en omdat Activity.Text vooraf leeg was, staat er uiteindelijk de tool-gebruiksinformatie in plaats van een gespreksbericht. Bij intent- of taalgebaseerde triggers gebeurt dat niet, omdat die eerder afgaan en de activity dan al een opgebouwd bericht bevat. En in Teams valt het sterker op dan in Copilot Studio, omdat Teams activity-objecten direct doorgeeft terwijl Copilot Studio ze normaliseert. Dezelfde agent gedraagt zich dus zichtbaar anders per kanaal, zonder dat er iets aan zijn logica is veranderd.