Konfigurace vlastních dat a vlastních událostí pro agenty AI
Vlastní data na začátku relace
Vlastní data umožňují vývojářům provádět následující úlohy:
- Předání dat od klienta k aktualizaci parametrů času návrhu autonomního agenta. Například předání jména zákazníka pro přizpůsobenou uvítací zprávu.
- Aktualizujte časové proměnné návrhu autonomního agenta AI. Například optimalizujte cíle a pokyny pro konkrétní zákazníky, aktualizujte popis akce a sloty informacemi, které jsou u klienta k dispozici, aby uživatelé nebyli k tomu znovu vyzváni.
V současné době jsou vlastní data pro autonomní agenty AI podporována pouze prostřednictvím hlasového kanálu.
Konfigurace uživatelských dat
- V aplikaci Webex Contact Center Flow Designer nakonfigurujte aktivitu Virtual Agent V2 v toku.
- V nastavení Stav události zadejte ve sloupcích
Název události — Data události následující podrobnosti:
- Pole názvu události ponechte prázdné.
- Zadejte vlastní data, která chcete předat z návrháře toku do autonomního agenta AI.

Přístup k vlastním datům v AI Agent Studio
K datům událostí (nakonfigurovaným v Návrháři toku) můžete přistupovat pomocí syntaxe
{{variable name}}v různých částech autonomního agenta. Promě
nné předané ve vlastních datech jsou přístupné v cíli agenta, uvítací zprávě,
pokynech, popisu akce a popisu slotu.

V tomto příkladu vývojář použije {{customer_name}}v uvítací
zprávě a {{calling_number}}v pokynech agenta.
Vlastní události pro plnění
Vlastní událost umožňuje vývojářům provádět následující úkoly
- Definujte vlastní výstup z agenta AI, aby se řízení vrátilo návrháři toku wxCC. Například k provedení plnění v rámci toku.
- Pokračujte v konverzaci s agentem AI předáním výstupu plnění zpět agentovi AI z toku. Omezení časového limitu plnění plnění založeného na toku Webex connect zde neplatí.
- Podporujte případy použití PCI pro autonomní agenty, protože informace PCI zůstávají v mezích nástroje wxCC flow builder.
V současné době jsou vlastní události pro autonomní agenty AI podporovány pouze prostřednictvím hlasového kanálu.
Konfigurace vlastního plnění založeného na událostech v AI Agent Studio
- V akcích autonomního agenta vytvořte novou akci, kde je potřeba vlastní plnění založené na událostech.
- V sekci plnění vyberte možnost „Nastavit vlastní logiku pro plnění“.
Přístup k vlastním datům událostí v aplikaci Flow Designer
K vlastnímu názvu události a užitečnému zatížení můžete přistupovat v části Výstupní proměnné aktivity Virtual Agent V2.
Název akce je vrácen pod proměnnou StateEventName a shromážděné sloty z akce jsou vráceny jako MetaData:

Vyvolání vlastní události z Flow Designer
- Spuštění logiky plnění v toku na základě názvu akce nebo události přijatého ve výstup u aktivity Virtual Agent V2.
- Vytvářejte a používejte proměnné toku k dynamické aktualizaci názvu události a dat události, která mají být
odeslána zpět. V níže uvedeném příkladu, proměnná event_name toku je nastavena tak, aby byla stejná jako název
události předaný aktivitou Virtual Agent V2 a event_data_string proměnná je
aktualizována tak, aby obsahovala výstup z aktivity http používané pro komunikaci se systémy
třetích stran za účelem získání podrobností o dostupnosti schůzky.

V nastavení Událost stavu aktivity Virtual Agent V2 zadejte v polích Název události — Data události následující podrobnosti:
- Proměnná, která obsahuje název události Aktivita Virtual Agent V2, byla ukončena.
- Proměnná, která obsahuje data plnění, která musí být předána zpět do toku.

