Inactiviteitstrigger

Meer informatie over het configureren van inactiviteitstriggers, met richtlijnen voor configuratie, kanaalondersteuning, beperkingen en probleemoplossing.

Overzicht

De inactiviteittrigger, ook wel OnInactivity of De gebruiker is al een tijdje inactief, is een systeemtrigger in Copilot Studio die automatisch een onderwerp activeert wanneer een gebruiker gedurende een bepaalde periode geen bericht verzendt. Het draait aan de serverzijde, zodat de agent de timer kan evalueren en de taak kan uitvoeren, zelfs als de cliënt van de gebruiker niet actief is.

Veelvoorkomende gebruiksvoorbeelden zijn:

• Een herinnering verzenden waarin wordt gevraagd of de gebruiker nog steeds aanwezig is
• Capaciteit van agents vrijmaken door niet-actieve gesprekken automatisch te sluiten
• Feedback verzamelen (bijvoorbeeld een klanttevredenheidsenquête) voordat een sessie eindigt
• Sessiestatus opschonen voor verlaten gesprekken

Hoe de inactiviteittrigger werkt

In deze sectie wordt uitgelegd hoe Copilot Studio inactiviteittriggers evalueert, timers plant en onderwerpen uitvoert wanneer een gesprek niet actief is.

Overzicht van architectuur

1. De gebruiker verzendt een bericht.

2. De runtime evalueert alle OnInactivity-triggers .

3. De runtime groepeert triggers op basis van duur en selecteert één per duurlaag. Het laagste prioriteitsnummer wint; de vroegste aanmaakdatum vormt de doorslag.

4. Met de runtime worden de geselecteerde triggers op duur, kortste eerste, gerangschikt.

5. De runtime zorgt voor een timer voor de volgende trigger in Azure Service Bus. Er is slechts één timer tegelijk actief.

6. De gebruiker is inactief voor de geconfigureerde duur.

7. De timer wordt geactiveerd en de inactiviteitsgebeurtenis wordt naar de runtime verzonden.

8. De runtime komt overeen en voert het onderwerp inactiviteit uit.

9. De runtime berekent de resterende tijd tot de volgende activatie en zet een nieuwe timer aan.

Sleutelgedrag

• Timer wordt opnieuw ingesteld op elk gebruikersbericht.

  Telkens wanneer een gebruiker een bericht verzendt, worden alle inactiviteitstriggers opnieuw geëvalueerd en wordt de volgende geactiveerd (kortste duur eerst). Slechts één timer is op elk gewenst moment actief.

• Er worden meerdere triggers ondersteund.

  U kunt meerdere OnInactivity-triggers hebben op verschillende duur (bijvoorbeeld 5 minuten en 10 minuten). Het systeem verwerkt ze in oplopende volgorde van duur. Er wordt slechts één trigger geselecteerd per duurlaag. Als twee triggers dezelfde duur hebben, wordt de trigger met het lagere Priority aantal geactiveerd. Als er nog steeds een gelijkspel is, wint de eerder aangemaakte trigger. Het systeem verwijdert andere triggers met dezelfde duur.

• Triggers worden in de wachtrij geplaatst, niet parallel.

  Er is slechts één timer tegelijk actief. Nadat de huidige trigger is uitgevoerd, berekent de runtime de resterende tijd tot de volgende trigger en stelt een nieuwe timer in 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.

  Het inactiviteitsevenement is een achtergrondtrigger. Er is geen gebruikersinteractie nodig om het te activeren.

• Transcript opname

  Het systeem registreert inactiviteitsevenementen in gesprektranscripties. Er wordt na 30 minuten inactiviteit een nieuwe transcriptierecord gemaakt.

Voorbeeldtijdlijn (meerdere triggers)

Als de gebruiker een bericht om 4:30 verzendt, worden beide timers opnieuw ingesteld. Trigger A brandt om 9:30 en Trigger B brandt om 14:30 uur.

De trigger voor inactiviteit configureren

In deze sectie ziet u hoe Copilot Studio timers voor inactiviteit start, opnieuw instelt en uitvoert, zodat u kunt voorspellen wat er gebeurt wanneer een gesprek niet actief wordt.

