Configurar datos personalizados y eventos personalizados para agentes de IA
Datos personalizados al comienzo de la sesión
Los datos personalizados permiten a los desarrolladores realizar las siguientes tareas:
- Pase datos del cliente para actualizar los parámetros de tiempo de diseño de un agente autónomo. Por ejemplo, pasar el nombre del cliente para un mensaje de bienvenida personalizado.
- Actualice las variables de tiempo de diseño de agentes de IA autónomos. Por ejemplo, optimice los objetivos y las instrucciones para clientes específicos, actualice la descripción de la acción y los espacios con información disponible con el cliente para que no se vuelva a pedir a los usuarios que lo hagan.
Actualmente, los datos personalizados para agentes autónomos de IA solo se admiten a través del canal de voz.
Configurar datos personalizados
- En el Diseñador de flujos de Webex Contact Center, configure la actividad de Virtual Agent V2 en el flujo.
- En la configuración de evento de estado, especifique los siguientes detalles en las columnas
Nombre del evento - Datos de evento:
- Deje el campo Nombre del evento en blanco.
- Introduzca los datos personalizados que desea pasar del Diseñador de flujos al agente autónomo de IA.

Acceda a datos personalizados en AI Agent Studio
Puede acceder a los datos de eventos (configurados en el Diseñador de flujos) utilizando la sintaxis
{{variable name}}de varias secciones del agente autónomo. Se puede acceder a las
variables pasadas en los datos personalizados en el objetivo del agente, el mensaje de bienvenida,
las instrucciones, la descripción de la acción y la descripción de la ranura.

En este ejemplo, el desarrollador utiliza {{customer_name}}en el
mensaje de bienvenida y {{calling_number}}en las instrucciones del agente.
Eventos personalizados para el cumplimiento
El evento personalizado permite a los desarrolladores realizar las siguientes tareas
- Defina una salida personalizada del agente de IA para devolver el control al diseñador de flujo WxCC. Por ejemplo, para ejecutar el cumplimiento dentro del flujo.
- Reanude la conversación con el agente de IA pasando la salida de cumplimiento al Agente de IA desde el flujo. La limitación del tiempo de espera de cumplimiento de la logística basada en flujo de Webex connect no se aplica aquí.
- Apoye los casos de uso de PCI para agentes autónomos, ya que la información PCI permanece dentro de los límites del generador de flujo wXCC.
Actualmente, los eventos personalizados para agentes autónomos de IA solo se admiten a través del canal de voz.
Configurar el cumplimiento personalizado basado en eventos en AI Agent Studio
- En las acciones de agentes autónomos, cree una nueva acción en la que se necesite un cumplimiento personalizado basado en eventos.
- En la sección de cumplimiento, seleccione la opción “Establecer lógica personalizada para el cumplimiento”.
Acceda a datos de eventos personalizados en Flow Designer
Puede acceder al nombre del evento personalizado y a la carga útil desde la sección Variables de salida de la actividad de Virtual Agent V2.
El nombre de la acción se devuelve bajo la variable StateEventName y los espacios recopilados de la acción se devuelven como MetaData:

Invocar evento personalizado desde Flow Designer
- Ejecute la lógica de cumplimiento en el flujo según el nombre de acción o evento recibido en la salida de actividad de Virtual Agent V2.
- Cree y use variables de flujo para actualizar dinámicamente el nombre del evento y los datos del evento que se
enviarán de vuelta. En el ejemplo siguiente, la variable de event_name flujo se establece para que sea el mismo que el nombre del
evento pasado por la actividad de Virtual Agent V2 y la event_data_string variable se
actualiza para contener la salida de la actividad http utilizada para comunicarse con sistemas de
terceros para obtener detalles de disponibilidad de citas.

En la configuración de evento de estado de la actividad de Virtual Agent V2, especifique los siguientes detalles en los campos Nombre de evento - Datos de evento:
- La variable que contiene el nombre de evento La actividad V2 del Agente Virtual ha salido con.
- La variable que contiene datos de cumplimiento que se deben devolver al flujo.

