Konfigurer egendefinerte data og tilpassede hendelser for AI-agenter
Egendefinerte data i begynnelsen av økten
Egendefinerte data gjør det mulig for utviklere å utføre følgende oppgaver:
- Send data fra klienten for å oppdatere en autonom agents designtidsparametere. For eksempel å sende kundenavn for en personlig velkomstmelding.
- Oppdater autonome AI-agentdesigntidsvariabler. Optimaliser for eksempel mål og instruksjoner for bestemte kunder, oppdater handlingsbeskrivelse og spor med informasjon som er tilgjengelig hos klienten, slik at brukerne ikke blir bedt om det på nytt.
Foreløpig støttes tilpassede data for autonome AI-agenter bare gjennom talekanalen.
Konfigurer egendefinerte data
- I Webex Contact Center Flow Designer konfigurerer du Virtual Agent V2- aktiviteten i flyten.
- I Statushendelses innstillingene angir du følgende detaljer i kolonnene Hendelses
navn - Hendelsesdata:
- La hendelsesnavnfeltet være tomt.
- Angi de egendefinerte dataene du vil overføre fra Flow Designer til den autonome AI-agenten.

Få tilgang til egendefinerte data i AI Agent Studio
Du kan få tilgang til hendelsesdata (konfigurert i Flow Designer) ved hjelp av syntak
{{variable name}}sen i ulike deler av den autonome agenten. Variablene som sendes i de egendefinerte dataene, kan nås i agentens mål, velkomstmelding,
instruksjoner, handlingsbeskrivelse og sporbeskrivelse.

I dette eksemplet bruker utvikleren {{customer_name}}i velkomst
meldingen og {{calling_number}}i agentinstruksjonene.
Tilpassede hendelser for oppfyllelse
Egendefinert hendelse gjør det mulig for utviklere å utføre følgende oppgaver
- Definer en egendefinert utgang fra AI-agenten for å returnere kontrollen til wxCC-flytdesigneren. For eksempel for å utføre oppfyllelse innenfor flyten.
- Fortsett samtalen med AI-agenten ved å sende oppfyllingsutdataene tilbake til AI-agenten fra flyten. Tidsbegrensningen for oppfyllelse av Webex connect-flytbasert oppfyllelse gjelder ikke her.
- Støtt PCI-brukstilfeller for autonome agenter ettersom PCI-informasjonen holder seg innenfor grensene til wxCC- flytbygger.
Foreløpig støttes tilpassede hendelser for autonome AI-agenter bare gjennom talekanalen.
Konfigurer tilpasset hendelsesbasert oppfyllelse i AI Agent Studio
- I handlinger for autonome agenter oppretter du en ny handling der egendefinert hendelsesbasert oppfyllelse er nødvendig.
- I innfrielsesdelen velger du alternativet Angi tilpasset logikk for oppfyllelse.
Få tilgang til egendefinerte hendelsesdata i Flow Designer
Du kan få tilgang til det egendefinerte hendelsesnavnet og nyttelasten fra delen Utdatavariabler i Virtual Agent V2-aktiviteten.
Handlingsnavnet returneres under variabelen StateEventName, og de innsamlede sporene fra handlingen returneres som MetaData:

Påkall egendefinert hendelse fra Flow Designer
- Utfør oppfyllelseslogikk i flyten basert på handlingen eller hendelsesnavnet mottatt i Virtual Agent V2-aktivitetsutdata.
- Opprett og bruk flytvariabler til dynamisk oppdatering av hendelsesnavn og hendelsesdata som skal
sendes tilbake. I eksemplet nedenfor, event_name flytvariabelen er satt til å være det samme som
hendelsesnavnet som sendes av Virtual Agent V2-aktiviteten, og event_data_string variabelen
oppdateres for å inneholde utdata fra http-aktiviteten som brukes til å kommunisere med
tredjepartssystemer for å få informasjon om tilgjengelighet for avtale.

I Statushendelsesinnstillingene for Virtual Agent V2-aktivitet angir du følgende detaljer i feltene Hendelsesnavn — Hendelsesdata:
- Variabelen som inneholder hendelsesnavnet Virtual Agent V2-aktivitet avsluttet med.
- Variabelen som inneholder oppfyllingsdata som må sendes tilbake til flyten.

