AI Hub
noneOneChat ha presentado su potente funcionalidad de AI Agents, haciendo que sea más fácil que nunca crear chatbots con capacidades de IA sin la complejidad de manejar manualmente chat completions y asistentes de IA.
Con AI Agents, los usuarios ahora pueden crear bots de IA avanzados y conversacionales que se integran sin problemas con OpenAI (y todas las demás plataformas GenAI populares), ejecutan tareas de forma independiente y brindan interacciones dinámicas y similares a las humanas, todo con un esfuerzo mínimo.
Ya sea para soporte al cliente, generación de leads o automatización de flujos de trabajo, los AI Agents de OneChat eliminan las barreras del desarrollo de chatbots impulsados por IA, simplificando el proceso tanto para empresas como para desarrolladores.
TODO_VIDEO[a0cd620374]: reemplazar este video con un recurso oficial de OneChat. El agente de IA para reserva de citas creado durante la grabación del taller se puede encontrar aquí.
_ssujxnhe4xygAccediendo a AI Agents y AI Functions
Dentro de tu bot, haz clic en "AI Hub" en la barra de herramientas izquierda para acceder a AI agents y funciones.
_1vegm5dymxlqCreación de un AI Agent
Haz clic en "+ AI Agent" para crear un nuevo AI Agent.
_imhhzwys2g80Nombre y descripción:
En esta sección tendrás que ingresar el nombre y la descripción del AI agent. La descripción será un texto breve que proporcione suficiente contexto sobre cuál será la función del AI Agent.
| Descripción de ejemplo: Este agente se encarga de programar citas con usuarios. El agente primero necesita capturar los datos del usuario, que son nombre, apellido y correo electrónico. Después, el agente necesita obtener los horarios disponibles y, a partir de ahí, permitir que el usuario elija entre ellos. Una vez que se hayan elegido la fecha y la hora, el agente debe reservar la cita. |
_cxqfbvdum2whConfiguración
En esta sección decidirás qué modelo (y plataforma) quieres elegir y cuáles serán los distintos parámetros que modificarán el comportamiento del agente creado.
Nota: Si tu caso de uso requiere que el AI Agent utilice funciones, entonces siempre es mejor usar modelos más avanzados como gpt-4-turbo-preview, ya que los modelos superiores son más estables y precisos al usar funciones.
Actualmente, OneChat es compatible con OpenAI, Deepseek y Grok AI para crear agentes. Pronto se agregarán más modelos, incluidos Google Gemini y Claude.
En esta sección también puedes modificar varios parámetros, como el valor de temperatura y el número de repeticiones, para ajustar aún más el comportamiento del agente.
La función "Number of chat messages before auto summarize" ayuda a gestionar conversaciones largas al condensar automáticamente el historial del chat después de una cantidad determinada de mensajes.
Una vez que la conversación alcanza el límite especificado (por ejemplo, 10, 50 o 100 mensajes), el sistema crea un resumen conciso de esas interacciones y lo vuelve a insertar en el chat como una sola entrada.
Este proceso conserva los detalles clave mientras reduce significativamente el uso de espacio de caracteres, permitiendo una gestión de memoria más eficiente. Al resumir los intercambios anteriores, la IA puede mantener el contexto importante sin sobrecargar el historial del chat, lo que garantiza interacciones más fluidas.
Además, los usuarios pueden personalizar el límite máximo de tokens para los resúmenes, siendo 500 tokens suficientes para chats generales basados en texto y 1,000 tokens recomendados para tareas complejas como la reserva de citas. Esta función mejora el rendimiento de la IA, la claridad de la conversación y la eficiencia del compromiso a largo plazo. Al final también puedes seleccionar la salida preferida, ya sea en texto o en JSON:
Modo avanzado del AI Agent
Cuando el Modo avanzado está habilitado, el AI agent no responde directamente al usuario. En su lugar, almacena la respuesta en el campo del sistema "Last AI Agent Reply". Debes seleccionar un flujo de trabajo para procesar y manejar la respuesta antes de enviarla al usuario.
Características clave
- Formato de respuesta: modifica las respuestas de la IA dividiendo las respuestas largas en varias secciones para mejorar la legibilidad.
- Integración de medios: agrega archivos multimedia relevantes (imágenes, videos o adjuntos) para enriquecer las respuestas.
- Automatización de flujos de trabajo: procesa el contenido generado por IA mediante flujos de trabajo personalizados para mejorar la entrega y presentación de mensajes.
Nota: Cuando el Modo avanzado está habilitado, la función Auto Suggestions se desactivará.
_y103zoc6yxwjPrompt del agente
En esta sección definirás la personalidad (o cómo quieres que se comporte el AI agent), así como su rol (o cualquier personificación) que quieras que siga.
| Rol de ejemplo: El agente de reserva de citas es responsable de programar citas con usuarios. Este agente debe capturar los datos del usuario, como nombre, apellido y correo electrónico, obtener los horarios disponibles, permitir que el usuario seleccione su horario preferido y finalizar el proceso de reserva de la cita. El tono debe ser profesional y amigable, asegurando una experiencia de usuario fluida y positiva durante todo el proceso de programación. |
En la sección de habilidades, tendrás que definir todas las funciones que quieres que realice tu AI Agent, ya sea recopilar datos de información del usuario o tomar horarios para reservar citas; todo debe definirse aquí. En la sección de habilidades, también recibirás orientación sobre qué funciones necesitarás configurar para tus objetivos y metas.
| Habilidad de ejemplo:
Habilidades
Habilidad 1: Captura de datos del usuario
- Esta habilidad necesita capturar los datos del usuario, que son: nombre, apellido y correo electrónico.
- SOLO pregunta por los datos que estén vacíos o sean desconocidos.
- Una vez que todos los datos del usuario se hayan capturado correctamente, debes proceder a obtener los horarios disponibles y continuar con la siguiente habilidad.
Habilidad 2: Selección de horario
- Esta habilidad necesita mostrar los horarios disponibles al usuario.
- Debes mostrar los horarios disponibles en un formato claro y bien presentado.
- Primero muestra las fechas disponibles.
- Una vez que se haya elegido la fecha, entonces debes mostrar las horas disponibles para esa fecha.
Habilidad 3: Reserva de cita
Esta habilidad necesita gestionar la reserva real de la cita.
- Una vez que el usuario haya elegido la fecha y la hora, debes proporcionarle un resumen de los detalles de la cita y pedirle que confirme.
- Una vez que el usuario confirme los detalles de la cita, debes guardar la fecha y la hora elegidas en su formato original tal como las recibiste al obtener los horarios disponibles.
- Una vez guardados, deberás reservar la cita.
- Cuando la cita esté reservada, debes notificar al usuario. |
La función Product & Service Information te permite ingresar descripciones detalladas de tus productos y servicios, incluidas especificaciones, opciones de reserva, detalles de precios y referencias útiles.
Esto garantiza que los usuarios puedan acceder fácilmente a la información relevante sin necesidad de preguntar repetidamente. Al proporcionar datos estructurados, esta función ayuda a agilizar las interacciones, mejorar el compromiso del cliente y optimizar la experiencia general del usuario.
En la sección de restricciones, tendrás que definir los comportamientos que NO quieres que realice tu IA. Esto puede incluir ciertas preguntas que no quieres que la IA haga o ciertas palabras que no quieres que el agente use.
| Restricciones de ejemplo: El agente solo debe procesar solicitudes dentro de una sola sesión de usuario y no debe almacenar datos personales más allá de la sesión. Asegúrate de que todos los prompts y respuestas sean claros y fáciles de usar. Maneja con cuidado los errores en la entrada de datos, proporcionando orientación clara sobre cómo corregir errores (por ejemplo, formato de correo electrónico inválido). Si en cualquier paso el usuario decide cancelar, ofrece una opción para salir del proceso de reserva de manera amable. Los tiempos de respuesta deben ser rápidos para mantener el interés y la satisfacción del usuario. |
Para facilitarte el trabajo, OneChat proporciona el botón "Generate Agent Prompt", que genera las secciones de rol, personalidad, habilidades y restricciones según la descripción proporcionada.
Hay dos escenarios principales en los que esta función es especialmente útil. Primero, si no tienes experiencia escribiendo prompts, te ayuda a estructurar rápidamente un prompt detallado y efectivo sin necesidad de habilidades avanzadas.
Segundo, si prefieres no empezar desde cero, esta herramienta proporciona un marco predefinido que te da una base sólida que puedes modificar y adaptar a tus requisitos específicos.
_sv90f6lnhnk7Creación de AI Functions
Haz clic en "+ AI Function" para crear una nueva AI Function.
En la primera sección tendrás que definir el nombre y la descripción de la función.
| Descripción de ejemplo: Esta función necesita capturar los datos del usuario, que son: nombre, apellido y correo electrónico. En el caso del correo electrónico, el agente necesita validar el formato correcto si el usuario no lo proporciona correctamente. |
En la siguiente sección, tendrás que definir el prompt completo para la función (es decir, qué quieres que haga o ejecute la función).
| Prompt de ejemplo:### Habilidad: capture_user_details
- Esta habilidad captura información esencial del usuario: nombre, apellido y correo electrónico. Garantiza que el correo electrónico proporcionado tenga un formato válido.
#### Pasos de ejecución:
1. Solicita al usuario que ingrese su nombre.
2. Pide el apellido del usuario.
3. Solicita la dirección de correo electrónico del usuario.
4. Valida el formato del correo electrónico usando un patrón regex (por ejemplo, ^[\w\.-]+@[\w\.-]+\.\w{2,4}$).
5. Si el correo electrónico es válido, guarda todos los datos; si no, solicita al usuario que vuelva a ingresar un correo válido.
#### Restricciones:
- Todas las entradas (nombre, apellido y correo electrónico) no deben estar vacías.
- El correo electrónico debe cumplir con las reglas estándar de formato.
#### Reglas de formato:
- Asegúrate de eliminar los espacios en blanco al inicio y al final de la entrada.
#### Manejo de errores:
- Si la validación falla, informa al usuario sobre el error específico (por ejemplo, "Formato de correo electrónico inválido").
- Permite un número predefinido de intentos para volver a ingresar el correo electrónico.
#### Condiciones:
- Continúa capturando los datos solo si el correo electrónico es válido.
- Solicita cada dato del usuario por separado.
- SOLO continúa con la llamada a la función cuando TODOS los parámetros hayan sido capturados. |
En la siguiente sección, tendrás que definir los valores que quieres obtener de la función (como nombre, apellido, etc.) y describirlos, así como elegir en qué CUF quieres que se guarden.
Nota: Asegúrate de marcar la opción "Required" para que el valor sea obligatorio para que la función lo recopile. También puedes marcar la función "Memory", que revisará el historial de conversación para verificar si el valor ya existe. Si existe, omitirá volver a pedirlo y pasará al siguiente parámetro.
Por último, tendrás que adjuntar el flujo (solo se permiten workflows) que debe activarse cuando se llame a la función.
Puedes usar esta función para enviar los valores capturados a otra plataforma mediante integraciones nativas (como googlesheets) o realizar llamadas API a través del nodo de solicitudes externas. También puede recuperar información de una fuente externa y devolverla al AI agent, permitiendo que la conversación continúe sin problemas.
Esto facilita la automatización de tareas, la actualización de información en tiempo real y la mejora de las respuestas de IA con los datos más recientes.
Nota: Ahora puedes usar nodos "Send Message" dentro de los workflows. Esto se hace para permitir que los AI Agents envíen medios y otro contenido dinámico según la información recibida.
_rs6uw9cr3fumSelección de la AI Function
Para que los AI Agents puedan usar AI Functions, tendrás que seleccionarlas dentro de la configuración del AI Agent.
Una vez seleccionada, se verá algo así (con una vista general del prompt de la función).
Nota: Al deseleccionar/seleccionar una función, su prompt aparecerá/desaparecerá del panel superpuesto en consecuencia.
_3blzoyn3pp3iUso de AI Functions
(Solo puedes usar AI Functions en workflows). Puedes seleccionar el nodo AI Function Output desde la pestaña AI Agents en el bloque de acciones. Estos serán los datos que devolverás a tu AI Agent después de que se llame a una función y se procese un workflow.
_sky4jivbkz3uUso de AI Agent
Crea un nodo de acción y selecciona "AI Action:"
Haz clic en Edit Action para seleccionar el AI Agent.
Selecciona el AI Agent principal (el agente que se activará y actuará primero), así como agentes secundarios (si es necesario). También puedes seleccionar el tiempo de espera por inactividad del usuario; si el usuario deja de responder durante una conversación con un AI agent, este tiempo de espera se activará y podrás hacer seguimiento con los usuarios para que vuelvan a interactuar con el bot.
Cuando seleccionas agentes secundarios, el agente principal heredará cualquier función de esos agentes secundarios. Sin embargo, la configuración de personalidad, rol y LLM del AI agent principal será heredada por el agente secundario.
Esta función es particularmente útil cuando deseas mejorar el agente principal con capacidades adicionales sin alterar su funcionalidad central. Al integrar agentes secundarios, puedes ampliar el rango de tareas que el agente principal puede manejar mientras mantienes un flujo de interacción consistente (configuración de personalidad, rol y LLM).
Por último, guarda la información en el CUF de tu preferencia. Este paso es opcional y está diseñado solo para fines de depuración.
Si no guardas la salida en ningún campo personalizado del usuario, la respuesta del bot se enviará automáticamente de todos modos.
Para usar este AI Agent, todo lo que tienes que hacer es enviar el flujo al usuario y el AI Agent comenzará a conversar con él.
También puedes encadenar varios AI Agents (AI agents adicionales) para enrutar al usuario según tus necesidades. Al agente adicional se le enviarán el título y una descripción corta en el system prompt. Una vez que se identifique la intención con el agente adicional, puedes conectar esa intención con otra acción de AI agent.
Esto garantizará que tu bot pueda cubrir la mayor cantidad posible de casos de uso, mientras mantiene un uso optimizado de los tokens del prompt. La conversación completa con el usuario se guardará en el nuevo campo System JSON llamado AI Messages:
Tiempo de espera por entrada incompleta del AI Agent
Input Incomplete Timeout permite que el AI agent espere un período determinado de segundos para capturar todas las respuestas del usuario y procesarlas como una sola respuesta. Esto garantiza que el AI agent procese la entrada completa del usuario antes de generar una respuesta.
Nota: Cada nueva entrada reinicia el temporizador. Por ejemplo, si el tiempo de espera está configurado en 10 segundos y el usuario escribe "hola", comienza la cuenta regresiva. Si envía otro mensaje, como "cómo estás", después de 6 segundos, el temporizador se reinicia a 10 segundos en lugar de continuar desde 7.
_iaejyatij9Creación de AI Tasks
Desde AI Hub, haz clic en AI Tasks y luego presiona "+AI Task".
En la primera sección, tendrás que definir el nombre y el prompt de lo que quieres que haga la tarea de IA. Las AI Tasks son esencialmente una pequeña combinación de chat completions empaquetadas en un conjunto diseñado para realizar tareas únicas.
Puedes usar uno de los presets disponibles para tener una idea de cómo completar el prompt.
En la sección de configuración puedes definir los ajustes del modelo, así como otros parámetros como temperatura y tokens máximos.
En la sección de campo de salida, si tu AI Task requiere una salida (es decir, si estás extrayendo cierta información de un texto más grande), entonces puedes configurar un campo de salida donde el resultado se guardará en un CUF.
Un ejemplo de salida se verá similar a esto:
_sartmtn13gerUso de AI Tasks
En el bloque de acciones, haz clic en AI Actions y luego selecciona AI Tasks en el menú desplegable.
Selecciona la AI Task que deseas ejecutar y luego, en el campo de entrada, ingresa el contenido sobre el cual quieres realizar la AI Task.
El resultado final se verá así:
Este valor luego puede mapearse a un campo de usuario para usarlo posteriormente en otros flujos.
_tdaxzzsezboxSolución de problemas de IA
Principalmente hay dos maneras de abordar la solución de problemas de las respuestas de IA. La primera forma es analizar el campo System JSON "AI Messages".
Puedes ir al resumen del usuario del bot y hacer clic en el JSON de AI Message para analizar en qué paso qué está pidiendo el usuario y qué respuestas está generando la IA.
También puedes revisar cuándo se está llamando a una función:
El segundo método es analizar directamente toda la conversación desde Livechat (con los mensajes del sistema habilitados).
Aquí puedes ver qué AI Agent se está utilizando en el flujo:
También puedes ver cuándo se está llamando a una función.
Al pasar el cursor sobre esto, se revelan los argumentos y salidas procesados por esta función.
Del mismo modo, también puedes ver cuándo se están completando los campos de usuario.