Agenten implementeren in Microsoft Teams

Microsoft Teams brengt unieke implementatie-uitdagingen met zich mee voor Copilot Studio-agenten vanwege zijn persistente gespreksomgeving. In tegenstelling tot webgebaseerde implementaties waarbij sessies automatisch worden gereset, blijven gespreksthreads in Teams onbeperkt bestaan, wat kan leiden tot verouderde context, verlopen tokens en verouderde inhoud in de cache.

Dit artikel biedt richtlijnen voor het effectief implementeren van Copilot Studio-agenten in Teams. U leert hoe u persistente sessies beheert, foutopsporingsstrategieën implementeert en betrouwbare prestaties gedurende verlengde gesprekslevenscycli waarborgt.

Belangrijke overwegingen die worden behandeld:

• Beheer van de sessielevenscyclus en afhandeling van inactiviteit
• Foutopsporingstechnieken voor persistente gesprekken
• Versiebeheer en strategieën voor de implementatie van updates
• Teams-specifieke implementatiepatronen

Volg deze praktijken om robuuste agenten te creëren die consistent presteren in de Teams-omgeving en duidelijke feedback geven aan gebruikers over statuswijzigingen en systeemgedrag.

Waarom een Teams-implementatie anders is

Teams-gesprekken blijven meerdere dagen beschikbaar zonder automatische reset. In tegenstelling tot Webchat-sessies wordt de ConversationStart-gebeurtenis alleen geactiveerd zodra er voor het eerst een agent wordt toegevoegd. Het opnieuw installeren van de app activeert deze gebeurtenis niet opnieuw.

Het persistente karakter van Teams brengt verschillende risico's met zich mee:

• Verouderde context: de gespreksgeschiedenis blijft bewaard, tenzij deze wordt gewist.
• Verlopen tokens: Connectors kunnen verlopen tijdens lange sessies.
• Contextlimieten: Zich ophopende berichten kunnen de modellimieten overschrijden.
• Caching bij updates: Gebruikers kunnen mogelijk tijdelijk blijven werken met verouderde logica.

Proactief statusbeheer en duidelijke gebruikersbegeleiding zijn essentieel.

De sessielevenscyclus beheren

Beheer de sessielevenscyclus met inactiviteitsbeheer.

Resets bij inactiviteit implementeren

Maak een nieuw onderwerp aan en selecteer de trigger De gebruiker is een bepaalde tijd inactief om na een periode van gebruikersinactiviteit een resetproces te starten. Meer informatie vindt u in Inactiviteitstrigger over Teams-specifieke patronen, waaronder beschermingsvariabelen en het permanente gespreksmodel.

1. Voeg de inactiviteitstrigger toe en stel een time-out in (bijvoorbeeld 15 minuten).
2. Voeg één of meer Waarden van variabelen wissen-knooppunten toe om sessievariabelen en gespreksgeschiedenis te verwijderen en zo context-overloop te voorkomen.
3. Beëindig het gesprek en markeer de sessie als opgelost.

Deze aanpak voorkomt context-overloop en zorgt voor voorspelbaar gedrag wanneer een gebruiker terugkeert.

Begeleiding bieden na een reset

Stuur na het wissen van de gespreksstatus een bericht dat uitlegt wat er is gebeurd. Bijvoorbeeld: "Het lijkt erop dat ons gesprek inactief is geworden, dus ik wis de vorige context om veiligheidsredenen. Zeg 'hallo' om opnieuw te beginnen."

Omdat ConversationStart slechts één keer wordt geactiveerd, de eerste keer dat een agent wordt toegevoegd, wordt het onderwerp Begroeting uw daadwerkelijke beginpunt. Door de gebruiker aan te moedigen om "hallo" te zeggen, garandeert u dat de opstartlogica juist functioneert.

Bied een selfservice-resetopdracht aan

Voeg een melding toe die gebruikers informeert dat ze een specifiek commando kunnen typen: "Als er iets niet lijkt te kloppen, probeer dan /debug clearstate te typen om mijn status te vernieuwen."

Deze opdracht zorgt voor een volledige reset van het gesprek:

• De gespreksstatus wordt gewist
• Connectorinformatie wordt uit de cache verwijderd
• Connectors worden opnieuw geverifieerd
• De nieuwste versie van de agent wordt geladen

Gebruik deze opdracht in de volgende gevallen:

• De bot lijkt "te blijven zitten" met verouderde informatie
• Connectorverificatie is verlopen
• Na updates van de botlogica
• Wanneer gedrag inconsistent lijkt

De transparantie vergroten en de foutopsporing verbeteren

Als u de transparantie wilt vergroten en de foutopsporing wilt verbeteren voor agenten die in Teams zijn geïmplementeerd, gebruikt u de trigger OnKnowledgeRequested.

OnKnowledgeRequested gebruiken om herschreven query's te onthullen

Copilot Studio herschrijft gebruikersvragen alvorens gegevens op te halen. Als u de trigger OnKnowledgeRequested inschakelt, kunt u:

• Fouten in intentieherkenning diagnosticeren
• Begrijpen hoe query's worden herschreven
• Het vertrouwen van gebruikers vergroten tijdens de foutopsporing

