08 Intermediate ~45 min

D2D-sales-briefing

Stap-voor-stap walkthrough · bouw deze agent in Copilot Studio

begin hier

Volg de stappen in volgorde, alles is klikbaar in de Copilot Studio UI, geen code nodig. Schat ~45 min in voor je eerste keer.

  1. 1

    Open Copilot Studio en maak een nieuwe agent

    Log in op de webapp en start een lege agent zonder template.

    1. 01. Ga naar https://copilotstudio.microsoft.com
    2. 02. Klik 'Sign in' en log in met je werk-M365-account
    3. 03. Linker-menu → klik 'Agents'
    4. 04. Klik '+ Create' rechtsboven → 'New agent'
    5. 05. Klik 'Skip to configure' (rechtsonder, kleine link)
    6. 06. Naam: 'D2D-sales-briefing' (of een eigen naam)
    7. 07. Description: laat leeg, vullen we straks via de Description-card
    8. 08. Klik 'Create', wacht ~10 sec

    ⚠ Let op: Als je 'Describe to design' kiest, gokt Copilot Studio z'n eigen tools, dat overschrijft straks onze configuratie. Skip-to-configure is veiliger.

  2. 2

    Plak de Instructions

    Geef de agent zijn karakter en regels via de plak-en-klaar systeemprompt.

    1. 01. Op de Overview-tab → bij 'Instructions' klik 'Edit'
    2. 02. Wis de standaard-tekst
    3. 03. Kopieer de hele system-prompt rechts onderaan deze pagina (knop 'Kopieer')
    4. 04. Plak in het Instructions-veld
    5. 05. Klik 'Save' onderaan

    ⚠ Let op: Plak de prompt EXACT zoals hier, niet bewerken. Pas later aan als je wilt, eerst werkend krijgen.

  3. 3

    Vul de Description in

    De Description vertelt andere agents (en jezelf bij meerdere agents) wanneer deze agent moet worden aangeroepen. Belangrijk voor multi-agent setups.

    1. 01. Op de Overview-tab → bij 'Description' klik 'Edit'
    2. 02. Kopieer de tekst uit 'The Description'-card op deze pagina
    3. 03. Plak in het Description-veld
    4. 04. Klik 'Save'
  4. 4

    Voeg Knowledge toe uit je eigen bron

    Dit recept gebruikt knowledge die je zelf moet aanleveren (bv. SharePoint-folder, eigen PDF's).

    1. 01. Klik op de tab 'Knowledge' in Copilot Studio
    2. 02. Klik '+ Add knowledge'
    3. 03. Kies bron: SharePoint, OneDrive, Files (upload), of Web URL
    4. 04. Voeg toe: Actueel KPN-product-portfolio document: welke deals lopen deze week, welke USP's, welke prijzen
    5. 05. Voeg toe: Regio-data Excel met per regio: marktaandeel, concurrent-presence en lokale talking-points
    6. 06. Voeg toe: Concurrent-monitor document met deze week's moves van VodafoneZiggo, T-Mobile/Odido en Delta
    7. 07. Wacht tot elke bron status 'Ready' krijgt

    ⚠ Let op: SharePoint-bron vereist dat je leestoegang hebt. Bij twijfel: vraag IT om je rechten te checken of upload als losse files.

  5. 5

    Voeg Tool 1 toe, Fetch-region-data

    Voeg de tool 'Fetch-region-data' toe zodat de agent use when user specifies region. inputs: region. output: rollout-%, conversie, top concurrent move.

    1. 01. Klik op de tab 'Tools' in Copilot Studio
    2. 02. Klik '+ Add a tool'
    3. 03. Klik 'Connector'
    4. 04. Zoek 'Excel Online (Business)'
    5. 05. Kies actie 'List rows present in a table'
    6. 06. Klik 'Add and configure'
    7. 07. Bij Connection: 'Create new connection' → log in als gevraagd
    8. 08. Bij Description plak: 'Use when user specifies region. Inputs: region. Output: rollout-%, conversie, top concurrent move.'
    9. 09. Parameter 'File' = 08-region-data.xlsx (Teams-folder)
    10. 10. Parameter 'Table' = Regions
    11. 11. Parameter 'Filter Query' = auto, filter op region-naam
    12. 12. Klik 'Save'

    ⚠ Let op: Als de connection-popup hangt: open een nieuw tabblad, log opnieuw in op de service, ga terug en probeer opnieuw.

  6. 6

    Voeg Tool 2 toe, Push-to-Teams-channel

    Voeg de tool 'Push-to-Teams-channel' toe zodat de agent use only after user confirms. inputs: region + briefing. output: teams url.

    1. 01. Klik op de tab 'Tools' in Copilot Studio
    2. 02. Klik '+ Add a tool'
    3. 03. Klik 'Connector'
    4. 04. Zoek 'Microsoft Teams'
    5. 05. Kies actie 'Post message in a chat or channel'
    6. 06. Klik 'Add and configure'
    7. 07. Bij Connection: 'Create new connection' → log in als gevraagd
    8. 08. Bij Description plak: 'Use ONLY after user confirms. Inputs: region + briefing. Output: Teams URL.'
    9. 09. Parameter 'Post in' = Channel
    10. 10. Parameter 'Team' = test-team voor de workshop
    11. 11. Parameter 'Channel' = D2D-[regio]-test
    12. 12. Parameter 'Message' = auto, agent vult briefing in
    13. 13. Klik 'Save'
  7. 7

    Test je agent

    Stuur de testvraag naar de agent en check of-ie het verwachte format teruggeeft.

    1. 01. Rechter-paneel → 'Test your agent' (of klik op het test-icoon)
    2. 02. Plak de testvraag uit deze pagina (in de Testvraag-card)
    3. 03. Druk Enter
    4. 04. Check of het antwoord het Output-format uit de TCCO-card volgt
    5. 05. Check of de agent de juiste tools aanroept (icoontjes verschijnen bij elke tool-call)
    6. 06. Probeer een tweede vraag in eigen woorden, werkt het ook met variatie?

    ⚠ Let op: Als de agent geen tools aanroept: ga terug naar Tools-tab → klik op de tool → check of 'Connection' status 'Connected' is. Anders: re-connect.

  8. 8

    Publish naar Microsoft Teams

    Maak de agent oproepbaar in Teams zodat je 'm vanuit je Teams-chat kan gebruiken.

    1. 01. Klik 'Publish' (groene knop, rechtsboven)
    2. 02. Bevestig met 'Publish'. Wacht 30-60 sec voor build + validatie.
    3. 03. Klik 'Channels' (linker-menu)
    4. 04. Klik op de 'Microsoft Teams' tile
    5. 05. Klik 'Turn on Teams' → 'Available to me only' (geen IT-approval nodig)
    6. 06. Klik 'Apply'. Wacht 1-2 min.
    7. 07. Klik 'Open in Teams', je agent staat nu als chat in je linker-zijbalk

    ⚠ Let op: Als je geen 'Available to me only' optie ziet, heeft je IT 'Submit for admin approval' verplicht gesteld, duurt 1-2 dagen. Voor de workshop blijf je gewoon in de test-pane.

The Description

Wekelijkse maandagochtend-briefing per regio voor de 1.5k door-to-door field-force: top-3 talking-points, propositie-changes, recente concurrent-bewegingen, prio-wijken.

The Knowledge

Voor dit recept voeg je de volgende knowledge-bronnen toe in Copilot Studio (Knowledge → + Add knowledge → Files of SharePoint):

  • Actueel KPN-product-portfolio document: welke deals lopen deze week, welke USP's, welke prijzen
  • Regio-data Excel met per regio: marktaandeel, concurrent-presence en lokale talking-points
  • Concurrent-monitor document met deze week's moves van VodafoneZiggo, T-Mobile/Odido en Delta
  • Web-search: AAN, allow-list: vodafoneziggo.nl, t-mobile.nl, odido.nl, delta.nl, telegraaf.nl, fd.nl, ad.nl, marketingtribune.nl

Tip: begin met een sample-set (paar PDF's of Excel-rows) en breid uit zodra de agent stabiel werkt. Wacht in Copilot Studio tot elke bron status "Ready" krijgt voor je test.

The Tools

Fetch-region-data Connector, 1 klik

Connector + action: Excel Online (Business) → List rows present in a table

Hoe toevoegen: Tools-tab → + Add a tool → 'Excel Online (Business)' → 'List rows present in a table' → Add.

Parameters

File 08-region-data.xlsx (Teams-folder)
Table Regions
Filter Query auto, filter op region-naam
Description voor de orchestrator (Copilot Studio)

Use when user specifies region. Inputs: region. Output: rollout-%, conversie, top concurrent move.

Push-to-Teams-channel Connector, 1 klik

Connector + action: Microsoft Teams → Post message in a chat or channel

Hoe toevoegen: Tools-tab → + Add a tool → 'Teams' → 'Post message in a chat or channel' → Add.

Parameters

Post in Channel
Team test-team voor de workshop
Channel D2D-[regio]-test
Message auto, agent vult briefing in
Description voor de orchestrator (Copilot Studio)

Use ONLY after user confirms. Inputs: region + briefing. Output: Teams URL.

Hoe de prompt is opgebouwd (TCCO)

uitleg

TCCO is een framework om een goede systeemprompt te bouwen. Niet kopiëren, dit zit al verwerkt in de plak-en-klaar prompt rechts. Lees het om te begrijpen waaróm de prompt zo is opgebouwd.

Task
wat doet de agent?Maak per regio een korte maandag-briefing voor D2D-sales.
Context
voor wie / waar / waarover?Briefing landt vrijdag-middag, voor maandag-start, bij 1.5k field-force.
Constr.
wat mag de agent NOOIT?Onder 150 woorden. Geen prijzen verzinnen. Geen claims over concurrenten zonder bron. NL-taal, je-vorm.
Output
welk format / taal / lengte?1) Top-3 talking-points, 2) Propositie-changes, 3) Concurrent-alert, 4) Prio-wijken.