Egendefinerte hendelser gjør det mulig for administratorer å utføre følgende oppgaver:
-
Send data fra klienten for å lage dynamiske svar. For eksempel å sende kundenavn for en personlig hilsen.
-
Definer en egendefinert utgang fra AI-agenten for å returnere kontrollen til flytdesigneren. For eksempel for å utføre oppfyllelse innenfor flyten.
-
Angi AI-agenten til å begynne fra et egendefinert startpunkt i stedet for velkomstmeldingen ved å bruke en egendefinert hendelse.
-
Oppdater AI-agenttilstandsvariabler. For eksempel forhåndsutfylling av konteksten eller sporene ved hjelp av egen definerte data sendt fra flytdesigneren.
For øyeblikket støttes tilpassede hendelser for skriptbaserte AI-agenter bare via talekanalen.
Konfigurer innkommende egendefinert hendelse i AI Agent Studio
- Opprett et nytt svar i kategorien Svar på konfigurasjonssiden for AI-agent.
- Under Standardsvar klikker du på + ved siden av standardkanalen (web) for å legge til talek anal en
- I feltet Navn på innkommende hendelse definerer du hendelsesnavnet som agenten mottar.
Påkall egendefinert hendelse fra Flow Designer
- I Webex Contact Center Flow Designer konfigurerer du Virtual Agent V2- aktiviteten i flyten.
- I Statushendelses innstillingene angir du følgende detaljer i kolonnene Hendelsesnavn
- Hendelsesdata:
-
Angi det egendefinerte hendelsesnavnet du har konfigurert i kategorien Svar på konfigur asjonssiden for AI-agent i AI Agent Studio.
- Angi de egendefinerte dataene du vil overføre fra Flow Designer til den skriptbaserte AI-agenten.
-
Få tilgang til egendefinerte hendelsesdata i AI Agent Studio
Du kan få tilgang til hendelsesdataene (konfigurert i Flow Designer) i
Standardsvar-delen der du konfigurerte den innkommende hendelsen. I
figuren nedenfor kan du se at det egendefinerte hendelsesnavnet custom_welcome"" og hendelses
dataene store name"" sendes fra Flow Designer til AI Agent
Studio.
Konfigurer egendefinert avslutningshendelse og nyttelast i AI Agent Studio
-
I AI Agent Studio navigerer du til konfigurasjonssiden med skript for AI-agent og går til Svar der du vil at kontrollen skal sendes tilbake til flytdesigneren.
-
Legg til egendefinert hendelse i Standardsvar -delen.
-
Skriv inn hendelsesnavnet og hendelsesnyttelastdataene i JSON som du vil skal returneres til fly ten.
I dette eksemplet
returneres de innsamlede sporene til flyten med den egendefinerte avslutningshendelsen
“order_details”.
Få tilgang til egendefinerte hendelsesdata i Flow Designer
Du kan få tilgang til den egendefinerte hendelsen og nyttelasten fra delen Utdatavariabler i Virtual Agent V2- aktiviteten.
Den returner Event namees under StateEventName
variabelen og returner Event payload es Metadatasom
vist i følgende figur:

Oppdater systemverdier i AI Agent Studio
Du kan oppdatere systemverdier som kontekst, intensjon og spor ved hjelp av en spesiell hendelse
state_updateog Event payloadmed verdiene, som vist
i følgende eksempel:
{
"intent": "order_status",
"slots": {
"first_name": "John"
}
"context": {
"track": 1
}
}
I eksemplet ovenfor er intensjonen til den skriptede agenten satt til
order_status, sporet 'first_name' i denne hensikten er satt til 'John'
og en kontekst kalt 'spor' blir lagt til økten.
Denne hendelsen er nyttig for brukstilfeller der den skriptede agentsamtalen må styres av flytlogikk. Noen brukstilfeller der dette er spesielt nyttig inkluderer:
-
Be brukeren om informasjon på nytt hvis oppfyllelsen i flyten mislykkes
Vurder et scenario der agenten bestiller en avtale for en bruker. Etter å ha samlet dato og klokkeslett, sendes denne informasjonen til flyten gjennom en tilpasset hendelse, som deretter prøver å bestille avtalen ved hjelp av en HTTPS-forespørselsaktivitet. Hvis avtalen blir avvist på grunn av en planleggingskonflikt, må AI-agenten be om en alternativ tidsluke. For å håndtere dette kan utvikleren bruke følgende hendelses nyttelast:
{ "intent": "book appointment", "slots": { "time": "" } }I dette tilfellet slettes verdien som samles inn for tid, og AI-agenten ber brukeren om å oppgi en ny. Utviklere kan sette opp betingede svar for å fortelle brukerne at forrige spilleautomat var utilgjengelig og be om en ny tid.
-
Naviger til en annen hensikt
Tenk på et scenario der en bruker ber om å sjekke saldoen, men som en forutsetning må brukeren først bekrefte identiteten sin. Som en del av balanseforespørselsprosessen kan utviklere sende en hendelsesnyttelast for å informere flyten om brukeren allerede er bekreftet. Hvis det er bekreftet, kan systemet fortsette å hente balansen. Hvis ikke, kan flyten be AI-agenten om å starte brukerverifiseringsprosessen ved hjelp av følgende hendelsesnyttelast:
{ "intent": "verify user", }I det samme eksemplet, la oss si at bekreftelse krever brukerens fødselsdato og PIN-kode. Av flyten har allerede informasjon om brukerens fødselsdato via CJDS, som kan sendes som et spor og bare PIN-kode kan samles inn. Hendelsesnyttelasten for det vil se slik ut:
{ "intent": "verify user", "slots": { "date of birth": "06/26/1993" } } - Introdusere eller tilbakestille kontekst i en samtale
Når samtalekonteksten må oppdateres, kan utviklere inkludere den i hendelsesnyttelasten for
state_updatehendelsen. For eksempel, etter at AI-agenten har samlet sporene for «verifiser bruker» -intensjonen, setter den samtalekonteksten til «verifiser». Hvis bekreftelsen mislykkes i flyten, bør konteksten tilbakestilles for å forhindre at brukeren får tilgang til hensikter som krever «verifiser» -konteksten. Hendelsesbelastningen for dette scenariet vil se slik ut:{ "intent": "verify user", "slots": { "date of birth": "", "pincode": "" }, "context": { "verify": 0 } }