Agentes de IA

Objetivo

Crea y configura agentes de IA que responden en Email, WhatsApp, Web Chat y Voz. Cada agente define sus canales, las capacidades que puede usar (documentos, tablas de datos, búsqueda web, CRM, calendario, email, webhooks), un modelo de IA y un system prompt. Puedes construir un agente con Helio (conversacional), a partir de una plantilla, o manualmente con un asistente de 5 pasos.

Acceso

Sidebar -> Agents

Rutas:

• Lista: /app/{tenant}/agents
• Editar: /app/{tenant}/agents/{id}/edit
• Probar: /app/{tenant}/agents/{id}/test

Roles

• Ver, crear, editar, probar y activar/desactivar agentes: todos los roles (owner, admin, agent).
• Duplicate y Delete: solo owner y admin.

Requisitos previos

• Email verificado y una suscripción activa (un workspace restringido o suspendido no puede crear agentes).
• Por debajo del límite de agentes de tu plan. El límite cuenta agentes activos; los agentes suspendidos no ocupan un cupo.
• Una key de proveedor de IA conectada en Integrations, o un plan que incluya modelos. Qué modelos aparecen depende de los proveedores que tengas conectados y de tu plan.
• Create with Helio y el Prompt Wizard requieren tu propia OpenAI API Key (puedes añadirla en línea durante el flujo).
• Requisitos por capacidad (solo si activas esa capacidad):

Crear un agente

En Agents tienes tres formas de empezar:

• Create with Helio: describe el agente con tus palabras y Helio prepara la configuración por ti.
• Manual: abre el asistente de 5 pasos en blanco.
• Templates: parte de una plantilla prediseñada que prellena el asistente.

Las tres opciones ejecutan las mismas validaciones y controles de cupo antes de guardar el agente.

Create with Helio

1. Pulsa Create with Helio.
2. Describe qué debe hacer el agente y selecciona los canales que quieres.
3. Helio hace una pregunta de seguimiento si necesita más detalle y luego propone un borrador: nombre, descripción, system prompt, capacidades recomendadas y webhooks que encajan.
4. Revisa el borrador. Pulsa Start over para rehacerlo, o Continue para abrir el asistente prellenado.
5. Ajusta lo que quieras en el asistente y crea el agente.

Helio usa tu OpenAI API Key. Si no hay ninguna conectada, el diálogo te guía para añadirla en línea. La voz es un tipo de agente aparte, así que seleccionar Voice desactiva los canales de texto (y viceversa).

Partir de una plantilla

Pulsa la opción de plantillas para elegir un agente prediseñado. La plantilla prellena los campos del asistente; revisas y ajustas antes de crear.

Crear manualmente (asistente de 5 pasos)

Pulsa Manual para abrir el asistente. El encabezado muestra el paso actual (1 a 5). Usa Next y Back para moverte entre pasos. Para cerrar debes usar la X o Cancel (un clic accidental fuera no descarta tu trabajo).

Paso 1: Basic Information

Paso 2: Configure Channels

Selecciona uno o varios canales. Se requiere al menos uno. Voice es mutuamente excluyente con los demás canales: activar Voice desactiva Email, WhatsApp y Web Chat, y activar cualquiera de esos desactiva Voice.

En WhatsApp y Web Chat puedes activar Accept attachments (images, voice notes, documents). Cuando está desactivado, ese canal responde solo a texto e ignora cualquier archivo que envíe el cliente.

Paso 3: Agent Capabilities

Elige qué capacidades tendrá este agente. Todas son opcionales.

Detalles por capacidad:

• RAG: si no hay una Google key conectada, un campo en línea te permite añadirla. Una vez conectada, selecciona documentos de la lista o sube nuevos (PDF, TXT, MD, DOCX, hasta 10 MB cada uno) con un preset de tipo de documento (General, Legal, Technical, FAQ). Los documentos recién subidos se seleccionan automáticamente. Debes seleccionar al menos un documento.
• SQL Database Access: elige las tablas de datos que el agente puede usar. Para cada tabla seleccionada eliges las operaciones permitidas — Read siempre está activo; Insert, Update y Delete solo están disponibles si la propia tabla las permite.
• Web Search: si no hay key conectada, un campo en línea te permite añadir una.
• CRM: elige entre Search, View Details, Create, Update, mover entre etapas del pipeline, listar por etapa, Tag, Task, Note, asignar propietario y leer historial.
• Calendar: selecciona la cuenta de Google conectada y luego elige las acciones permitidas (list, create, update, delete). Si no hay cuenta conectada, conéctala en línea. Debe haber una cuenta seleccionada para poder continuar.
• Gmail: selecciona la cuenta de Gmail conectada, o conecta una en línea.