Een inactiviteittriggeronderwerp maken

1. Ga in Copilot Studio naar Topics>Onderwerp toevoegen>Leeg.

2. Selecteer de triggeruitdrukking. In plaats van een woordgroep selecteert u 'Na een periode van inactiviteit'.

3. Stel de eigenschap Inactiviteitsduur in. Kies in de handmatige invoermodus een voorinstelling in de vervolgkeuzelijst (15 minuten, 30 minuten, 45 minuten of 1 uur). Als u een aangepaste waarde in seconden of een Power Fx-formule wilt invoeren (bijvoorbeeld Global.TimeoutSeconds), zet u de moduskiezer op Formule en typt u de waarde rechtstreeks.

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

5. Sla uw agent op en publiceer deze.

Naslaginformatie over duur

Voorbeeld: Enkele waarschuwingstrigger

[OnInactivity - 600 seconden]

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

Onderwerp beëindigen

Voorbeeld: waarschuwing van 5 minuten en automatisch sluiten van 10 minuten

Dit patroon is het meest voorkomende. Twee onderwerpen over inactiviteit maken:

Onderwerp 1: Waarschuwing over inactiviteit (5 minuten)

• Trigger: Na een periode van inactiviteit
• durationInSeconds: 300
• Acties: Een bericht verzenden: 'Bent u er nog? Dit gesprek wordt over 5 minuten gesloten als er geen antwoord is."

Onderwerp 2: Automatisch sluiten (10 minuten)

• Trigger: Na een periode van inactiviteit
• durationInSeconds: 600
• Actions:
  1. Instellen Global.DeactivateInactivity = true (beveiligingsvariabele - zie Beste praktijken)
  2. Een bericht verzenden: 'Dit gesprek wordt gesloten vanwege inactiviteit'.
  3. Gesprek beëindigen

Voorbeeld: Feedbackverzameling

• Trigger: Na een periode van inactiviteit
• durationInSeconds: 120
• Actions:
  1. Vraag: "Voordat je gaat, zou je je ervaring beoordelen? (1-5)"
  2. Het antwoord opslaan
  3. Gesprek beëindigen

Een voorwaarde toevoegen aan de trigger

Voeg een voorwaardeknooppunt toe direct na de trigger, zodat het alleen in bepaalde situaties wordt uitgevoerd:

• Vuur alleen op een specifiek kanaal: =Activity.ChannelId = "msteams"
• Vuur alleen als een beveiligingsvariabele niet is ingesteld: =Global.DeactivateInactivity = false

Aanbevolen patroon voor meerdere triggers (gedeeld onderwerp)

Als u meerdere triggers met vraagknooppunten hebt, gebruikt u een gedeeld onderwerp om problemen met het stapelen van dialoogvensters te voorkomen:

1. Maak een gedeeld onderwerp met de naam HandleInactivity:

   • Een globale variabele Global.InactivityStage toevoegen (tekst)
   • Controleer de waarde:
     • "warning" → een waarschuwingsbericht verzenden met een vraagknooppunt ('Doorgaan?' / 'Einde?')
     • "close" → Een sluitend bericht en een eindgesprek verzenden

2. Eerste OnInactivity-trigger (300 seconden):

   • Stel Global.InactivityStage = "warning" in
   • Omleiden naar HandleInactivity

3. Tweede OnInactivity-trigger (600 seconden):

   • Stel Global.InactivityStage = "close" in
   • Omleiden naar HandleInactivity

Met deze methode voorkomt u dat de vraagknooppunten zich stapelen en promptlussen creëren.

Kanaalspecifieke configuratie

Kanaalondersteuningsmatrix

Teams-configuratie

Teams maakt gebruik van een permanent model voor één gesprek. Het gesprek eindigt nooit echt vanuit het perspectief van Teams. Dit model betekent dat inactiviteittriggers opnieuw worden geactiveerd , zelfs nadat de gebruiker het gesprek heeft uitgevoerd.

Aanbevolen Teams-patroon:

1. Een globale variabele maken (Booleaanse waarde Global.IsConversationClosed , standaard: false).

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

