Inactiviteitstrigger

Ontdek hoe u inactiviteitstriggers configureert, met begeleiding voor de opstelling, kanaalondersteuning, beperkingen en probleemoplossing.

Overzicht

De inactiviteitstrigger, ook wel OnInactivity genoemd, of De gebruiker is een tijdje inactief, is een systeemtrigger in Copilot Studio, die automatisch een onderwerp afvuurt wanneer een gebruiker gedurende een bepaalde periode geen bericht verstuurt. Het draait op de serverzijde, dus de agent beoordeelt de ontspanner en voert het onderwerp uit, zelfs als de client van de gebruiker inactief is.

Veelvoorkomende toepassingen zijn:

• Stuur een herinnering om te vragen of de gebruiker er nog is
• Maak agentcapaciteit vrij door automatisch inactieve gesprekken te sluiten
• Verzamel feedback (bijvoorbeeld een klanttevredenheidsenquête) voordat een sessie eindigt
• Schoon de sessiestatus voor verbroken gesprekken op

Hoe de inactiviteitstrigger werkt

Deze sectie legt uit hoe Copilot Studio inactiviteitstriggers beoordeelt, ontspanners plant en onderwerpen uitvoert wanneer een gesprek stilstaat.

Architectuuroverzicht

1. De gebruiker stuurt een bericht.

2. De runtime evalueert alle OnInactivity-triggers.

3. De runtime-groepen worden getriggerd op basis van de duur en selecteren er één per niveau. Het laagste prioriteitsnummer wint; de vroegste aanmaakdatum is doorslaggevend bij gelijke standen.

4. De runtime ordent de geselecteerde triggers op duur, het kortste eerst.

5. De runtime schakelt een ontspanner in voor de volgende trigger in Azure Service Bus. Er is maar één ontspanner tegelijk actief.

6. De gebruiker is inactief gedurende de geconfigureerde duur.

7. De ontspanner wordt geactiveerd en het inactiviteitsmoment wordt naar de runtime gestuurd.

8. De runtime komt overeen en het inactiviteitsonderwerp wordt uitgevoerd.

9. De runtime berekent de resterende tijd tot de volgende trigger en activeert een nieuwe ontspanner.

Belangrijke gedragingen

• De ontspanner wordt bij elk gebruikersbericht opnieuw ingesteld.

  Elke keer dat een gebruiker een bericht stuurt, beoordeelt het systeem alle inactiviteitstriggers opnieuw en activeert het de volgende (eerst de kortste duur). Er is maar één ontspanner tegelijk actief.

• Er worden meerdere triggers ondersteund.

  U kunt meerdere OnInactivity-triggers hebben voor verschillende duur (bijvoorbeeld 5 minuten en 10 minuten). Het systeem verwerkt ze in oplopende volgorde van duur. Per duurniveau wordt slechts één trigger geselecteerd. Als twee triggers dezelfde duur hebben, wordt de trigger met het lagere Priority nummer gestart. Als er nog steeds geen duidelijkheid is, wint de eerder gemaakte trigger. Het systeem verwijdert andere triggers met dezelfde duur.

• Triggers worden in de wachtrij geplaatst, niet parallel uitgevoerd.

  Er is maar één ontspanner tegelijk actief. Nadat de huidige trigger is uitgevoerd, berekent de runtime de resterende tijd tot de volgende trigger en activeert een nieuwe ontspanner voor het verschil. Het netto-effect is dat triggers worden geactiveerd op de juiste afstanden vanaf het punt van de oorspronkelijke inactiviteit, hoewel kleine afwijkingen kunnen optreden als het uitvoeren van de trigger veel tijd in beslag neemt.

• Achtergronduitvoering.

  De inactiviteitsgebeurtenis is een achtergrondtrigger. Het vereist geen gebruikersinteractie om te starten.

• Transcriptieopname.

  Het systeem registreert inactiviteitsgebeurtenissen in gesprekstranscripties. Na 30 minuten inactiviteit wordt een nieuw transcriptierecord aangemaakt.

