Status beheren

Status binnen een agent volgt dezelfde paradigma's als moderne webtoepassingen. De SDK voor agenten biedt enkele abstracties om statusbeheer eenvoudiger te maken.

Net als bij web-apps is een agent inherent stateless. Een ander exemplaar van uw agent kan een bepaalde weergave van het gesprek afhandelen. Voor sommige agents heeft deze eenvoud de voorkeur: de agent kan werken zonder aanvullende informatie of de vereiste informatie is gegarandeerd binnen het binnenkomende bericht. Voor anderen is de status (zoals waar het gesprek is gebleven of gegevens die eerder over de gebruiker zijn ontvangen) nodig om de agent een nuttig gesprek te geven.

Waarom heb ik status nodig?

Met de status kan uw agent zinvollere gesprekken voeren door bepaalde dingen over een gebruiker of gesprek te onthouden. Als u bijvoorbeeld eerder met een gebruiker hebt gepraat, kunt u eerdere informatie over die gebruiker opslaan, zodat u er niet opnieuw om hoeft te vragen. Status bewaart ook gegevens langer dan de huidige weergave, zodat uw agent informatie bewaart tijdens een gesprek met meerdere paden.

Aangezien het betrekking heeft op agents, zijn er enkele lagen voor het gebruik van status: de opslaglaag, statusbeheer en AgentApplication.

Opslaglaag

Beginnend bij de back-end, waar de statusinformatie daadwerkelijk wordt opgeslagen, is de opslaglaag. U kunt dit beschouwen als uw fysieke opslag, zoals in-memory, Azure of een server van derden.

De SDK voor agenten bevat enkele implementaties voor de opslaglaag:

Geheugenopslag implementeert in-memory opslag voor testdoeleinden. Gegevensopslag in het geheugen is alleen bedoeld voor lokale tests omdat deze opslag vluchtig en tijdelijk is. De gegevens worden gewist telkens wanneer de agent opnieuw wordt opgestart.

Azure Blob Storage maakt verbinding met een Azure Blob Storage-objectdatabase.

De gepartitioneerde Azure Cosmos DB-opslag maakt verbinding met een gepartitioneerde Cosmos DB NoSQL-database.

Zie Overzicht van SDK-opslag voor agenten voor instructies over het maken van verbinding met andere opslagopties

Toestandbeheer

Statusbeheer automatiseert het lezen en schrijven van de status van uw agent naar de onderliggende opslaglaag. De status wordt opgeslagen als statuseigenschappen, die effectief sleutel-waardeparen zijn die uw agent kan lezen en schrijven via het statusbeheerobject, zonder dat u zich zorgen hoeft te maken over de specifieke onderliggende implementatie. Deze statuseigenschappen bepalen hoe die informatie wordt opgeslagen. Wanneer u bijvoorbeeld een eigenschap ophaalt die u hebt gedefinieerd als een specifieke klasse of een specifiek object, weet u hoe die gegevens worden gestructureerd.

Deze toestandseigenschappen worden samengevoegd in afgebakende verzamelingen 'buckets', die enkel dienen om deze eigenschappen te ordenen. De SDK bevat drie van deze buckets:

• Gebruikersstatus
• Gespreksstatus

Al deze buckets zijn subklassen van de statusklasse van de agent, die kunnen worden afgeleid om andere typen buckets met verschillende bereiken te definiëren.

Deze vooraf gedefinieerde buckets zijn gericht op een bepaalde zichtbaarheid, afhankelijk van de bucket:

• De gebruikersstatus is beschikbaar als de agent met die gebruiker in dat kanaal verbinding maakt, ongeacht het gesprek
• De gespreksstatus is op elke beurt beschikbaar in een specifiek gesprek, ongeacht de gebruiker, zoals in groepsgesprekken

Gebruikersstatus en gespreksstatus worden bepaald door kanaal. Dezelfde persoon die verschillende kanalen gebruikt om toegang te krijgen tot uw agent, wordt weergegeven als verschillende gebruikers, één voor elk kanaal en elk met een afzonderlijke gebruikersstatus.

De sleutels die worden gebruikt voor elk van deze vooraf gedefinieerde buckets zijn specifiek voor de gebruiker en het gesprek of de agent. Wanneer u de waarde van uw statuseigenschap instelt, wordt de sleutel intern voor u gedefinieerd, met informatie in de turncontext om ervoor te zorgen dat elke gebruiker of gesprek in de juiste bucket en eigenschap wordt geplaatst. De sleutels worden als volgt gedefinieerd:

• De gebruikersstatus maakt een sleutel met behulp van de kanaal-ID en van ID. Bijvoorbeeld: {Activity.ChannelId}/users/{Activity.From.Id}#YourPropertyName
• De gespreksstatus maakt een sleutel met behulp van de kanaal-ID en de gespreks-ID. Bijvoorbeeld: {Activity.ChannelId}/conversations/{Activity.Conversation.Id}#YourPropertyName

Wanneer gebruikt u elk type status

De gespreksstatus is handig voor het bijhouden van de context van het gesprek, zoals:

• Of de agent de gebruiker een vraag heeft gesteld en welke vraag
• Wat het huidige gespreksonderwerp is of wat de laatste is
• Chatgeschiedenis opnemen

De gebruikersstatus is geschikt voor het bijhouden van informatie over de gebruiker, zoals:

• Niet-kritieke gebruikersgegevens, zoals naam en voorkeuren, een alarminstelling of een waarschuwingsvoorkeur
• Informatie over het laatste gesprek dat ze met de agent hadden
  • Een productondersteuningsagent kan bijvoorbeeld bijhouden welke producten de gebruiker hierover heeft gevraagd.

AgentApplication

• Routehandlers die u toevoegt, worden geleverd met een TurnState exemplaar. Toegang tot gespreks- of gebruikersstatus vanuit dit exemplaar.
• Status wordt automatisch geladen en opgeslagen.

Verwante inhoud

• Overzicht van SDK-opslag voor agents
• Meer informatie over het Activity Protocol