Introducción

El componente "Funciones (con IA)", diseñado para potenciar las capacidades del componente "Conversaciones" al permitir que la inteligencia artificial no solo entienda el lenguaje natural de los clientes, sino que también ejecute acciones reales durante la conversación, como consultar APIs externas, gestionar bases de datos o interactuar con sistemas de terceros.

Este componente permite crear y almacenar funciones en código PHP que la IA del componente "Conversaciones" puede invocar de forma autónoma en el momento adecuado, según el contexto de la conversación. Las funciones no requieren que el agente virtual "salga" del flujo conversacional para ejecutar lógica adicional: todo ocurre de manera transparente y en tiempo real, mientras el asistente sigue interactuando con el cliente.

¿Cómo funciona en conjunto con el componente "Conversaciones"?

El componente "Funciones (con IA)" actúa como una biblioteca de funciones PHP disponibles para el componente "Conversaciones". Una vez creadas las funciones, estas pueden activarse o desactivarse individualmente desde el panel de configuración del componente "Conversaciones", en la pestaña "Funciones". La IA decide cuándo y cómo llamar a cada función según la intención detectada en la conversación.

Disponibilidad

El componente "Funciones (con IA)" está disponible para routing points de tipo:

• Voice (IVR): El asistente reconoce la solicitud del cliente mediante voz (ASR), determina qué función ejecutar y responde con síntesis de voz (TTS), todo en la misma llamada.
• Chat (ChatBot): El asistente interpreta mensajes de texto, e incluso imágenes o capturas de pantalla enviadas por el usuario (como tablas con datos), para ejecutar múltiples operaciones de forma encadenada en una sola sesión de chat.

Nota importante: Solo puede existir una instancia del componente "Funciones (con IA)" por lienzo. Este componente se coloca de forma independiente al flujo principal: no se conecta mediante flechas a los demás componentes del routing point. Funciona como una biblioteca global a la que el componente "Conversaciones" accede durante la ejecución.

Casos de uso sugeridos

Voice Routing

• Gestión de campañas de marcación: Un supervisor llama al IVR, indica por voz qué campañas predictivas desea activar o pausar, y el sistema ejecuta las operaciones a través de la API de wolkvox sin intervención manual.
• Consulta de saldo o estado de cuenta: El cliente llama y solicita información sobre su saldo; la IA consulta el sistema de facturación mediante una función PHP y responde con los datos actualizados.
• Creación de tickets en sistemas externos: Durante una llamada, el asistente recopila la información del problema del cliente y abre automáticamente un ticket en herramientas como Zendesk, Freshdesk o sistemas internos vía API.
• Verificación de identidad: La IA consulta una base de datos interna para validar si el número de documento o el PIN del cliente es correcto antes de continuar con la atención.
• Agendamiento de citas: El asistente recoge fecha, hora y tipo de servicio, y registra la cita directamente en el sistema de agendamiento de la empresa a través de una función que consume su API.

Chat Routing

• Gestión de campañas mediante imagen: El agente de chat puede recibir una captura de pantalla con una tabla de campañas, identificar los IDs y ejecutar las acciones solicitadas sobre cada una de ellas.
• Consultas dinámicas de inventario: El cliente pregunta por la disponibilidad de un producto; la IA llama a la función correspondiente, consulta el ERP o sistema de inventario y responde con disponibilidad, precios y tiempos de entrega en tiempo real.
• Generación de cotizaciones o resúmenes: A partir de la conversación, la IA puede construir y enviar resúmenes de lo acordado, registrándolos en el CRM del cliente mediante una función PHP.
• Actualización de datos del cliente: El usuario solicita cambiar su correo electrónico o dirección; la IA ejecuta la función que actualiza el registro en el sistema y confirma el cambio en la misma conversación.
• Notificaciones y alertas automáticas: Cuando se detecta una intención específica, la IA puede disparar alertas por correo, SMS o sistemas internos mediante funciones PHP con integraciones externas.

Cómo configurar el componente "Funciones (con IA)"

1. Agregar el componente al lienzo. Desde el lienzo de wolkvox Studio, en la pestaña “Cognitive”, busca y arrastra el componente "Funciones (con IA)" al área de trabajo.
   1. Importante: Coloca este componente fuera del flujo principal. No debe estar conectado con flechas a ningún otro componente. Su presencia en el lienzo es suficiente para que esté disponible para el componente "Conversaciones".
2. Haz doble clic izquierdo sobre el componente "Funciones (con IA)" para abrir su panel de configuración.

En el campo "Nombre de la Función", encontrarás un menú desplegable que lista las funciones ya creadas. Para crear una nueva:

Haz clic en el botón "+" ubicado junto al menú desplegable.

En el campo de nombre de la función, la IA se encargará de crear un nombre descriptivo y acorde a lo que realiza la función. En funciones vacías se creará el nombre “new_pending”.

Para eliminar una función existente, selecciónala en el menú desplegable y haz clic en el botón "-".

Usa el campo "Redacta la petición:" para describir en lenguaje natural qué debe hacer la función. Luego haz clic en el botón "Generar con IA". La IA producirá el código PHP correspondiente, incluyendo validaciones, llamadas a APIs y manejo de errores.

1. El campo "Descripcion" es completado automáticamente por la IA. Describe brevemente qué hace la función (ejemplo: "Starts or stops a specific wolkvox campaign using its ID and the desired status"). Puedes editarlo manualmente si lo deseas.
2. En el área "PHP" puedes modificar el código manualmente: Si ya conoces la lógica y los endpoints necesarios, modifica directamente el código PHP de la función.
   • Tip: Si la función requiere credenciales como tokens de autenticación, API keys o URLs específicas de tu entorno, revisa el código generado por la IA e incorpóralas manualmente en los campos correspondientes antes de guardar.
3. Haz clic en el botón "Guardar" para almacenar los cambios.
4. Luego haz clic en el botón "Cerrar" para salir del panel.
   • Advertencia importante: Si cierras el panel usando el botón "X" de la esquina superior izquierda, la configuración no se guardará, aunque previamente hayas hecho clic en "Guardar". Siempre usa el botón "Cerrar" para salir correctamente.

Para que la IA pueda utilizar las funciones creadas, debes habilitarlas dentro del componente "Conversaciones":

1. Haz doble clic sobre el componente "Conversaciones" en el lienzo para abrir su panel de configuración.
2. Dirígete a la sección “Funciones”.
3. Verás una tabla con todas las funciones disponibles del componente "Funciones (con IA)", mostrando su nombre, descripción y variables. Activa las que desees usar marcando su checkbox correspondiente.
   • Las funciones no seleccionadas permanecen disponibles en el componente "Funciones (con IA)" pero no serán invocadas por la IA en este flujo conversacional. Esto permite mantener una biblioteca de funciones reutilizable y activarlas de forma selectiva en cada routing point.
4. En la pestaña "Objetivo, tono de la conversación", escribe un prompt que sea coherente con las funciones habilitadas. La IA utilizará este contexto para saber cuándo y cómo invocar cada función.
   • Tip: El prompt debe orientar a la IA sobre el propósito del asistente, las restricciones del proceso (como el formato de los IDs) y cualquier información de contexto que ayude a la IA a invocar las funciones de manera correcta y oportuna.
5. Haz clic en “Guardar” para aplicar los cambios.
   • No olvides compilar tu flujo una vez termines de configurar todos los componentes que colocaste.