3. Wanneer het gesprek logisch eindigt (de gebruiker zegt 'afscheid', wordt de klanttevredenheid voltooid, enzovoort), stel Global.IsConversationClosed = true in.

4. De inactiviteit-trigger kan nog steeds worden geactiveerd, maar beëindigt onmiddellijk zonder een melding te tonen.

configuratie van Dynamics 365 Customer Service

• Gesprekken worden standaard automatisch gesloten na 30 minuten inactiviteit.
• Als u EndConversation alleen aanroept, wordt de Dynamics 365 Customer Service-sessie niet gesloten. De capaciteit van de agent wordt niet vrijgemaakt.
• Als u het gesprek volledig wilt sluiten, stelt u de contextvariabele CloseOmnichannelConversation in op true via een Power Automate-stroom en gebruikt u vervolgens een knooppunt Overdracht naar agent.

Bekende beperkingen

Snelzoekgids: Wat kan de timer voor inactiviteit verstoren?

Het testvenster biedt geen ondersteuning voor triggers voor inactiviteit

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 geeft geen inactiviteitsberichten weer

De trigger voert serverzijde uit, maar uitvoer (berichten, kaarten) wordt niet bezorgd aan de gebruiker in de Microsoft 365 Copilot ervaring. Er is geen tijdelijke oplossing. Bekijk bekende beperkingen van Teams.

Generatieve AI-orkestratie

Inactiviteitstriggers worden geïmplementeerd als klassieke orkestratietriggers en gebruiken een afzonderlijke tijdgebaseerde gebeurtenispijplijn. Wanneer Generatieve AI-indeling is ingeschakeld, is onderwerproutering niet langer afhankelijk van klassieke triggerherkenning. Inactiviteitsonderwerpen worden dus mogelijk niet betrouwbaar geactiveerd in alle configuraties. Als verwerking van inactiviteit vereist is, is klassieke orkestratie de aanbevolen en volledig gevalideerde configuratie.

Verbonden agents: inactiviteit van subagenten wordt niet ondersteund

In configuraties van verbonden agenten werken inactiviteitstriggers in onderliggende agenten niet en wordt "Ongeldig antwoord van verbonden agent" geretourneerd. Plaats alle logica voor inactiviteit in de hoofdagent.

Maximale duur: 7 dagen (604.800 seconden)

Gepubliceerde bots negeren stilletjes triggers met een duur die langer is dan 604.800 seconden. Er wordt geen fout weergegeven. In de ontwerpmodus kan er een fout optreden. Er is geen afgedwongen minimum: korte duur (minder dan 15 seconden) kan onvoorspelbaar gedrag vertonen vanwege latentie van de timerinfrastructuur.

Beëindigen van het gesprek wist de inactiviteitstimers

Wanneer u gesprek beëindigen in een onderwerp aanroept, worden alle actieve timers voor inactiviteit voor dat gesprek definitief gestopt . De timers worden volledig gewist; ze worden niet opnieuw ingesteld of onderbroken. Met de bewerking worden alle reeds geplande inactiviteitsevenementen geannuleerd.

Als u de stroom van een onderwerp wilt beëindigen zonder timers voor inactiviteit te onderbreken, gebruikt u een van de alternatieve acties:

Het gebruik van een guard variabele om te voorkomen dat deze opnieuw wordt geactiveerd, blijft een aanbevolen verdedigingspraktijk.

Trigger wordt geactiveerd na escalatie naar een agent

Nadat het systeem een gesprek heeft overgedragen aan een vertegenwoordiger van de klantenservice, blijft de trigger voor inactiviteit actief. Het kan tijdens het gesprek van de menselijke agent worden geactiveerd en onverwacht berichten van de agent verzenden. Roep EndConversation altijd aan vóór de overdracht of gebruik een beveiligingsvariabele.

Triggerberichten worden mogelijk weergegeven in transcripties nadat het gesprek is beëindigd

Zelfs nadat een gesprek is gesloten, kan de trigger nog steeds worden geactiveerd en worden de bijbehorende berichten vastgelegd in het transcript. Deze voorwaarde heeft geen invloed op de gebruikerservaring, maar wordt mogelijk weergegeven in analyse.