Voorbeeldtijdlijn (meerdere triggers)

Als de gebruiker om 4.30 uur een bericht stuurt, worden beide ontspanners opnieuw ingesteld. Trigger A start om 9.30 uur en trigger B start om 14.30 uur.

Configureer de inactiviteitstrigger

Deze sectie laat zien hoe Copilot Studio inactiviteitsontspanners start, opnieuw instelt en uitvoert, zodat u kunt voorspellen wat er gebeurt als een gesprek stilstaat.

Maak een inactiviteitstriggeronderwerp aan

1. Ga in Copilot Studio naar Onderwerpen>Een onderwerp toevoegen>Leeg.

2. Selecteer de triggerzin. Selecteer in plaats van een zin "Na een periode van inactiviteit".

3. Stel de eigenschap Duur van inactiviteit in. In de modus Handmatige invoer kiest u een voorinstelling uit het dropdownmenu (15 minuten, 30 minuten, 45 minuten of 1 uur). Om een aangepaste waarde in seconden in te voeren of een Power Fx-formule (bijvoorbeeld, Global.TimeoutSeconds), schakelt u de modusselector naar Formule en typt u de waarde direct in.

4. Ontwerp de onderwerpstroom (stuur een bericht, stel een vraag, beëindig het gesprek, enzovoort).

5. Sla uw agent op en publiceer deze.

Verwijzing naar duur

Voorbeeld: enkele waarschuwingstrigger

[OnInactivity - 600 seconden]

Bericht: 'Ben je er nog? Antwoord om door te gaan.'

Onderwerp beëindigen

Voorbeeld: 5-minuten waarschuwing en 10-minuten autoclose

Dit patroon is het meest voorkomende. Maak twee inactiviteitsonderwerpen aan:

Onderwerp 1: Waarschuwing voor inactiviteit (5 minuten)

• Trigger: Na een periode van inactiviteit
• durationInSeconds: 300
• Acties: Stuur een bericht: "Bent u er nog? Dit gesprek wordt na 5 minuten gesloten als er geen reactie komt."

Onderwerp 2: Autoclose (10 minuten)

• Trigger: Na een periode van inactiviteit
• durationInSeconds: 600
• Acties:
  1. Stel Global.DeactivateInactivity = true (guardvariabele - zie Best Practices) in
  2. Stuur een bericht: "Dit gesprek wordt gesloten wegens inactiviteit."
  3. Gesprek beëindigen

Voorbeeld: Feedbackverzameling

• Trigger: Na een periode van inactiviteit
• durationInSeconds: 120
• Acties:
  1. Vraag: "Voordat u gaat, zou u uw ervaring willen beoordelen? (1-5)"
  2. De respons opslaan
  3. Gesprek beëindigen

Een voorwaarde toevoegen aan de trigger

Voeg direct na de trigger een knooppunt Conditie toe, zodat deze alleen in bepaalde situaties werkt:

• Alleen activeren voor een specifiek kanaal: =Activity.ChannelId = "msteams"
• Start alleen als er geen guard-variabele is ingesteld: =Global.DeactivateInactivity = false

Aanbevolen patroon voor meerdere triggers (gedeeld onderwerp)

Als u meerdere triggers hebt met Vraag-knooppunten, gebruik dan een gedeeld onderwerp om problemen met het stapelen van dialogen te vermijden:

1. Maak een gedeeld onderwerp aan genaamd HandleInactivity:

   • Voeg een algemene variabele Global.InactivityStage toe (Tekst)
   • Controleer de waarde:
     • "warning" → Stuur een waarschuwingsbericht met een Vraag-knooppunt ("Doorgaan?" / "Einde?")
     • "close" → Stuur een slotbericht en beëindig het gesprek

2. Eerste OnInactivity-trigger (300 seconden):

   • Global.InactivityStage = "warning" instellen:
   • Omleiden naar URL HandleInactivity

