Konfigurer brugerdefinerede data og brugerdefinerede hændelser til AI-agenter
Brugerdefinerede data i begyndelsen af sessionen
Brugerdefinerede data gør det muligt for udviklere at udføre følgende opgaver:
- Send data fra klienten for at opdatere en autonom agents designtidsparametre. For eksempel at videregive kundenavn til en personlig velkomstbesked.
- Opdater autonome AI-agentdesigntidsvariabler. For eksempel kan du optimere mål og instruktioner for specifikke kunder, opdatere handlingsbeskrivelse og slots med oplysninger, der er tilgængelige for klienten, så brugerne ikke bliver bedt om det igen.
I øjeblikket understøttes brugerdefinerede data til autonome AI-agenter kun via stemmekanalen.
Konfigurer brugerdefinerede data
- I Webex Contact Center Flow Designer skal du konfigurere Virtual Agent V2- aktiviteten i flowet.
- I indstillingerne for Stat shændelse skal du angive følgende detaljer i kolonnerne Hændelses
navn - Hændelsesdata:
- Lad feltet hændelsesnavn være tomt.
- Angiv de brugerdefinerede data, som du ønsker at videregive fra Flow Designer til den autonome AI-agent.

Få adgang til brugerdefinerede data i AI Agent Studio
Du kan få adgang til hændelsesdata (konfigureret i Flow Designer) ved hjælp af syntak
{{variable name}}sen i forskellige sektioner af den autonome agent. De
variabler, der sendes i de brugerdefinerede data, kan tilgås i agentens mål, velkomstmeddelelse,
instruktioner, handlingsbeskrivelse og slotbeskrivelse.

I dette eksempel bruger udvikleren {{customer_name}}i velkomst
meddelelsen og {{calling_number}}i agentinstruktionerne.
Brugerdefinerede begivenheder til opfyldelse
Brugerdefineret begivenhed gør det muligt for udviklere at udføre følgende opgaver
- Definer en brugerdefineret udgang fra AI-agenten for at returnere kontrollen til wxCC-flowdesigneren. For eksempel at udføre opfyldelse inden for flowet.
- Genoptag samtalen med AI-agenten ved at sende opfyldelsesoutputtet tilbage til AI-agenten fra flowet. Begrænsningen for tidsbegrænsning for opfyldelse af Webex connect-flowbaseret opfyldelse gælder ikke her.
- Understøtter PCI-brugssager til autonome agenter, da PCI-oplysningerne forbliver inden for grænserne for wxCC flow builder.
I øjeblikket understøttes brugerdefinerede begivenheder for autonome AI-agenter kun via stemmekanalen.
Konfigurer brugerdefineret hændelsesbaseret opfyldelse i AI Agent Studio
- I handlinger med autonome agenter skal du oprette en ny handling, hvor der er behov for brugerdefineret hændelsesbaseret opfyldelse.
- I afsnittet for opfyldelse skal du vælge „Angiv brugerdefineret logik til opfyldelse“.
Få adgang til brugerdefinerede hændelsesdata i Flow Designer
Du kan få adgang til det brugerdefinerede hændelsesnavn og nyttelast fra afsnittet Outputvariabler i Virtual Agent V2-aktiviteten.
Handlingsnavnet returneres under variablen StateEventName, og de indsamlede slots fra handlingen returneres som MetaData:

Påkald brugerdefineret begivenhed fra Flow Designer
- Udfør opfyldelseslogik i flowet baseret på handlingen eller hændelsesnavnet modtaget i Virtual Agent V2-aktivitetsudgangen.
- Opret og brug flowvariabler til dynamisk opdatering af hændelsesnavn og hændelsesdata, der skal
sendes tilbage. I eksemplet nedenfor er event_name flowvariablen indstillet til at være det samme som
begivenhedsnavnet sendt af Virtual Agent V2-aktiviteten, og event_data_string variablen
opdateres til at indeholde output fra http-aktiviteten, der bruges til kommunikation med
tredjepartssystemer for at få oplysninger om tilgængelighed af aftaler.

Angiv følgende oplysninger i felterne Hændelsesnavn — Hændelsesdata i indstillingerne for Statshændelse for aktivitet Virtual Agent V2:
- Variablen, der indeholder begivenhedsnavnet Virtual Agent V2-aktivitet, der afsluttes med.
- Variablen, der indeholder opfyldelsesdata, der skal sendes tilbage til flowet.

