Crear y configurar los agentes de IA

Para obtener más información, consulte las secciones Configurar agente de IA con script y Configurar agente de IA autónomo en la guía de administración de Webex AI Agent Studio.

Configurar agentes de IA en flujo

Puede usar un nodo de agente de IA para responder consultas específicas desde un corpus o base de conocimientos. También puede habilitar conversaciones de varios turnos. El agente de IA puede hacer preguntas de seguimiento, comprender el contexto y proporcionar respuestas personalizadas.

Simplemente arrastre y suelte el nodo AI Agent en su generador de flujo visual para comenzar. Este nodo le ayuda a usar agentes de IA autónomos y con scripts configurados dentro de Webex AI Agent Studio.

Configurar variables de entrada y salida en el nodo de agente de IA

El nodo Agente de IA contiene dos métodos:

• Procesar mensaje: Le permite enviar mensajes de usuario al agente seleccionado y obtener respuestas del agente.

• Cerrar sesión: Permite cerrar una sesión en el agente de IA. En ciertos escenarios, puede ser necesario cerrar una sesión de agente de IA existente e iniciar una nueva. Se puede lograr utilizando un método específico dentro del nodo AI Agent. Por ejemplo, si una sesión permanece inactiva durante un período especificado, el sistema cierra la sesión automáticamente para optimizar los recursos.

1. En el método Mensaje de proceso, configure las siguientes variables de entrada:

   • Tipo de agente: el tipo de agente utilizado en el flujo, como guionado o autónomo.

   • Agente: El agente que procesa el mensaje del usuario y obtiene una respuesta.

     Puede ver los agentes de IA a los que tiene acceso en Webex AI Agent Studio. Para obtener más información sobre la administración de usuarios y agentes en Webex AI Agent Studio, consulte Roles de usuario.

   • Mensaje: el nombre de la variable que contiene el mensaje entrante del cliente enviado al agente de IA elegido

   • Idioma: si el agente de IA elegido es multilingüe, puede elegir el idioma del mensaje entrante en la lista desplegable Idioma. Rellenamos la lista desplegable en función de los idiomas en la configuración del agente de IA.

     Nota: Desactivamos esta lista desplegable para los agentes con un único idioma.

   • Canal: El nombre del canal desde el que el sistema recibe el mensaje del cliente.

   • Identificador de usuario: proporciona el identificador único del usuario para el canal elegido.

   • Parámetros personalizados (opcional): puede pasar información adicional sobre el cliente a Webex AI Agent Studio como un par de valores clave. Asociamos esta información con el perfil del usuario y la utilizamos para conversaciones posteriores. Por ejemplo, puede especificar si un usuario es un cliente nuevo o un cliente existente.

     Se puede acceder a las claves pasadas como parámetros personalizados como ${consumerData.extra_params.<your_key>} en las respuestas del agente.

     Actualmente, los parámetros personalizados solo se admiten para agentes de IA con scripts a través de canales digitales.

   • Parámetros del mensaje (opcional): Puede pasar información adicional sobre el intercambio actual a Webex AI Agent Studio como un par de valores clave.

     No almacenamos este mensaje y solo está disponible para su uso en la siguiente respuesta del agente. Se puede acceder a las claves pasadas como parámetros de mensaje como ${extra_params.<your_key>} en las respuestas del agente.

2. Configure las siguientes variables de salida en el método de mensaje de proceso:

   • TextResponse: La salida de texto configurada dentro del agente de IA; funciona solo si no hay otro tipo de elementos ricos o especiales presentes. Además, para varios elementos de texto en la respuesta, se devuelve el primer elemento de texto.

   • FullResponse: La respuesta completa con todos los elementos enriquecidos y varios mensajes presentes en la salida del agente.

   • Almacén de datos: un JSON/dict de todas las variables de sesión definidas por el usuario dentro del agente

   • TransactionId: El ID de transacción para la solicitud en Webex AI Agent Studio

   • SessionId: El ID de sesión/conversación en Webex AI Agent Studio

   • ConsumerId: El ID de cliente en Webex AI Agent Studio

   • MessageMetadata: Los metadatos asociados con la respuesta actual del agente configurado

   • SessionMetadata: Los metadatos asociados con la sesión para la respuesta actual del agente configurado

     Actualmente, MessageMetadata y SessionMetadata solo son compatibles con agentes de IA con scripts a través de canales digitales.

   • ResponsePayload: La carga útil de respuesta completa de Webex AI Agent Studio

3. Configure las siguientes variables de entrada en el método Cerrar sesión:

   • Agente: El agente que procesa el mensaje del usuario y obtiene una respuesta.

     Puede ver los agentes de IA a los que tiene acceso en Webex AI Agent Studio. Para obtener más información sobre la administración de usuarios y agentes en Webex AI Agent Studio, consulte Roles de usuario.

   • ID de sesión: Cerramos la sesión del agente de IA. El ID de sesión está disponible como variable de salida del método de mensaje Proceso.

Resultados del nodo

Puede ver la lista de posibles resultados de nodo para este nodo. Puede personalizar las etiquetas de nodo mediante el icono Editar (lápiz). El nodo sale a través de uno de los bordes del nodo correspondientes al resultado del nodo. Cada nodo de agente de IA corresponde a un resultado de nodo. Aquí hay una lista de resultados de nodos.

• Error (rojo): indica lo siguiente:

  • onError: cuando el agente no ha respondido con un mensaje.

  • onInvalidCustomerID: cuando falta un identificador de cliente.

  • onInvalidMessage: cuando falta el valor del mensaje.

• Correcto (verde): indica lo siguiente:

  • onSuccess: cuando el agente responde con un mensaje.

  • onAgentHandover: cuando el agente presenta una solicitud de traspaso a los agentes.

• Tiempo de espera (amarillo/ámbar): indica lo siguiente:

  • onTimeOut: cuando el agente no ha respondido en no más de 15 segundos.