3. Tweede OnInactivity-trigger (600 seconden):

   • Global.InactivityStage = "close" instellen:
   • Omleiden naar URL HandleInactivity

Deze aanpak voorkomt dat Vraag-knooppunten zich opstapelen en prompt-lussen creëren.

Kanaalspecifieke configuratie

Kanaalondersteuningsmatrix

Teams-configuratie

Teams gebruikt een persistent model met één enkel gesprek. Het gesprek eindigt nooit echt vanuit het perspectief van Teams. Dit model betekent dat inactiviteittriggers opnieuw worden geactiveerd, ook als de gebruiker het gesprek als voltooid beschouwt.

Aanbevolen Teams-patronen:

1. Maak een algemene variabele aan Global.IsConversationClosed (Booleaans, standaard: false).

2. Controleer aan het begin van het onderwerp over inactiviteit het volgende: If Global.IsConversationClosed = true → Beëindig onderwerp (onmiddellijk afsluiten).

3. Wanneer het gesprek logisch eindigt (gebruiker zegt "dag", klanttevredenheid is voltooid, enzovoort), stel dan Global.IsConversationClosed = true in.

4. De inactiviteitstrigger kan nog steeds worden geactiveerd, maar wordt onmiddellijk beëindigd zonder een melding te tonen.

Configuratie van Dynamics 365 Customer Service

• Gesprekken sluiten standaard automatisch na 30 minuten inactiviteit.
• Alleen EndConversation aanroepen sluit de Dynamics 365 Customer Service-sessie niet af. Agentcapaciteit wordt niet vrijgemaakt.
• Om het gesprek volledig af te sluiten, stelt u de CloseOmnichannelConversation contextvariabele in op true via een Power Automate-stroom en gebruikt u vervolgens een Overdragen aan agent-knooppunt.

Bekende beperkingen

Korte referentie: wat kan de inactiviteitsontspanner verstoren?

Testpaneel ondersteunt geen inactiviteitstriggers

Het Copilot Studio-testpaneel activeert geen inactiviteitstriggers. Deze beperking is opzettelijk aangebracht. Publiceer uw agent en test op een livekanaal (demowebsite, Teams, enzovoort).

Microsoft 365 Copilot toont geen inactiviteitsberichten

De trigger wordt aan de serverzijde uitgevoerd, maar de uitvoer (berichten, kaarten) wordt niet geleverd aan de gebruiker in de Microsoft 365 Copilot-ervaring. Er is geen oplossing. Raadpleeg Bekende Teams-beperkingen.

Generatieve AI-indeling

Inactiviteitstriggers worden geïmplementeerd als onderwerptriggers voor klassieke indeling en gebruiken een afzonderlijke tijdgebaseerde gebeurtenispijplijn. Wanneer Generative AI-orkestratie wordt ingeschakeld, vertrouwt onderwerproutering niet langer op klassieke triggerherkenning, waardoor inactiviteitsonderwerpen mogelijk niet betrouwbaar in alle configuraties worden geactiveerd. Als inactiviteitsverwerking nodig is, is klassieke indeling de aanbevolen en volledig gevalideerde configuratie.

Verbonden agents: inactiviteit van onderliggende agents wordt niet ondersteund

In configuraties van verbonden agents werken inactiviteitstriggers in onderliggende agents niet en wordt Ongeldige respons van verbonden agent geretourneerd. neem alle logica voor inactiviteit in de bovenliggende agent op.

Maximale duur: 7 dagen (604.800 seconden)

Gepubliceerde bots negeren triggers met een duur langer dan 604.800 seconden in stilte. Er verschijnt geen foutmelding. In de ontwerpmodus kan een fout optreden. Er is geen verplicht minimum - korte duur (onder ongeveer 15 seconden) kan onvoorspelbaar zijn door latentie in de timerinfrastructuur.

Bij beëindigen van het gesprek worden de inactiviteitstimers gewist