Los eventos personalizados permiten a los administradores realizar las siguientes tareas:
-
Pase datos del cliente para crear respuestas dinámicas. Por ejemplo, pasar el nombre del cliente para un saludo personalizado.
-
Defina una salida personalizada del agente de IA para devolver el control al diseñador de flujo. Por ejemplo, para ejecutar el cumplimiento dentro del flujo.
-
Configure el agente de IA para que comience desde un punto de partida personalizado en lugar del mensaje de bienvenida mediante un evento personalizado.
-
Actualice las variables de estado del agente de IA. Por ejemplo, rellenar previamente el contexto o las ranuras utilizando datos personalizados pasados desde el diseñador de flujo.
Actualmente, el evento personalizado para agentes de IA con script solo se admite a través del canal de voz.
Configurar el evento personalizado entrante en AI Agent Studio
- En la página de configuración del agente de IA, cree una nueva respuesta en la pestaña Respuestas.
- En Respuesta predeterminada, haga clic en + junto al canal predeterminado (Web) para agregar el canal de voz
- En el campo Nombre del evento entrante, defina el nombre del evento que recibe el agente.
Invocar evento personalizado desde Flow Designer
- En el Diseñador de flujos de Webex Contact Center, configure la actividad de Virtual Agent V2 en el flujo.
- En la configuración de evento de estado, especifique los siguientes detalles en las columnas Nombre del evento
- Datos de evento:
-
Escriba el nombre del evento personalizado que ha configurado en la ficha Respuesta de la página de configuración del agente AI en AI Agent Studio.
- Introduzca los datos personalizados que desea pasar del Diseñador de flujos al agente de IA con script.
-
Acceda a datos de eventos personalizados en AI Agent Studio
Puede acceder a los datos del evento (configurados en el Diseñador de flujos) en la sección Respuesta
predeterminada donde configuró su evento entrante. En la siguiente
figura, puede ver que el nombre de evento personalizado "custom_welcome"” y
los datos de evento "" store name"se pasan del Diseñador de flujo a AI Agent
Studio.
Configure el evento de salida personalizado y la carga útil en AI Agent Studio
-
En AI Agent Studio, vaya a la página de configuración del agente de IA con script y vaya a Respuesta, donde desea que el control se devuelva al diseñador de flujo.
-
Agregar evento personalizado a la sección de respuesta predeterminada.
-
Introduzca el nombre del evento y los datos de carga útil del evento en el JSON que desea que se devuelva al flujo.
En este ejemplo, las ranuras recopiladas se
devuelven al flujo con el evento de salida personalizado
“order_details”.
Acceda a datos de eventos personalizados en Flow Designer
Puede acceder al evento personalizado y la carga útil desde la sección Variables de salida de la actividad de Virtual Agent V2.
Event nameSe devuelve debajo de la StateEventName
variable y Event payload se devuelve Metadatacomo
se muestra en la siguiente figura:

Actualizar los valores del sistema en AI Agent Studio
Puede actualizar valores del sistema como contexto, intención y ranura mediante un evento especial
state_updatey Event payloadcon los valores, como se muestra
en el siguiente ejemplo:
{
"intent": "order_status",
"slots": {
"first_name": "John"
}
"context": {
"track": 1
}
}
En el ejemplo anterior, la intención del agente con script se establece en
order_status, la ranura 'first_name' dentro de esa intención se establece en 'John'
y se agrega un contexto llamado 'pista' a la sesión.
Este evento es útil para casos de uso en los que la conversación del agente con script debe ser controlada por la lógica de flujo. Algunos casos de uso en los que esto es especialmente útil incluyen:
-
Vuelva a solicitar información al usuario si falla el cumplimiento en el flujo
Considere un escenario en el que el agente está reservando una cita para un usuario. Después de recopilar la fecha y la hora, esta información se envía al flujo a través de un evento personalizado, que luego intenta reservar la cita usando una actividad de solicitud HTTPS. Si la cita es rechazada debido a un conflicto de programación, el agente de IA debe solicitar una franja horaria alternativa. Para manejar esto, el desarrollador puede usar la siguiente carga útil de eventos:
{ "intent": "book appointment", "slots": { "time": "" } }En este caso, el valor recolectado por el tiempo se borra y el agente de IA solicita al usuario que proporcione uno nuevo. Los desarrolladores pueden configurar respuestas condicionales para que los usuarios sepan que el espacio anterior no estaba disponible y solicitar una nueva hora.
-
Navegue hacia una intención diferente
Considere un escenario en el que un usuario solicita verificar su saldo, pero como requisito previo, el usuario primero debe verificar su identidad. Como parte del proceso de consulta de saldo, los desarrolladores pueden enviar una carga útil de eventos para informar al flujo si el usuario ya ha sido verificado. Si se verifica, el sistema puede proceder a recuperar el saldo; si no, el flujo puede indicar al agente de IA que inicie el proceso de verificación del usuario mediante la siguiente carga útil de eventos:
{ "intent": "verify user", }En este mismo ejemplo, digamos que la verificación requiere la fecha de nacimiento y el código PIN del usuario. Si el flujo ya tiene información sobre la fecha de nacimiento del usuario a través de CJDS, eso se puede pasar como una ranura y solo se puede recopilar el código PIN. La carga útil del evento para eso se verá como:
{ "intent": "verify user", "slots": { "date of birth": "06/26/1993" } } - Introducir o restablecer el contexto en una conversación
Cuando es necesario actualizar el contexto de la conversación, los desarrolladores pueden incluirlo en la carga útil del
state_updateevento. Por ejemplo, después de que el Agente de IA recopila los espacios para la intención de “verificar usuario”, establece el contexto de conversación en “verificar”. Si la verificación falla en el flujo, el contexto debe restablecerse para evitar que el usuario acceda a las intencionaciones que requieren el contexto de “verificar”. La carga útil del evento para este escenario sería como:{ "intent": "verify user", "slots": { "date of birth": "", "pincode": "" }, "context": { "verify": 0 } }