Konfigurace vlastních událostí pro agenty AI
Vlastní událost umožňuje vývojářům provádět následující úlohy:
- Předejte data od klienta pro aktualizaci parametrů návrhového času autonomního agenta. Například předání jména zákazníka pro personalizovanou uvítací zprávu.
- Aktualizujte proměnné doby návrhu autonomního agenta AI. Například optimalizujte cíle a pokyny pro konkrétní zákazníky, aktualizujte popis akce a sloty s informacemi, které jsou k dispozici s klientem, aby uživatelé nebyli znovu vyzváni.
V současné době je vlastní událost pro autonomní agenty AI podporována pouze prostřednictvím hlasového kanálu.
Konfigurace vlastních dat v návrháři toku
- V Webex Contact Center Návrháři toku nakonfigurujte aktivitu virtuálního agenta 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ázev události ponechte prázdné.
- Zadejte vlastní data, která chcete předat z návrháře toku autonomnímu agentovi AI.

Přístup k vlastním datům událostí v AI Agent Studiu
K datům událostí (nakonfigurovaným v Návrháři toků) můžete přistupovat pomocí syntaxe {{název proměnné}} 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žívá {{customer_name}} v uvítací zprávě a {{calling_number}} v pokynech agenta .
Vlastní události umožňují správcům provádět následující úlohy:
-
Předejte data z klienta a vytvořte dynamické odpovědi. Například předání jména zákazníka pro osobní pozdrav.
-
Definujte vlastní výstup z agenta AI pro vrácení řízení návrháři toku. Například k provedení plnění v rámci toku.
-
Nastavte agenta AI tak, aby začínal od vlastního počátečního bodu, nikoli od uvítací výzvy pomocí vlastní události.
-
Aktualizujte proměnné stavu agenta AI. Například předběžné vyplně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ěď v odpovědích Tab.
- V části Výchozí odpověď klikněte na + vedle výchozího (webového) kanálu a přidejte hlasový kanál
- V poli Název příchozí události definujte název události, který agent obdrží.
Vyvolání vlastní události z Návrháře toku
- V Webex Contact Center Návrháři toku nakonfigurujte aktivitu virtuálního agenta 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, který jste nakonfigurovali v odpovědi Tab na stránce konfigurace agenta AI v AI Agent Studio.
- Zadejte vlastní data, která chcete předat z Návrháře toku skriptovanému agentovi AI.
-
Přístup k vlastním datům událostí v AI Agent Studiu
K datům události (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 "custom_welcome" a "název úložiště" dat události jsou předávány z Návrháře toku do AI Agent Studio.
Konfigurace vlastní události ukončení a datové části v AI Agent Studio
-
V AI Agent Studio přejděte na stránku konfigurace agenta AI ve skriptu a přejděte na odpověď , kde chcete ovládací prvek předat zpět návrháři toku.
-
Přidejte vlastní událost do části Výchozí odpověď .
-
Zadejte název události a data datové části události do formátu JSON, 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 Návrháři toku
K vlastní události a datové části můžete přistupovat z části Výstupní proměnné aktivity virtuálního agenta V2 .
Název události je vrácen pod proměnnou StateEventName a datová část události je vrácena jako metadata , jak 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í state_update speciální události a datové části události s hodnotami, jak je znázorněno v následujícím příkladu:
{ "intent": "order_status", "slots": { "first_name": "John" } }
Ve výše uvedeném příkladu je záměr skriptovaného agenta nastaven na order_status, pozice "first_name" v rámci tohoto záměru je nastavena na "Jan" a do relace je přidán kontext nazvaný "sledování".
Tato událost je užitečná pro případy použití, kdy musí být skriptovaná konverzace agenta řízena logikou toku. Některé případy použití, kdy je to obzvláště užitečné, zahrnují:
-
Znovu vyzvat uživatele k zadání informací, pokud se plnění v toku nezdaří
Zvažte scénář, kdy agent rezervuje schůzku pro uživatele. Po shromáždění data a času se tyto informace odešlou do toku prostřednictvím vlastní události, která se pak pokusí rezervovat schůzku pomocí aktivity požadavku HTTPS. Pokud je schůzka odmítnuta z důvodu konfliktu plánování, agent AI musí požádat o alternativní časový úsek. K tomu může vývojář použít následující datovou část události:
{ "záměr": "rezervovat schůzku", "sloty": { "čas": "" } }V takovém případě se hodnota shromážděná pro čas vymaže a agent AI vyzve uživatele k zadání nového. 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žádali o nový čas.
-
Navigace k jinému záměru
Zvažte scénář, kdy uživatel požádá o kontrolu zůstatku, ale jako předpoklad musí uživatel nejprve ověřit svou identitu. V rámci procesu dotazu zůstatku mohou vývojáři odeslat datovou část události, aby informovali tok, zda byl uživatel již ověřen. Je-li to ověřeno, systém může pokračovat v načítání zůstatku; Pokud ne, tok může vyzvat agenta AI k zahájení procesu ověření uživatele pomocí následující datové části události:
{ "záměr": "ověřit uživatele", }Ve stejném příkladu řekněme, že ověření vyžaduje datum narození uživatele a kód PIN. Toku již obsahuje informace o datu narození uživatele prostřednictvím CJDS, které lze předat jako slot a lze shromažďovat pouze kód PIN. Datová část události pro tuto událost bude vypadat takto:
{ "záměr": "ověřit uživatele", "sloty": { "datum narození": "26.06.1993" } } - Zavedení nebo obnovení kontextu v konverzaci
Když je potřeba aktualizovat kontext konverzace, vývojáři ho můžou zahrnout do datové části události state_update
. 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 se měl resetovat, aby uživatel neměl přístup k záměrům, které vyžadují kontext ověření. Datová část události pro tento scénář by vypadala takto:{ "intent": "verify user", "slots": { "date of birth": "", "pincode": "" }, "context": { "verify": 0 } }