為 AI 代理配置自訂事件
自訂事件使開發人員能夠執行以下任務:
- 從客戶端傳遞數據以更新自主代理的設計時參數。 例如,傳遞個人化歡迎消息的客戶名稱。
- 更新自治 AI 代理設計時間變數。 例如,優化特定客戶的目標和說明,使用用戶端可用的資訊更新操作說明和槽,以便不會重新提示使用者輸入它。
目前,自治 AI 代理的自定義事件僅支持通過語音管道。
在 Flow Designer 中設定自訂資料
- 在 Webex Contact Center 流設計器中,配置 流中的虛擬代理 V2 活動。
- 在「 狀態事件 」設置中,在「 事件名稱 - 事件數據 」列中指定以下詳細資訊:
- 將事件名稱欄位留空。
- 輸入您希望從 Flow Designer 傳遞到自治 AI 代理的自訂資料。

在 AI Agent Studio 中存取自訂事件資料
您可以在自治代理的各個部分中使用語法 {{變數名稱}} 存取事件資料 (在 Flow Designer 中設定)。 可以在代理的目標、歡迎訊息、指令、動作描述及槽位描述中存取自訂資料中傳遞的變數。

在此示例中,開發人員 在歡迎消息中使用 {{customer_name}} , 在代理說明中使用 {{calling_number}} 。
自訂事件使管理員能夠執行以下任務:
-
從客戶端傳遞資料以創建動態回應。 例如,傳遞個人化問候語的客戶名稱。
-
定義 AI 代理的自定義退出,以將控制權返回給流設計器。 例如,在流中執行履行。
-
使用自定義事件將 AI 代理設置為從自定義起點開始,而不是從歡迎提示開始。
-
更新 AI 代理狀態變數。 例如,使用從流設計器傳遞的自定義數據預填充上下文或槽。
目前,僅通過語音通道支援腳本化 AI 代理的自定義事件。
在 AI Agent Studio 中配置傳入的自訂事件
- 在 AI 代理配置頁面上,在 回應 Tab 中創建新回應。
- 在“默認回應”下,按兩下 “預設 (Web) 通道”旁邊的 “+ ”以添加 “語音 ”通道
- 在 傳入事件名稱 欄位中,定義代理接收的事件名稱。
從 Flow Designer 呼叫自訂事件
- 在 Webex Contact Center 流設計器中,配置 流中的虛擬代理 V2 活動。
- 在「 狀態事件 」設置中,在「 事件名稱 - 事件數據 」列中指定以下詳細資訊:
-
輸入您在 AI Agent Studio 中 AI 代理配置頁面的 Response Tab 中設定的自訂事件名稱。
- 輸入要從 Flow Designer 傳遞到腳本化 AI 代理的自訂資料。
-
在 AI Agent Studio 中存取自訂事件資料
您可以在設定傳入事件的 預設回應 部分中存取事件資料 (在 Flow Designer 中設定)。 在下圖中,您可以看到自定義事件名稱“custom_welcome”和事件數據“商店名稱”已從 Flow Designer 傳遞到 AI Agent Studio。
在 AI Agent Studio 中配置自訂退出事件和有效負載
-
在 AI 代理工作室中,導航到腳本化的 AI 代理配置頁,然後轉到 “回應” ,您希望將控件傳遞回流設計器。
-
將自定義事件 添加到預設回應 部分。
-
在 JSON 中輸入要返回到流的事件名稱和事件有效負載數據。
在此示例中,收集的槽將使用自定義退出事件 “order_details”返回到流。
在 Flow Designer 中存取自訂事件資料
您可以從 虛擬代理 V2 活動的「輸出變數 」部分 存取自訂事件和有效負載。
事件名稱 在 StateEventName 變數 下 返回,事件有效負載 作為 元數據 返回,如下圖所示:

在 AI Agent Studio 中更新系統值
您可以使用特殊事件 state_update 和 事件有效負載 來更新系統值,例如上下文、意向和槽,如以下範例所示:
{“意圖”:“order_status”,“插槽”:{“first_name”:“約翰”} }
在上面的示例中,腳本代理的意向設置為 order_status,該意向中的槽“first_name”設置為“John”,並將名為“track”的上下文添加到會話中。
此事件對於腳本化代理會話必須由流邏輯控制的用例非常有用。 一些特別有用的用例包括:
-
如果流程中的履行失敗,則重新提示使用者輸入資訊
假設代理正在為使用者預訂約會。 收集日期和時間后,此資訊將通過自定義事件發送到流,然後嘗試使用 HTTPS 請求活動預訂約會。 如果約會因日程安排衝突而被拒絕,AI 代理需要請求備用時間段。 若要解決此問題,開發人員可以使用以下事件有效負載:
{“意向”:“預約”,“插槽”:{“時間”:“”}在這種情況下,將為時間收集的值將被清除,並且 AI 代理會提示使用者提供一個新值。 開發人員可以設置條件回應,讓使用者知道以前的槽不可用並請求新的時間。
-
導覽到其他意圖
考慮這樣一種情況:使用者請求檢查其餘額,但作為先決條件,用戶必須首先驗證其身份。 作為平衡查詢過程的一部分,開發人員可以發送事件有效負載,以通知流是否已驗證使用者。 如果驗證,系統可以繼續提取餘額;如果沒有,流可以提示 AI 代理使用以下事件有效負載啟動使用者驗證過程:
{“意向”:“驗證使用者”,}在同一示例中,假設驗證需要使用者的出生日期和 PIN 代碼。 流中已經通過 CJDS 具有有關使用者出生日期的資訊,這些資訊可以作為插槽傳遞,並且只能收集 PIN 代碼。 其事件有效負載將如下所示:
{“意圖”:“驗證使用者”,“插槽”:{“出生日期”:“06/26/1993”} } - 在對話中引入或重置上下文
當對話上下文需要更新時,開發人員可以將其包含在 state_update
事件的事件有效負載中。 例如,在 AI 代理收集“驗證使用者”意向的槽後,它會將對話上下文設置為“驗證”。 如果流中的驗證失敗,則應重置上下文,以防止使用者訪問需要“驗證”上下文的意圖。 此方案的事件有效負載如下所示:{“意圖”:“驗證使用者”,“插槽”:{“出生日期”:“”,“PIN 碼”:“”},“上下文”:{“驗證”:0 } }