Wanneer u Gesprek beëindigen in een onderwerp aanroept, stopt het permanent alle actieve inactiviteitsontspanners voor dat gesprek. De ontspanners zijn volledig verwijderd; ze worden niet opnieuw ingesteld of gepauzeerd. De bewerking verwijdert alle reeds geplande inactiviteitsgebeurtenissen.

Als u de stroom van een onderwerp wilt beëindigen zonder de inactiviteitsontspanners te verstoren, gebruik dan een van de alternatieve acties:

Het gebruik van een guard-variabele om opnieuw starten te voorkomen, blijft een aanbevolen verdedigingspraktijk.

Trigger wordt geactiveerd na agentescalatie

Nadat het systeem een gesprek heeft doorgestuurd naar een klantenservicemedewerker, blijft de inactiviteitstrigger actief. Deze kan tijdens het gesprek van de menselijke agent worden geactiveerd en onverwacht agentberichten verzenden. Roep altijd EndConversation aan vóór de transfer, of gebruik een guard-variabele.

Triggerberichten kunnen in transcripties verschijnen nadat het gesprek is beëindigd

Zelfs nadat een gesprek is afgesloten, kan de trigger nog steeds worden gestart en worden de berichten in de transcriptie opgenomen. Deze voorwaarde beïnvloedt de gebruikerservaring niet, maar kan wel in analyse voorkomen.

Telefoon-, spraak- en IVR-kanalen

De inactiviteitstrigger is niet beschikbaar voor telefoon- en spraakkanalen. Gebruik in plaats daarvan de OnSilence-trigger.

Algemene onjuiste configuraties

Gebruik deze sectie om veelvoorkomende configuratieproblemen te identificeren en op te lossen, die kunnen voorkomen dat inactiviteitstriggers zoals verwacht werken.

Beëindig het gesprek in het inactiviteitsonderwerp (lusrisico)

Probleem: wanneer u Gesprek beëindigen aanroept vanuit een inactiviteitsonderwerp, wist u alle inactiviteitstimers. Echter, op kanalen met aanhoudende gesprekken (vooral Teams) blijft het onderliggende gesprek actief. In sommige configuraties kan de trigger nog steeds opnieuw worden gestart, wat herhaalde berichten "sessie beëindigd" veroorzaakt.

Oplossing (aanbevolen als verdedigende oefening): gebruik een guard-variabele:

1. Maak Global.DeactivateInactivity (Booleaans, standaard: false).

2. Voeg bovenaan elk inactiviteitsonderwerp een voorwaarde toe: ga alleen door als Global.DeactivateInactivity = false.

3. Stel Global.DeactivateInactivity = truein voordat u EndConversation oproept.

Duur ingesteld op de verkeerde waarde

Probleem:durationInSeconds wordt weergegeven in seconden. Een waarde van 60000 is ongeveer 16,7 uur, niet 60 seconden.

Oplossing: controleer uw waarden dubbel aan de hand van de referentietabel in Sectie 3.

Vraagknooppunten in meerdere inactiviteitsonderwerpen (stapelen van prompts)

Probleem: als meerdere triggers elk een Vraagknooppunt hebben, onderbreekt het Vraagknooppunt van de tweede trigger de eerste. Wanneer de gebruiker antwoordt, hervat het eerste Vraagknooppunt en begint deze opnieuw vragen te stellen, waardoor een lus ontstaat.

Oplossing: gebruik het gedeelde onderwerppatroon. Voeg de logica van het Vraagknooppunt samen tot één onderwerp, of zorg ervoor dat slechts één trigger een Vraagknooppunt heeft.

Globale variabelen wissen in het inactiviteitsonderwerp

Probleem: als het inactiviteitsonderwerp globale variabelen wist, verliest de agent alle gesprekscontext en reageert deze niet wanneer de gebruiker terugkeert.

Oplossing: stel alleen inactiviteitsspecifieke variabelen in, niet de hele gespreksstatus.

Inactiviteitstriggers in Teams worden niet geblokkeerd