Brugerdefinerede hændelser gør det muligt for administratorer at udføre følgende opgaver:
-
Send data fra klienten for at oprette dynamiske svar. For eksempel at videregive kundenavn til en personlig hilsen.
-
Definer en brugerdefineret udgang fra AI-agenten for at returnere kontrollen til flowdesigneren. For eksempel at udføre opfyldelse inden for flowet.
-
Indstil AI-agenten til at starte fra et brugerdefineret startpunkt i stedet for velkomstprompten ved hjælp af en brugerdefineret begivenhed.
-
Opdater AI-agenttilstandsvariabler. For eksempel forududfyldning af konteksten eller slots ved hjælp af brugerdefinerede data sendt fra flowdesigneren.
I øjeblikket understøttes brugerdefineret begivenhed for scriptede AI-agenter kun via stemmekanalen.
Konfigurer indgående brugerdefineret begivenhed i AI Agent Studio
- Opret et nyt svar på fanen Svar på konfigurationssiden for AI-agent.
- Klik på + ud for Standardkanalen (web) under Standard svar for at tilføje stem mekanalen
- I feltet Navn på indgående hændelse skal du definere det hændelsesnavn, som agenten modtager.
Påkald brugerdefineret begivenhed fra Flow Designer
- I Webex Contact Center Flow Designer skal du konfigurere Virtual Agent V2- aktiviteten i flowet.
- I indstillingerne for Stat shændelse skal du angive følgende detaljer i kolonnerne Hændelsesnavn
- Hændelsesdata:
-
Angiv det brugerdefinerede hændelsesnavn, du har konfigureret, under fanen Svar på konfigurationssiden for AI-agent i AI Agent Studio.
- Angiv de brugerdefinerede data, som du ønsker at videregive fra Flow Designer til den scriptede AI-agent.
-
Få adgang til brugerdefinerede hændelsesdata i AI Agent Studio
Du kan få adgang til hændelsesdataene (konfigureret i Flow Designer) i afsnittet Standar
dsvar, hvor du konfigurerede din indgående begivenhed. I den følgende
figur kan du se, at det brugerdefinerede hændelsesnavn custom_welcome"" og
hændelsesdata store name"" overføres fra Flow Designer til AI Agent
Studio.
Konfigurer brugerdefineret afslutningshændelse og nyttelast i AI Agent Studio
-
I AI Agent Studio skal du navigere til den scriptede AI-agentkonfigurationsside og gå til Svar, hvor du vil have kontrollen til at blive sendt tilbage til flowdesigneren.
-
Føj brugerdefineret begivenhed til afsnittet Standar dsvar.
-
Indtast begivenhedsnavnet og hændelsesnyttelastdataene i den JSON, som du vil returnere til flow et.
I dette eksempel
returneres de indsamlede slots til flowet med den brugerdefinerede afslutningshændelse
“order_details”.
Få adgang til brugerdefinerede hændelsesdata i Flow Designer
Du kan få adgang til den brugerdefinerede begivenhed og nyttelast fra afsnittet Outputvariabler i Virtual Agent V2- aktiviteten.
Event nameDet returneres under StateEventName
variablen, og returner Event payload es Metadatasom
vist i følgende figur:

Opdater systemværdier i AI Agent Studio
Du kan opdatere systemværdier som kontekst, hensigt og slot ved hjælp af en særlig begivenhed
state_updateog Event payloadmed værdierne, som vist
i følgende eksempel:
{
"intent": "order_status",
"slots": {
"first_name": "John"
}
"context": {
"track": 1
}
}
I ovenstående eksempel er hensigten for den scriptede agent indstillet til
order_status, slotten 'first_name' inden for denne intention er indstillet til 'John',
og en kontekst kaldet 'track' føjes til sessionen.
Denne begivenhed er nyttig i brugstilfælde, hvor den scriptede agentsamtale skal styres af flowlogik. Nogle brugssager, hvor dette er særligt nyttigt, inkluderer:
-
Bed brugeren om oplysninger igen, hvis opfyldelsen i flowet mislykkes
Overvej et scenarie, hvor agenten booker en aftale for en bruger. Efter indsamling af dato og klokkeslæt sendes disse oplysninger til flowet gennem en brugerdefineret begivenhed, som derefter forsøger at booke aftalen ved hjælp af en HTTPS-anmodningsaktivitet. Hvis aftalen afvises på grund af en planlægningskonflikt, skal AI-agenten anmode om et alternativt tidsrum. For at håndtere dette kan udvikleren bruge følgende hændelses nyttelast:
{ "intent": "book appointment", "slots": { "time": "" } }I dette tilfælde ryddes den værdi, der er indsamlet for tid, og AI-agenten beder brugeren om at angive en ny. Udviklere kan konfigurere betingede svar for at lade brugerne vide, at den forrige slot ikke var tilgængelig og anmode om en ny tid.
-
Naviger til en anden hensigt
Overvej et scenarie, hvor en bruger anmoder om at kontrollere deres saldo, men som en forudsætning skal brugeren først bekræfte sin identitet. Som en del af balanceundersøgelsesprocessen kan udviklere sende en hændelsesnyttelast for at informere flowet om, hvorvidt brugeren allerede er blevet verificeret. Hvis det er bekræftet, kan systemet fortsætte med at hente saldoen. Hvis ikke, kan flowet bede AI-agenten om at starte brugerverifikationsprocessen ved hjælp af følgende hændelsesnyttelast:
{ "intent": "verify user", }Lad os i det samme eksempel sige, at verifikation kræver brugerens fødselsdato og pinkode. Af strømmen har allerede oplysninger om brugerens fødselsdato via CJDS, der kan videregives som en slot og kun pinkode kan indsamles. Hændelsesnyttelasten for det vil se sådan ud:
{ "intent": "verify user", "slots": { "date of birth": "06/26/1993" } } - Introduktion eller nulstilling af kontekst i en samtale
Når samtalekonteksten skal opdateres, kan udviklere inkludere den i begivenhedens nyttelast
state_update. For eksempel, når AI-agenten har samlet slots til hensigten „bekræft bruger“, indstiller den samtalekonteksten til 'verificer'. Hvis verifikationen mislykkes i flowet, skal konteksten nulstilles for at forhindre brugeren i at få adgang til hensigter, der kræver konteksten „bekræft“. Hændelsesnyttelasten for dette scenarie vil se sådan ud:{ "intent": "verify user", "slots": { "date of birth": "", "pincode": "" }, "context": { "verify": 0 } }