Telefoon-, spraak- en IVR-kanalen

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

Veelvoorkomende onjuiste configuraties

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

Gesprek beëindigen in het onderwerp over inactiviteit (lusrisico)

Probleem: Wanneer u Gesprek Beëindigen aanroept vanuit een inactiviteitsthema, wist u alle timers voor inactiviteit. Op kanalen met permanente gesprekken (met name Teams) blijft het onderliggende gesprek echter actief. In sommige configuraties kan de trigger nog steeds opnieuw worden geactiveerd, waardoor herhaalde 'sessie beëindigde' berichten worden veroorzaakt.

Oplossing (aanbevolen als defensieve praktijk): Een beveiligingsvariabele gebruiken:

1. Maken Global.DeactivateInactivity (Booleaanse waarde, standaard: false).

2. Voeg boven aan elk onderwerp over inactiviteit een voorwaarde toe: ga alleen verder als Global.DeactivateInactivity = false.

3. Stel Global.DeactivateInactivity = truevoordat u EndConversation aanroept.

Duur ingesteld op de verkeerde waarde

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

Oplossing: Controleer uw waarden op basis van de verwijzingstabel in sectie 3.

Vraagknooppunten in meerdere onderwerpen over inactiviteit (promptstacking)

Probleem: Als meerdere triggers elk een vraagknooppunt hebben, onderbreekt het tweede vraagknooppunt de eerste. Wanneer de gebruiker antwoordt, wordt het eerste vraagknooppunt hervat en opnieuw uitgevoerd, waardoor er een lus wordt gemaakt.

Oplossing: Gebruik het patroon voor gedeelde onderwerpen. Voeg de logica van het vraagknooppunt samen in één onderwerp of zorg ervoor dat slechts één trigger een vraagknooppunt heeft.

Globale variabelen wissen in het onderwerp over inactiviteit

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

Oplossing: Alleen inactiviteitspecifieke variabelen opnieuw instellen, niet de volledige gespreksstatus.

Inactiviteitstriggers in Teams niet blokkeren

Probleem: In Teams betekent het permanente gespreksmodel dat triggers voor onbepaalde tijd worden geactiveerd. Gebruikers ontvangen herhaalde berichten 'bent u nog steeds aanwezig?'-berichten uren of dagen later.

Oplossing: Gebruik altijd het patroon van de gatingsvariabele voor Teams.

CloseOmnichannelConversation niet aanroepen

Problem: Voor Dynamics 365 Customer Service-agents sluit het aanroepen van EndConversation alleen de Dynamics 365 Customer Service sessie niet. Gesprekken stapelen zich op in de wachtrij van agents.

Solution: 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 op de achtergrond uitgesloten.

Oplossing: Zorg ervoor dat alle variabelen die worden gebruikt in triggervoorwaarden en duurexpressies geldige standaardwaarden hebben.

Verwachting dat triggers werken na escalatie van een agent

Probleem: Nadat het systeem is overgedragen aan een vertegenwoordiger van de klantenservice, wordt de trigger geactiveerd op het oorspronkelijke agentgesprek en worden berichten verzonden tijdens de sessie van de menselijke agent.

Oplossing: Beëindig het gesprek met de agent tijdens escalatie of gebruik een beveiligingsvariabele Global.IsEscalated = true en controleer deze aan het begin van het onderwerp over inactiviteit.

Problemen oplossen wanneer de trigger voor inactiviteit niet werkt

Gebruik deze beslissingsstructuur om het probleem te diagnosticeren:

1. Waar test je?

   • Als u het testpaneel gebruikt, stop dan. Het testpaneel biedt geen ondersteuning voor triggers voor inactiviteit. Publiceer en test op een livekanaal.

2. Welk kanaal gebruikt u?

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

3. Is Generatieve AI-indeling ingeschakeld?

   • Inactiviteitstriggers gebruiken een afzonderlijke timerpijplijn dan herkenningsgebaseerde routering. Hun gedrag met generatieve AI-orkestratie is echter niet volledig gevalideerd. Als de verwerking van inactiviteit kritiek is, is klassieke orkestratie de aanbevolen configuratie.

