Helio (asistente de IA)
Chatea con Helio, tu copiloto de IA: pregunta por tus agentes, ejecuta revisiones y aplica cambios que tú apruebas.
Objetivo
Helio es tu copiloto de IA para crear y operar agentes. Es un chat a pantalla completa, como una app de mensajería, donde escribes en lenguaje natural y Helio te ayuda a entender, diagnosticar, arreglar y cambiar tus agentes. Puedes preguntar por todo tu espacio de trabajo ("¿cuál de mis agentes necesita atención?") o centrarte en un agente y pedirle a Helio que ajuste sus instrucciones, canales, capacidades, datos y más. Cada cambio que Helio propone se te muestra primero como una tarjeta que revisas y aplicas: Helio nunca cambia nada por su cuenta.
Acceso
Sidebar -> Helio
Ruta: /app/{tenant}/helio
También puedes abrir Helio ya centrado en un agente concreto:
- Desde la lista de Agents, usa Ask Helio en la tarjeta de un agente (abre /app/{tenant}/helio?agent={id}).
- Desde la pantalla de edición de un agente, usa el botón Helio (arriba a la derecha).
Roles
- Abrir y usar Helio: todos los roles (owner, admin, agent).
- Los cambios que aplica Helio siguen los mismos permisos que hacerlos a mano. Las acciones restringidas a owner y admin en otros módulos (por ejemplo duplicar o eliminar) siguen restringidas cuando se piden a través de Helio.
Requisitos previos
- Tu propia OpenAI API key. Helio funciona con tu clave de OpenAI. Si no hay ninguna conectada, el chat abre con una bienvenida breve y un campo en línea para añadirla; hasta guardar una clave utilizable, el campo de escritura queda deshabilitado.
- Si hay una clave pero está rechazada o sin saldo, Helio queda bloqueado y te indica que arregles la clave o añadas fondos a tu cuenta de OpenAI.
- Un espacio de trabajo activo. Crear un agente con Helio ejecuta las mismas comprobaciones que el módulo de Agents (correo verificado, suscripción activa, dentro del límite de agentes de tu plan).
- Para trabajar sobre un agente existente necesitas al menos un agente, o puedes crear uno en línea desde aquí.
El chat único y el selector "Working on"
Helio tiene un solo campo de escritura abajo que nunca cambia. Un desplegable Working on (y la columna izquierda de agentes) elige en qué se centra Helio:
- General — preguntas sobre todo tu espacio de trabajo.
- Un agente concreto — el copiloto centrado en ese único agente.
- New agent — el flujo de creación en línea.
Cambiar de foco conserva tu historial; cada hilo se guarda por separado.
Preguntas generales (de todo el espacio)
Con General seleccionado, Helio responde preguntas que abarcan toda tu cuenta. Puede:
- Darte un panorama de toda la cuenta — qué agentes necesitan atención y por qué, en lenguaje claro.
- Buscar contactos en tu CRM (por nombre, correo, teléfono o estado) e informar los totales.
- Revisar tus créditos de IA y decirte cómo estás.
- Dar un resumen de equipos, cuando Teams está habilitado en tu espacio.
General sirve para leer y responder, no para editar. Para cambiar un agente, elígelo primero en Working on: Helio te lo dirá si le pides un cambio estando en General.
Helio también reconoce algunos atajos aquí: un saludo recibe una respuesta amable; pedir "crear un nuevo agente" abre el flujo de creación; nombrar uno de tus agentes ("abre mi agente de Reservas") salta directo a él.
Trabajar sobre un agente concreto
Elige un agente y Helio carga su configuración actual para razonar sobre el ajuste real. Pregúntale lo que quieras sobre ese agente: que te explique un ajuste, que investigue un problema o que haga un cambio.
Revisiones que Helio puede ejecutar
Cuando conviene investigar antes de responder, Helio ejecuta una revisión y lee el resultado por ti. Nunca muestra detalles internos: te explica lo que encontró en lenguaje claro.
| Revisión | Responde preguntas sobre |
|---|---|
| Performance | Tendencias de uso, tasas de error, tiempos de respuesta y costo. |
| Integration health | Si el calendario, el correo y los webhooks realmente funcionan (no solo que están configurados). |
| Data quality | Registros desordenados o inconsistentes en las tablas de datos del agente. |
| Runtime behavior | Por qué el agente respondió de cierta forma en conversaciones reales. Limitado a unas pocas revisiones por hora; si está momentáneamente no disponible, Helio lo dice en vez de adivinar. |
| Compliance | Exposición de datos personales o riesgo de política en el prompt o los datos. |
Cambios que Helio puede proponer
Cuando pides un cambio, Helio muestra una tarjeta Apply con exactamente lo que va a cambiar. Tú la revisas y haces clic en Apply. Nada se aplica de forma automática, y siempre puedes rechazarlo.
| Área | Ejemplos |
|---|---|
| Datos del agente | Renombrar o redescribir el agente, editar sus instrucciones (system prompt), fijar el idioma de respuesta y la zona horaria, cambiar el modelo o la longitud de respuesta, activar/desactivar o duplicarlo. |
| Canales | Encender o apagar un canal (WhatsApp, Web Chat, Email, Voice). |
| Capacidades | Activar o desactivar documentos (RAG), tablas de datos (SQL), web search, CRM, calendario, Gmail e historial de canal; definir qué acciones de CRM puede realizar el agente. |
| Documentos | Asignar o desasignar documentos, reprocesar un documento, regenerar su resumen o quitarlo de la base de conocimiento. También puedes adjuntar un documento directamente en el chat (PDF, TXT, MD, DOCX). |
| Tablas de datos | Crear o editar una tabla, asignarla/desasignarla, cambiar sus operaciones permitidas y agregar, editar, eliminar o desduplicar filas. |
| CRM | Crear o actualizar contactos, agregar campos personalizados y gestionar etapas del pipeline. |
| Webhooks | Crear o editar una herramienta webhook y asignarla/desasignarla. Cualquier secreto (token, clave, contraseña) lo ingresas tú directamente en la tarjeta Apply y se cifra: nunca lo escribes en el chat, y Helio nunca lo ve. |
| Integraciones | Orientación, y configuración en línea, para conectar una integración o API key que falte. |
| Voz | Actualizar el saludo, el idioma, el tiempo de inactividad y las opciones de grabación/transcripción/resumen/sentimiento de un agente de voz. |
| Tareas programadas | Crear, editar, pausar o reanudar, eliminar o ejecutar una tarea ahora. Ejecutarla ahora puede tardar hasta alrededor de un minuto y medio. |
| Equipos | Crear un equipo, gestionar sus especialistas y definir el modo de respuesta. Despliegue gradual y sujeto a plan: consulta Errores comunes. |
Crear un nuevo agente en línea
Elige New agent (columna izquierda o el desplegable Working on) para crear un agente sin salir de Helio. El flujo avanza por cuatro pasos: Describe, Review, Data, Done. Describe qué debe hacer el agente y elige sus canales; Helio propone un nombre, una descripción, instrucciones y capacidades recomendadas; tú revisas y ajustas, y luego lo creas. Esto usa tu clave de OpenAI igual que el resto de Helio. Para la referencia completa de creación de agentes, consulta Agentes de IA.
Historial de conversaciones
Tus chats con Helio se guardan automáticamente, por usuario (solo tú ves los tuyos).
- New conversation inicia un hilo nuevo; el anterior se conserva en el historial, no se sobrescribe.
- Recent en la columna izquierda lista tus conversaciones más recientes (hasta 30), de más nueva a más antigua, cada una con un título y hace cuánto se actualizó. Abre una para continuarla.
- Delete quita una conversación de tu historial (no se puede deshacer).
- Cada conversación tiene un límite de 20 mensajes. Al acercarte, Helio te avisa; al llegar al límite te invita a iniciar una nueva conversación y conserva lo tratado en el historial.
- Los mensajes individuales tienen un límite de 16.000 caracteres.
- Mientras Helio responde puedes pulsar Stop generating para terminar la respuesta antes y conservar lo escrito hasta ese momento.
Buenas prácticas
- Centra a Helio en lo correcto: usa General para preguntas de todo el espacio y elige un agente concreto antes de pedir cambios.
- Lee cada tarjeta Apply antes de aplicar: muestra exactamente lo que va a cambiar.
- Deja que Helio investigue. Preguntar "¿por qué respondió eso mi agente?" o "¿mi calendario realmente funciona?" hace que ejecute la revisión adecuada en vez de adivinar.
- Ingresa los secretos de webhooks solo en el campo seguro de la tarjeta Apply, nunca en el chat.
- Inicia una nueva conversación para un tema nuevo; mantiene los hilos enfocados y dentro del límite de longitud.
Errores comunes
- Campo de escritura deshabilitado o "Connect your OpenAI key above to start": añade una OpenAI API key que funcione, en línea.
- Clave conectada pero sin saldo: tu cuenta de OpenAI no tiene fondos — añade fondos y vuelve.
- "This conversation has reached its length limit": inicia una nueva conversación. Lo tratado queda en tu historial.
- Helio no cambia un agente desde General: elige primero el agente en Working on. General puede leer e informar, pero los cambios requieren un agente en foco.
- Un área de cambio no aparece (por ejemplo Teams o el modo de respuesta): son un despliegue gradual y dependen de tu plan — contacta con soporte si los necesitas.