Vlastní události umožňují správcům provádět následující úlohy:
-
Předání dat od klienta k vytvoření dynamických odpovědí. Například předání jména zákazníka pro osobní pozdrav.
-
Definujte vlastní výstup z agenta AI, aby se řízení vrátilo návrháři toku. Například k provedení plnění v rámci toku.
-
Pomocí vlastní události nastavte agenta AI tak, aby začínal spíše od vlastního počátečního bodu než z uvítací výzvy.
-
Aktualizujte proměnné stavu agenta AI. Například předvyplnění kontextu nebo slotů pomocí vlastních dat předaných z návrháře toku.
V současné době je vlastní událost pro skriptované agenty AI podporována pouze prostřednictvím hlasového kanálu.
Konfigurace příchozí vlastní události v AI Agent Studio
- Na stránce konfigurace agenta AI vytvořte novou odpověď na kar tě Odpovědi.
- V části Výchozí odpověď klikněte na tlačítko + vedle Vý chozí (web) kanálu a přidejte hlas ový kanál
- V poli Název příchozí události definujte název události, kterou agent obdrží.
Vyvolání vlastní události z Flow Designer
- V aplikaci Webex Contact Center Flow Designer nakonfigurujte aktivitu Virtual Agent V2 v toku.
- V nastavení Stav události zadejte ve sloupcích Název události
— Data události následující podrobnosti:
-
Zadejte název vlastní události, kterou jste nakonfigurovali, na kartě Odpověď na stránce konfigurace agenta AI v AI Agent Studio.
- Zadejte vlastní data, která chcete předat z návrháře toku skriptovanému agentu AI.
-
Přístup k vlastním datům událostí v AI Agent Studio
K datům událostí (nakonfigurovaným v Návrháři toku) můžete přistupovat v části Vý
chozí odpověď, kde jste nakonfigurovali příchozí událost. Na následujícím
obrázku vidíte, že vlastní název události "„a
data události custom_welcome" store name"jsou předávány z Flow Designer do AI Agent
Studio.
Konfigurace vlastní události ukončení a užitečného zatížení v AI Agent Studio
-
V AI Agent Studio přejděte na skriptovanou stránku konfigurace agenta AI a přejděte na Odpověď, kde chcete, aby byl ovládací prvek předán zpět návrháři toku.
-
Přidejte vlastní událost do sekce Vý chozí odpověď.
-
Do JSON zadejte název události a data užitečného zatížení události, které chcete vrátit do toku.
V tomto příkladu jsou shromážděné sloty
vráceny do toku s vlastní událostí ukončení
“order_details”.
Přístup k vlastním datům událostí v aplikaci Flow Designer
K vlastní události a užitečnému zatížení můžete přistupovat v části Vý stupní proměnné aktivity Virtual Agent V2.
Hodno Event nameta je vrácena pod StateEventName
proměnnou a Event payload je vrácena, Metadatajak je
znázorněno na následujícím obrázku:

Aktualizace systémových hodnot v AI Agent Studio
Systémové hodnoty, jako je kontext, záměr a slot, můžete aktualizovat pomocí speciální události
state_updatea Event payloads hodnotami, jak je znázor
něno v následujícím příkladu:
{
"intent": "order_status",
"slots": {
"first_name": "John"
}
"context": {
"track": 1
}
}
Ve výše uvedeném příkladu je záměr skriptovaného agenta nastaven na
order_status, slot 'first_name' v tomto záměru je nastaven na 'John'
a do relace je přidán kontext nazvaný „track“.
Tato událost je užitečná pro případy použití, kdy skriptovaná konverzace agenta musí být řízena log ikou toku. Některé případy použití, kde je to zvláště užitečné, zahrnují:
-
Znovu vyzvat uživatele k poskytnutí informací, pokud splnění v toku selže
Zvažte scénář, kdy agent rezervuje schůzku pro uživatele. Po shromáždění data a času jsou tyto informace odeslány do toku prostřednictvím vlastní události, která se poté pokusí rezervovat schůzku pomocí aktivity požadavku HTTPS. Pokud je schůzka zamítnuta kvůli konfliktu plánování, musí agent AI požádat o alternativní časový úsek. K tomu může vývojář použít následující užitečné zatížení události:
{ "intent": "book appointment", "slots": { "time": "" } }V takovém případě je hodnota shromážděná za čas vymazána a agent AI vyzve uživatele, aby poskytl novou. Vývojáři mohou nastavit podmíněné odpovědi, aby uživatelé věděli , že předchozí slot nebyl k dispozici, a požádat o nový čas.
-
Přejít na jiný záměr
Zvažte scénář, kdy uživatel požádá o kontrolu svého zůstatku, ale jako předpoklad musí uživatel nejprve ověřit svou totožnost. V rámci procesu dotazování zůstatku mohou vývojáři odeslat užitečné zatížení události, aby informovali tok, zda byl uživatel již ověřen. Pokud je ověřen, systém může pokračovat v načtení zůstatku; pokud ne, tok může vyzvat agenta AI, aby zahájil proces ověření uživatele pomocí následujícího užitečného zatížení události:
{ "intent": "verify user", }Ve stejném příkladu řekněme, že ověření vyžaduje datum narození uživatele a kód PIN. Z toku již má informace o datu narození uživatele prostřednictvím CJDS, které lze předat jako slot a lze sbírat pouze PIN kód. Užitečné zatížení události pro to bude vypadat takto:
{ "intent": "verify user", "slots": { "date of birth": "06/26/1993" } } - Zavedení nebo resetování kontextu konverzace
Když je třeba aktualizovat kontext konverzace, vývojáři jej mohou zahrnout do užitečného zatížení události pro
state_updateudálost. Například poté, co agent AI shromáždí sloty pro záměr „ověřit uživatele“, nastaví kontext konverzace na „ověřit“. Pokud ověření v toku selže, kontext by měl být resetován, aby se zabránilo uživateli v přístupu k záměrům, které vyžadují kontext „ověření“. Užitečné zatížení události pro tento scénář by vypadalo takto:{ "intent": "verify user", "slots": { "date of birth": "", "pincode": "" }, "context": { "verify": 0 } }