Webhooks (mismo paso): selecciona los webhooks que este agente puede llamar. Solo aparecen los webhooks creados en el módulo Webhooks; los desconectados se ocultan con una nota para reconectarlos.

Paso 4: Craft Your Agent's Brain

Este paso construye el system prompt — las instrucciones que definen la personalidad, reglas y límites del agente.

• Lanza el Prompt Wizard para generar un prompt optimizado a partir de tu descripción, canales y capacidades seleccionadas. El asistente requiere una OpenAI API Key; si no hay ninguna conectada, añádela en línea primero.
• O elige escribir el prompt manualmente (omitir el asistente).

Tras generar un prompt puedes editarlo en línea, regenerarlo o borrarlo. Un contador de caracteres muestra el uso frente al límite.

Paso 5: AI Configuration

Si no hay ningún modelo utilizable (por ejemplo, falta la OpenAI key o no funciona), este paso muestra un campo en línea para corregir la key. Pulsa Create Agent para guardar.

Editar un agente

Ruta: /app/{tenant}/agents/{id}/edit

El formulario de edición usa cuatro pestañas:

Campos exclusivos de AI Config:

• Timezone: sobrescribe la zona horaria del tenant para este agente. Déjalo vacío para usar la zona por defecto del tenant.
• Human Escalation — Detect escalation requests: activo por defecto; permite que el agente reconozca cuándo un cliente pide un humano.

El botón Helio (arriba a la derecha) abre el copiloto del agente para diagnosticar, corregir y gestionar el agente. Requiere una OpenAI key y un system prompt. Cuando haces cambios, un badge indica que Helio puede revisarlos; también puedes ejecutar diagnósticos específicos (runtime, calidad de datos, salud de integraciones, rendimiento, cumplimiento).

Acciones: Save Changes para guardar, o vuelve a Agents para descartar.

Probar un agente

Ruta: /app/{tenant}/agents/{id}/test

La consola de prueba te permite probar el agente antes o después de activarlo:

• Envía mensajes de prueba y lee las respuestas del agente.
• Inspecciona Insights y la traza para ver qué capacidades se ejecutaron (documentos, tablas de datos, búsqueda web, herramientas de integración).
• Para agentes de voz, inicia una sesión de voz en vivo con voz e idioma seleccionables, un saludo inicial opcional, comportamiento de fin de llamada y un timeout de inactividad.
• Activa o desactiva el agente desde la consola.

Si falta la key del proveedor del modelo, la consola muestra un aviso para que la conectes primero.

Gestionar agentes

La lista de Agents muestra una card por agente con conteos Total / Active / Inactive, además de búsqueda y orden (newest, oldest, name, active first).

Cada card muestra los canales y capacidades del agente como iconos, su modelo y temperatura, y un toggle de estado. Aparece un badge de "needs attention" cuando el agente tiene un problema de configuración, y badges de equipo cuando el agente lidera o pertenece a un equipo.

Acciones de la card:

• Edit y Test (todos los roles).
• Ask Helio: abre el chat de Helio con este agente preseleccionado.
• Toggle de estado: activa o desactiva el agente (activar cuenta para el límite de agentes de tu plan).
• Duplicate y Delete (solo owner y admin): Duplicate crea una copia y la abre para editar; Delete pide confirmación.

Buenas prácticas

• Usa un nombre claro por caso de uso (Soporte, Ventas, Cobros).
• Habilita solo los canales que realmente vas a operar.
• Para RAG, sube documentos limpios con nombres descriptivos y elige el tipo de documento adecuado.
• Para SQL, otorga solo las tablas y operaciones que el agente realmente necesita; mantén Read-only salvo que se requieran escrituras.
• Mantén el system prompt dentro del límite, especialmente en agentes de voz.
• Prueba en la consola y revisa la traza antes de activar.

Errores comunes

• No aparecen modelos: conecta una key de proveedor en Integrations, o tu plan puede no incluir modelos. Una OpenAI key presente pero rechazada o sin cupo también oculta sus modelos — corrige la key en línea.
• No se puede activar RAG: conecta una Google AI API Key y selecciona al menos un documento.
• No se puede activar SQL: crea al menos una tabla de datos primero.
• No se puede activar Web Search: añade una API key de búsqueda web.
• No se puede crear un agente: puede que hayas alcanzado el límite de agentes de tu plan, o que tu email no esté verificado. El canal de email requiere además que el módulo Inbox esté habilitado para tu workspace, lo cual es un despliegue gradual — contacta a soporte si lo necesitas.

Relacionado

• Documents
• Data Tables
• Webhooks
• Integrations
• Voice Agents
• Contacts