Testvraag

“Maak briefing voor het D2D-team Eindhoven voor maandag 12 oktober.”

Instructions-veld in Copilot Studio · plak dit

kopieer dit
# Taak
Maak per regio een korte maandag-briefing voor de KPN D2D-field-force met top-3 talking-points, propositie-changes, recente concurrent-bewegingen en prio-wijken.

# Context
Gebruikers zijn regio-managers; de briefing landt vrijdag-middag bij 1.5k field-force voor maandag-start. Energieke ochtend-toon.

# Beperkingen
- Geen prijzen verzinnen, alleen wat in 08-portfolio-actueel.txt staat.
- Concurrent-claims alleen als 08-concurrent-monitor.txt het bevestigt, anders weglaten.
- Roep Fetch-region-data aan met de regio-naam.
- Push-to-Teams-channel ALLEEN na bevestiging gebruiker.
- Web-search ALLEEN op de allow-list (vodafoneziggo.nl, t-mobile.nl, odido.nl, delta.nl, telegraaf.nl, fd.nl, ad.nl, marketingtribune.nl).
- Briefing onder 150 woorden. NL-taal, "je"-vorm.
- Geen marketing-superlatieven.
- Buiten scope (commissie, salaris, HR) → "Vraag aan je regio-manager."

# Output format
1. **Top-3 talking-points**: propositie-naam + 1 USP per regel
2. **Propositie-changes deze week**: 1-2 bullets, alleen als er iets verandert
3. **Concurrent-move alert**: 1 zin: "[concurrent] heeft [actie] in [gebied]"
4. **Prio-wijken**: 1-2 wijken met huidig rollout-% en waarom prio
5. Sluit af met één call-to-action: "Focus deze week op X."