4. Is je durationInSeconds groter dan 604,800?

   • Zo ja, dan wordt de trigger stilzwijgend genegeerd. Verminder tot 604.800 of lager.

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

   • Zo ja, worden triggers voor inactiviteit van ondergeschikte agents niet ondersteund. Verplaats de logica naar de bovenliggende agent.

6. Hebt u meerdere triggers voor inactiviteit?

   • Ze worden afgevuurd in volgorde van duur (kortste eerst). Zorg ervoor dat je lang genoeg wacht. Elk gebruikersbericht 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 op de achtergrond uitgesloten. Zorg ervoor dat alle voorwaardevariabelen standaardwaarden hebben.

8. Is de agent opnieuw gepubliceerd nadat het gesprek is gestart?

   • Een herpublicatie kan de timer voor inactiviteit voor actieve sessies opnieuw instellen. Start een nieuw gesprek en test het opnieuw.

Als de trigger voor inactiviteit nog steeds niet werkt, probeert u de volgende opties:

• Controleer gesprekstranscripties op eventuele activiteit in onderwerpen van inactiviteit. Als het onderwerp wordt weergegeven, maar de gebruiker het bericht niet heeft gezien, is het probleem kanaalspecifieke bezorging.
• Controleer of het onderwerp niet is uitgeschakeld of gearchiveerd.
• Controleer of het triggertype 'Na een periode van inactiviteit' is, in plaats van een woordgroeptrigger.

Aanbevolen procedures

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

• Gebruik een beveiligingsvariabele om lussen te voorkomen. Maken Global.DeactivateInactivity (Booleaanse waarde, standaard false). Stel deze in true op voordat u EndConversation aanroept. Controleer dit bij de start van ieder onderwerp over inactiviteit.

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

• Controleer uw eenheden. De eigenschap is in seconden. 5 minuten = 300, niet 5.

• Voor Dynamics 365 Customer Service: koppel EndConversation altijd aan closeOmnichannelConversation via Power Automate.

• Voor scenario's met meerdere triggers: Beperk vraagknooppunten tot één trigger of gebruik het patroon voor gedeelde onderwerpen.

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

• Controleer gesprektranscripties na de implementatie om te controleren of berichten op verwachte tijden worden weergegeven.

Veelgestelde vragen

Waarom werkt de trigger voor inactiviteit niet in het testvenster?

Timers worden standaard uitgeschakeld in het testvenster. Publiceer uw agent en test op een livekanaal.

Kan ik dynamische duur gebruiken (bijvoorbeeld vanuit 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 gewapend is. Zorg ervoor dat de variabele is geïnitialiseerd en een geldig getal bevat.

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

De runtime haalt de nieuwe versie op. Als de trigger-ID is gewijzigd (topic verwijderd en opnieuw gemaakt), valt het systeem terug op een match op basis van duur. Als er geen triggers overeenkomen voor ID of duur, wordt de inactiviteitsgebeurtenis in behandeling verwijderd.

Hoe kan ik triggers voor inactiviteit volledig in Teams uitschakelen?

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

Werkt de inactiviteittrigger met verificatie?

Ja, maar voor lange sessietime-outs (bijvoorbeeld 24 uur) kan het verificatietoken van de gebruiker verlopen voordat de trigger wordt geactiveerd. Zorg ervoor dat uw agent de verificatie correct afhandelt.

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

Connector-aanroepen hebben een time-outlimiet (standaard 30 seconden, maximaal 60 seconden). Optimaliseer de connector of handel de time-out op een beheerste manier af.

Verwante inhoud

• Onderwerptriggers instellen
• Systeemvariabelen — InactivityTimer.Continue, InactivityTimer.Count
• Power Fx gebruiken in Copilot Studio
• Configureer Dynamics 365 Customer Service overdracht
• Spraakconfiguratie en stiltedetectie
• Agents implementeren in Teams
• Verbonden agenten
• Conversatie transcripties in Copilot Studio
• Omnichannel-gesprekken automatisch sluiten
• Kennis van beperkingen in Microsoft 365 Copilot