Voeg een bericht toe dat zowel gegenereerde trefwoordquery's als semantische query's toont. Bijvoorbeeld:

kind: AdaptiveDialog
beginDialog:
  kind: OnKnowledgeRequested
  id: main
  actions:
    - kind: SendActivity
      id: sendActivity_debug
      activity: |-    
        **Debug**: sending this lexical query "{System.KnowledgeSearchQuery}"
        **Debug**: sending this semantic query "{System.SearchQuery}"
inputType: {}
outputType: {}

Deze query biedt alleen-lezen toegang tot de verfijnde zoekquery (query herschrijven) die de orchestrator heeft gegenereerd op basis van de vraag van de gebruiker.

Voordelen:

• Helpt bij het opsporen van fouten bij de intentieherkenning.
• Laat gebruikers zien wat de agent opzoekt.
• Vergroot het vertrouwen in de acties van de agent.
• Helpt makers tijdens het testen.

Versiebeheer en betrouwbaarheid van updates

Vooral in een persistente omgeving, zoals Teams, is het van groot belang dat agentversies worden beheerd en dat ervoor wordt gezorgd dat gebruikers steeds met de nieuwste logica werken.

Botversie in begroeting of binnen een speciaal onderwerp weergeven

Voeg een versienummer toe door het begroetingsonderwerp of een speciaal versieonderwerp te gebruiken:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Werk deze waarde bij bij elke publicatie om gebruikers en ondersteuningsteams te helpen verifiëren welke build actief is. Bij het bijwerken van de versiemetagegevens wordt ook de inhoud in cache vernieuwd. Het wijzigen van de naam of beschrijving van de agent zorgt ervoor dat Teams deze als een nieuwe update laadt.

Schakel "Nieuwste versie forceren" in bij het publiceren

De instelling Nieuwste versie forceren zorgt ervoor dat Teams de nieuwste agentlogica laadt zodra de gebruiker weer een bericht stuurt. Deze instelling helpt ook om versies in cache ongeldig te maken. Het forceren van een update onderbreekt echter elk lopend gesprek.

Teams-specifieke implementatieoverwegingen

Teams heeft uniek gedrag dat extra aandacht vereist.

Het begroetingsonderwerp als uw opstartlogica behandelen

Omdat ConversationStart slechts één keer wordt geactiveerd wanneer een agent voor het eerst wordt toegevoegd, doet u het volgende:

• Plaats initialisatielogica in Begroeting.
• Voeg duidelijke instructies toe in de beschrijving van de Teams-app.
• Herinner gebruikers eraan: "Typ na een time-out 'hallo' om een nieuw gesprek te starten."

Triggers en fallbacks optimaliseren

Teams-gebruikers communiceren natuurlijk en onvoorspelbaar. Zorg ervoor dat uw bot:

• Meerdere begroetingsvariaties verwerkt.
• Ondersteuning voor afscheidsgroeten biedt.
• Meerdere voorbeelduitingen biedt.
• Vriendelijke en behulpzame standaardresponsen geeft wanneer deze een verzoek niet begrijpt.
• Trefwoorden gebruikt om gebruikers naar relevante onderwerpen te leiden.
• OnKnowledgeRequested gebruikt om gemiste intenties te diagnosticeren.
• Verwijst naar relevante onderwerpen op basis van trefwoorden.
• Gebruikers aanspoort om de vraag opnieuw te formuleren als de bot er echt niet uitkomt.

Het verificatiegedrag van de connector valideren

Wanneer u connectors gebruikt (ServiceNow, Outlook en andere), moet u het volgende testen:

• Hoe de eerste aanmeldingskaart zich gedraagt.
• Wat er gebeurt als het token verloopt en hoe het automatisch wordt vernieuwd.
• Hoe geforceerde invalidatie en stromen voor het opnieuw verlenen van toestemming werken.

Testen onder echte omstandigheden

Omdat Teams de status voor sessies behoudt, moeten uw tests de echte gebruikerservaring weerspiegelen:

1. Implementeer door Tonen aan mij alleen te gebruiken.
2. Test langlopende scenario's (waarin u na enkele uren terugkeert).
3. Publiceer updates en controleer of de agent naar de nieuwste versies overschakelt.
4. Valideer de rendering van adaptieve kaarten op desktop en mobiel.
5. Test acties in diverse gespreksomgevingen.

Implementatiechecklist

Belangrijkste punten

• Beheer de levenscyclus van de sessie door inactiviteitstriggers te configureren en opties voor het wissen van de status te gebruiken wanneer dat gepast is.
• Verbeter de transparantie door systeemactiviteit zichtbaar te maken via query-herschrijvingen en statusgerelateerde berichten.
• Houd rekening met Teams-specifiek gedrag, zoals het behandelen van handmatige begroetingen en het beheren van persistent geheugen.
• Zorg dat agenten betrouwbaar blijven door versiebeheer toe te passen en updates af te dwingen wanneer nodig.
• Ondersteun de autonomie van gebruikers door opdrachten voor self‑service-probleemoplossing en begeleide herstelopties aan te bieden.

Gerelateerde informatie

• Een agent voor Teams en Microsoft 365 Copilot verbinden en configureren
• Belangrijke concepten: uw agent publiceren en implementeren