Probleem: In Teams betekent het permanente gespreksmodel dat triggers voor onbepaalde tijd worden geactiveerd. Gebruikers ontvangen uren of dagen later herhaaldelijk berichten "Bent u er nog?"

Oplossing: gebruik altijd het gating-variabelenpatroon voor Teams.

CloseOmnichannelConversation wordt niet aangeroepen

Probleem: voor Dynamics 365 Customer Service-agents sluit alleen het aanroepen van EndConversation de Dynamics 365 Customer Service-sessie niet af. Gesprekken stapelen zich op in de agentenwachtrij.

Oplossing: stel CloseOmnichannelConversation in op true via Power Automate in uw inactiviteitsonderwerp.

Dynamische duur van een niet-geïnitialiseerde variabele

Probleem: het gebruik van een Power Fx-expressie, zoals =Environment.InactivityTimeout voor de duur werkt, maar als de variabele niet geïnitialiseerd of null is, wordt de trigger stilletjes uitgesloten.

Oplossing: zorg ervoor dat alle variabelen die in triggercondities en duurexpressies worden gebruikt, geldige standaardwaarden hebben.

Verwachten dat triggers werken na agentescalatie

Probleem: nadat het systeem is overgeschakeld naar een klantenservicemedewerker wordt de trigger afgevuurd bij het oorspronkelijke agentgesprek en stuurt het berichten tijdens de menselijke agent-sessie.

Oplossing: beëindig het agentgesprek bij escalatie, of gebruik een guard-variabele Global.IsEscalated = true en controleer die aan het begin van het inactiviteitsonderwerp.

Los problemen op wanneer de inactiviteitstrigger niet werkt

Gebruik deze beslissingsboom om het probleem te diagnosticeren:

1. Waar bent u aan het testen?

   • Stop als u het testpaneel gebruikt. Het testpaneel ondersteunt geen inactiviteitstriggers. Publiceer en test op een live kanaal.

2. Welk kanaal gebruikt u?

   • Microsoft 365 Copilot? Dit kanaal heeft een bekende beperking. Trigger wordt geactiveerd, maar berichten worden niet bezorgd. Geen oplossing.
   • Telefonie/IVR? Dit kanaal wordt niet ondersteund. Gebruik in plaats daarvan de OnSilence-trigger.

3. Is generatieve AI-indeling ingeschakeld?

   • Inactiviteitstriggers gebruiken een aparte ontspannerspijplijn van herkenningsgebaseerde routering. Hun gedrag met generatieve AI-indeling is echter niet volledig gevalideerd. Als inactiviteitsbehandeling cruciaal is, wordt een klassieke indeling aanbevolen als configuratie.

4. Is uw durationInSeconds meer dan 604.800?

   • Als dat zo is, wordt de trigger stilletjes genegeerd. Verminder tot 604.800 of minder.

5. Is de agent een onderliggende agent in een configuratie van een verbonden agent?

   • Zo ja, dan worden inactiviteitstriggers van ondergeschikte agents niet ondersteund. Verplaats de logica naar de hoofdagent.

6. Hebt u meerdere triggers voor inactiviteit?

   • Ze worden in volgorde van duur geactiveerd (de kortste als eerste). Zorg dat u lang genoeg wacht. Elke gebruikersmelding stelt alle timers opnieuw in.

7. Heeft de trigger een voorwaarde die verwijst naar een niet-geïnitialiseerde variabele?

   • Als een voorwaarde verwijst naar een variabele die nog niet is ingesteld, wordt de trigger stilletjes uitgesloten. Zorg ervoor dat alle conditievariabelen standaardwaarden hebben.

8. Werd de agent opnieuw uitgegeven nadat het gesprek was begonnen?

   • Een herpublicatie kan de ontspanner voor actieve sessies opnieuw instellen. Begin een nieuw gesprek en test opnieuw.

Als de inactiviteitstrigger nog steeds niet werkt, probeer dan de volgende opties:

• Controleer gesprekstranscripties op eventuele activiteiten in op het gebied van inactiviteitsonderwerpen. Als het onderwerp verschijnt maar de gebruiker het bericht niet heeft gezien, is het probleem kanaalspecifieke levering.
• Controleer of het onderwerp niet is uitgeschakeld of gearchiveerd.
• Controleer of het triggertype 'Na een periode van inactiviteit' is in plaats van een zinstrigger.

Aanbevolen procedures

• Test altijd op een gepubliceerd kanaal. Gebruik de demowebsite voor snelle tests. Vertrouw nooit op het testpaneel.

• Gebruik een guard-variabele om lussen te voorkomen. Maak Global.DeactivateInactivity (Booleaans, standaard false). Stel dit in op true voordat u EndConversation aanroept. Controleer aan het begin van elk inactiviteitsonderwerp.

• Houd de duur redelijk. Minimaal ~15 seconden, maximaal 604.800 seconden (7 dagen).

• Verifieer uw eenheden. Het eigenschap is binnen enkele seconden. 5 minuten = 300, niet 5.

• Voor Dynamics 365 Customer Service: altijd koppelen EndConversation met closeOmnichannelConversation via Power Automate.

• Voor scenario's met meerdere triggers: beperk de Vraagknooppunten tot één trigger, of gebruik het gedeelde onderwerppatroon.

• Roep EndConversation aan voordat u doorschakelt naar een klantenservicemedewerker om inactiviteitstriggers te deactiveren.

• Monitor gesprektranscripties na de implementatie om te verifiëren dat berichten op de verwachte tijden verschijnen.

Veelgestelde vragen

Waarom werkt de inactiviteitstrigger niet in het testpaneel?

Ontspanners zijn in het testpaneel standaard uitgeschakeld. Publiceer uw agent en test op een live kanaal.

Kan ik dynamische duur gebruiken (bijvoorbeeld van een variabele)?

Ja. Het duurveld accepteert Power Fx-expressies. U kunt een omgevingsvariabele of berekende waarde gebruiken. De expressie wordt tijdens runtime geëvalueerd wanneer de timer wordt geactiveerd. Zorg ervoor dat de variabele geïnitialiseerd is en een geldig nummer bevat.

Wat gebeurt er als ik een nieuwe agentversie publiceer terwijl de gesprekken actief zijn?

De speelduur neemt de nieuwe versie over. Als de trigger-ID is veranderd (onderwerp verwijderd en opnieuw aangemaakt), valt het systeem terug op matching op basis van de duur. Als er geen triggers overeenkomen op id of duur, wordt de inactiviteitsgebeurtenis in behandeling verwijderd.

Hoe kan ik inactiviteitstriggers in Teams volledig stoppen?

U kunt ze niet stoppen op platformniveau. Gebruik het patroon van de blokkeringsvariabele: stel een Booleaanse waarde in wanneer het gesprek logisch eindigt en controleer dit aan het begin van het inactiviteitsonderwerp om vroeg af te sluiten.

Werkt de inactiviteitstrigger met verificatie?

Ja, maar bij lange sessie-timeouts (bijvoorbeeld 24 uur) kan het verificatietoken van de gebruiker verlopen voordat de trigger start. Zorg ervoor dat uw agent de herverificatie soepel verwerkt.

Wat gebeurt er als mijn inactiviteitsonderwerp een connector aanroept die veel tijd kost?

Connectorgesprekken hebben een timeout-limiet (30 seconden standaard, maximaal 60 seconden). Optimaliseer de connector of verwerk de time-out soepel.

Gerelateerde inhoud

• Triggers voor onderwerpen instellen
• Systeemvariabelen — InactivityTimer.Continue, InactivityTimer.Count
• Gebruik Power FX in Copilot Studio
• Dynamics 365 Customer Service-overdracht configureren
• Spraakconfiguratie en stiltedetectie
• Agenten voor Teams implementeren
• Verbonden agents
• Transcripties van gesprekken in Copilot Studio
• Omnichannel-gesprekken automatisch sluiten
• Bekende beperkingen in Microsoft 365 Copilot