Skip to main content

¿Qué son los Agentes de IA?

Los Agentes de IA en Revol son asistentes inteligentes que trabajan con las interacciones de los clientes a través de múltiples canales: el widget de su sitio web, llamadas telefónicas, Telegram, WhatsApp e Instagram. Cada agente tiene su propia personalidad, base de conocimiento, flujo de trabajo conversacional y conjunto de herramientas.

Modos de operación

Los agentes pueden operar en tres modos según las necesidades de su negocio:
El modo pasivo es poderoso para equipos que ya tienen procesos de comunicación establecidos. El agente se convierte en un auditor de calidad permanente: verifica si los operadores siguen los guiones, identifica oportunidades perdidas, monitorea los tiempos de respuesta y revela información valiosa de las conversaciones. Todos los análisis, la extracción de memoria y el seguimiento funcionan igual que en el modo Activo.

Creación de un agente

Haga clic en Crear agente para iniciar un asistente de 2 pasos: Paso 1 — ingrese el nombre del agente (mínimo 3 caracteres) y un mensaje inicial opcional (texto de saludo). Paso 2 — seleccione un caso de uso: Atención al cliente, Ventas salientes, Calificación de leads, Servicio de atención, Reserva de consultas, Recepción de clientes, Recomendaciones de servicios, Programación, Consultas de facturación, Actualizaciones de proyectos, Biblioteca de recursos, Aprendizaje y desarrollo, u Otro. Esto es puramente visual — el caso de uso seleccionado no afecta el comportamiento ni la configuración del agente. Después de la creación, el agente comienza en estado Borrador con un flujo de trabajo predeterminado ya construido.

Estado del agente


Editor de agentes

El editor de agentes es un modal de pantalla completa con 7 pestañas: Agente, Base de conocimiento, Análisis, Herramientas, Widget, Canales, Flujo de trabajo.
Editor de agentes

Encabezado

El encabezado siempre está visible y muestra:
  • Nombre del agente (haga clic para renombrar en línea)
  • Insignia de estado (Activo / Inactivo)
  • Código de inserción — obtenga el fragmento <script> del widget
  • Registros de herramientas — inspeccione todas las ejecuciones de herramientas y eventos de canales
  • Vista previa — enlace al sitio web del cliente donde está instalado el widget, para verlo como lo ven los visitantes
  • Publicar — publicar en el Marketplace (público o privado)

Pestaña Agente

La pestaña de configuración principal donde usted establece los ajustes centrales del agente: prompt del sistema, personalidad, proveedor LLM y memoria de conversación.

Columna izquierda

Prompt del sistema — las instrucciones centrales que definen cómo se comporta el agente. Si se deja vacío, se genera un prompt predeterminado a partir del nombre de su empresa con reglas básicas de comunicación.
Un bloque de seguridad se añade automáticamente a cada prompt del sistema. Previene la inyección de prompts — el agente nunca revelará sus instrucciones, ignorará las reglas de seguridad ni seguirá solicitudes para cambiar su rol. No necesita añadir esto manualmente.
Primer mensaje — texto de saludo que los visitantes ven cuando se abre el chat. Memoria de conversación — campos estructurados que el agente debe recopilar durante las conversaciones. Cada campo tiene: Los campos de memoria se utilizan en el enrutamiento del flujo de trabajo (Condiciones de estado en las aristas) y aparecen en la pestaña Información de la conversación. Por ejemplo, puede definir campos como name, email, budget — el agente intentará recopilarlos naturalmente durante la conversación, y puede enrutar las aristas del flujo de trabajo según si están completados. Cómo funciona la extracción de memoria: después de que cada nodo personalizado genera una respuesta, el sistema realiza una llamada ligera al LLM que analiza los últimos mensajes y extrae valores para los campos configurados. Los valores extraídos se guardan inmediatamente, de modo que los nodos subsiguientes en el mismo turno ya ven la memoria actualizada, lo que permite el enrutamiento basado en estado dentro de un solo turno de conversación.

Columna derecha

Personalidad — 5 controles deslizantes (1–10) que dan forma al estilo de comunicación: Proveedor y modelo LLM — consulte Proveedores LLM. Temperatura — controla la aleatoriedad de las respuestas: 0 = determinista (misma pregunta = misma respuesta), 1 = creativo (respuestas variadas). Predeterminado: 0.7.

Proveedores LLM

4 proveedores, cada uno con un modelo estándar (más rápido, más económico) y uno premium (mayor calidad):
Los modelos premium requieren un plan mejorado. En los planes estándar, los modelos premium están bloqueados con un aviso de actualización.
Todos los proveedores soportan llamadas a funciones (herramientas), streaming, circuit breaker (conmutación automática por error cuando un proveedor está caído) y reintentos con retroceso exponencial en límites de tasa. El LLM se configura globalmente en la pestaña Agente pero puede ser anulado por nodo del flujo de trabajo — por ejemplo, utilice un modelo rápido para la búsqueda de productos y un modelo premium para el formato de la respuesta final.

Flujo de trabajo

La pestaña Flujo de trabajo es un lienzo visual donde usted diseña la lógica de conversación del agente. En lugar de un solo prompt, el flujo de trabajo divide el procesamiento en nodos — cada uno con su propio prompt, herramientas y base de conocimiento — conectados por aristas con condiciones de enrutamiento.
Editor de flujo de trabajo

Flujo de trabajo predeterminado

Cada nuevo agente comienza con este flujo de trabajo preconstruido:
Los nodos de voz están inactivos por defecto — se activan cuando usted habilita la voz.
Flujo de trabajo predeterminado
El nodo Inicio enruta el mensaje a tres agentes del sistema en paralelo. Cada uno procesa el mensaje con sus propias herramientas y conocimiento. El Formateador combina sus resultados en una sola respuesta.

Tipos de nodos

Agregar nodos personalizados

Haga clic en + Agregar nodo en la barra de herramientas del lienzo → ingrese un nombre → un nuevo nodo Personalizado aparece en el lienzo. Puede agregar tantos nodos personalizados como necesite. Los nodos personalizados son la parte más poderosa del flujo de trabajo. Cada nodo personalizado es esencialmente su propio mini-agente con:
  • Objetivo de conversación — un prompt del sistema específico para este nodo (p. ej., “Ayudar a los usuarios a elegir el plan de suscripción correcto según el tamaño de su equipo y presupuesto”)
  • Herramientas — seleccione qué herramientas puede llamar este nodo (independiente de las herramientas a nivel de agente)
  • Base de conocimiento — seleccione fuentes de conocimiento específicas para el contexto RAG de este nodo
  • Anulación de LLM — use un modelo diferente para este nodo
  • Modo agente — habilite las llamadas de herramientas de múltiples turnos (ver más abajo)

Panel de configuración de nodos

Haga clic en cualquier nodo del lienzo para abrir su panel de configuración a la derecha. El panel tiene pestañas que varían según el tipo de nodo: Pestaña General (todos los nodos): Modo agente (solo nodos personalizados con herramientas): Cuando está habilitado, el nodo puede realizar múltiples rondas de llamadas a herramientas antes de responder. Sin el Modo agente, el nodo realiza como máximo 1 llamada a herramienta por mensaje.
Utilice el Modo agente cuando un nodo necesite encadenar múltiples herramientas — por ejemplo, primero buscar productos, luego verificar la disponibilidad de la mejor coincidencia, y después obtener las especificaciones detalladas. Sin el Modo agente, el nodo necesitaría 3 turnos de conversación separados para hacer esto.
Anulación de LLM (todos excepto Inicio): Alterne para usar un proveedor y modelo LLM diferente para este nodo específico. Cuando está desactivado, el nodo usa la configuración global de LLM del agente. El menú desplegable muestra “Predeterminado (configuración del agente)” cuando no está anulado. Pestaña Herramientas (nodos personalizados y del sistema): Lista todas las herramientas disponibles agrupadas por categoría (Productos, Soporte, Documentos). Cada herramienta tiene un interruptor. Las herramientas habilitadas aquí son independientes de la pestaña Herramientas a nivel de agente — usted controla exactamente qué herramientas tiene cada nodo. Pestaña Base de conocimiento (solo nodos personalizados): Seleccione fuentes de conocimiento específicas para el contexto RAG de este nodo. Tiene un menú desplegable “Agregar documento” con búsqueda y filtrado por tipo. Si no se seleccionan fuentes, el nodo recurre a la base de conocimiento global del agente.
Una nota en la parte inferior enlaza a la pestaña Base de conocimiento del agente: “Para que más datos estén disponibles para este nodo, agregue archivos a la Base de conocimiento del agente.”
Pestaña Aristas (todos los nodos): Configure las conexiones salientes hacia otros nodos. Consulte Condiciones de aristas más abajo. Pestaña Configuración de voz (solo nodos STT y TTS): Configure el reconocimiento y síntesis de voz — consulte la sección Voz. Eliminar nodo — disponible solo para nodos personalizados. Los nodos del sistema no se pueden eliminar.

Condiciones de aristas

Las aristas conectan nodos y controlan el enrutamiento de mensajes. Cada arista tiene un nodo destino, un tipo de condición y una prioridad. El flujo de trabajo evalúa las aristas en niveles de prioridad — el primer nivel que produce una coincidencia gana, los niveles inferiores no se evalúan. Haga clic en + Agregar arista en la pestaña Aristas de un nodo para crear una conexión.

Condición de palabra clave

Ingrese palabras clave separadas por comas. El flujo de trabajo verifica si el mensaje del visitante contiene alguna de ellas utilizando coincidencia insensible a mayúsculas con límites de palabra. Múltiples aristas de palabras clave pueden coincidir con el mismo mensaje — todas las aristas coincidentes se activan en paralelo, enviando el mensaje a múltiples nodos simultáneamente. Ejemplo: Palabras clave precio, costo, tarifas, cuánto cuesta — la arista se activa cuando el visitante pregunta “¿Cuánto cuesta?” o “¿Cuáles son las tarifas?”

Condición de estado

Verifica los valores de los campos de Memoria de conversación. Usted construye reglas con: Múltiples condiciones dentro de una arista usan lógica AND — todas deben ser verdaderas.
Las condiciones de estado se omiten completamente si la memoria está vacía (aún no se han recopilado campos). Esto significa que las condiciones “está vacío” no se activarán hasta que el agente haya comenzado a recopilar al menos un campo de memoria.
Ejemplo de flujo de trabajo con Condiciones de estado:

Condición Siempre

La arista siempre se activa. Todas las aristas Siempre de un nodo se activan en paralelo — el mensaje se envía a todos los destinos simultáneamente. Así es como el flujo de trabajo predeterminado se ramifica desde Inicio hacia tres agentes del sistema a la vez.

Condición de respaldo

Enruta solo cuando ninguna arista de mayor prioridad coincidió. A diferencia de Palabra clave y Siempre, solo una arista de respaldo se activa (la primera) — sin ejecución en paralelo.
Si ninguna arista coincide y no hay respaldo, la salida del nodo puede no llegar al Formateador y el visitante no recibirá una respuesta de esa rama.

Estrategia de fusión

Cuando múltiples nodos producen resultados en paralelo (como los 3 agentes del sistema en el flujo de trabajo predeterminado), el Formateador los combina:

Controles del lienzo


Herramientas

Las herramientas son funciones que el agente puede llamar durante las conversaciones. Extienden al agente más allá de la generación de texto: buscar productos, consultar bases de datos, enviar correos electrónicos, realizar llamadas.

Cómo funcionan las herramientas

1

El LLM decide usar una herramienta

Basándose en el mensaje del visitante y las descripciones de herramientas en su prompt, el LLM genera una llamada a herramienta con parámetros (p. ej., get_products({ query: "zapatillas deportivas", available_only: true })).
2

La herramienta se ejecuta

El sistema ejecuta la función de la herramienta con los parámetros proporcionados y obtiene un resultado.
3

El resultado vuelve al LLM

El resultado de la herramienta se inyecta de vuelta en la conversación. El LLM lo usa para formular una respuesta natural.
4

Múltiples rondas (Modo agente)

Si el nodo tiene el Modo agente habilitado, el LLM puede hacer otra llamada a herramienta basándose en el primer resultado — hasta las rondas máximas configuradas.
Cada llamada a herramienta se registra con entrada, salida, tiempo de ejecución y estado. Vea los registros a través de Registros de herramientas en el encabezado del agente.

Herramientas integradas (9)

Siempre disponibles, no requieren integración:

Herramientas de integración (más de 60)

Conecte servicios externos en Integraciones para desbloquear herramientas:
Realice llamadas salientes, envíe SMS, recupere el historial de llamadas.
Envíe mensajes, envíe archivos, edite/elimine mensajes, obtenga historial de chat e información.
Envíe mensajes, envíe medios, envíe mensajes de plantilla, obtenga perfil, marque como leído.
Envíe mensajes, envíe medios, envíe botones (Facebook), obtenga perfil. Facebook Ads: obtenga campañas, conjuntos de anuncios, estadísticas, pause campañas.
Lea la bandeja de entrada, envíe correos electrónicos, responda, cree borradores, busque, obtenga archivos adjuntos.
Liste/cree/actualice/elimine eventos, verifique disponibilidad, encuentre franjas horarias libres.
Lea/cree/añada/exporte/busque documentos.
Lea/escriba rangos, añada filas, actualice celdas, busque filas, cree hojas de cálculo.
Liste/lea/cree/actualice/elimine archivos, cree carpetas, comparta archivos, busque.
Cree enlaces de reunión.
Envíe cargas JSON personalizadas a cualquier URL, pruebe conexiones de webhook.

Pestaña Herramientas vs Herramientas a nivel de nodo

Hay dos lugares para gestionar herramientas:
  1. Agente → pestaña Herramientas — muestra todas las herramientas de integración agrupadas por proveedor. Active/desactive herramientas a nivel de agente. Las herramientas aquí quedan disponibles para todos los nodos del flujo de trabajo.
  2. Flujo de trabajo → Configuración de nodo → pestaña Herramientas — active/desactive herramientas por nodo. Un nodo solo puede usar herramientas que estén habilitadas a nivel de agente. Esto le permite restringir qué nodos tienen acceso a qué herramientas.
Ejemplo: Habilite las herramientas de Gmail a nivel de agente, pero solo dé al nodo personalizado “Enviar seguimiento” acceso a send_email — los demás nodos no activarán correos electrónicos.

Base de conocimiento (RAG)

La pestaña Base de conocimiento conecta fuentes de datos que el agente utiliza para responder preguntas. Cuando un visitante pregunta algo, el agente busca en su base de conocimiento utilizando similitud vectorial (RAG — Generación Aumentada por Recuperación) e incluye el contexto relevante en su respuesta.

Tipos de fuentes

Cómo funciona RAG

1

Agregar fuentes

En la pestaña Base de conocimiento, haga clic en “Agregar documento” y seleccione fuentes de los datos de su empresa — productos, archivos, fragmentos de texto, enlaces.
2

Entrenamiento

El sistema divide cada fuente en segmentos (máximo predeterminado de 2000 caracteres por segmento, 20% de superposición en los límites de oración), genera embeddings vectoriales utilizando OpenAI text-embedding-ada-002 (1536 dimensiones) y los almacena en PostgreSQL con pgvector.
3

El visitante envía un mensaje

El mensaje del visitante se convierte en embedding en el mismo espacio vectorial. El sistema encuentra los segmentos más similares utilizando similitud del coseno.
4

Inyección de contexto

Los segmentos más coincidentes (predeterminado: hasta 5, similitud mínima 0.6) se inyectan en el prompt del agente como contexto de la base de conocimiento.
5

Respuesta

El LLM ve la pregunta del visitante junto con el conocimiento relevante y genera una respuesta informada.
El entrenamiento se ejecuta automáticamente cuando usted agrega o cambia fuentes. El progreso se muestra en la pestaña Base de conocimiento (porcentaje, elementos procesados).

Conocimiento a nivel de agente vs a nivel de nodo

  • Base de conocimiento a nivel de agente (pestaña Base de conocimiento) — fuentes disponibles para todos los nodos del flujo de trabajo
  • Base de conocimiento a nivel de nodo (Flujo de trabajo → Nodo → pestaña Base de conocimiento) — restrinja RAG a fuentes específicas solo para este nodo
Ejemplo: Su nodo personalizado “Soporte técnico” solo ve los manuales de productos y documentos de preguntas frecuentes, mientras que el nodo “Ventas” ve los catálogos de productos con precios.
El contenido específico y bien estructurado funciona mejor que los documentos generales extensos. Las descripciones de productos con parámetros claros dan al agente respuestas precisas. Las entradas cortas de preguntas frecuentes funcionan mejor que los manuales extensos.

Voz

La configuración de voz se establece en la sub-pestaña Voz de la pestaña Widget o directamente en los nodos STT/TTS del flujo de trabajo.

Voz a texto (STT)

Texto a voz (TTS)

Pipeline de voz

1

Audio recibido

El audio del visitante se envía al servidor (máximo 10MB, formatos: webm, ogg, wav, mp3).
2

Transcripción STT

El audio se transcribe a texto. La transcripción se transmite en tiempo real vía SSE.
3

Procesamiento del flujo de trabajo

La transcripción se procesa a través del mismo flujo de trabajo que el texto — RAG, herramientas, enrutamiento de nodos.
4

Síntesis TTS

La respuesta se divide en oraciones, cada una se sintetiza a audio. Los fragmentos se transmiten a medida que se generan.
5

Reproducción

El visitante escucha la respuesta como audio en streaming mientras ve el texto.
La voz requiere un plan con capacidades de voz. En los planes sin voz, los controles de voz muestran un aviso de actualización y el Modo solo chat se activa obligatoriamente.

Canales

La pestaña Canales controla dónde recibe mensajes su agente.

Conexión de un canal

Widget — haga clic en Habilitar. El widget responde en su sitio web inmediatamente. Otros canales:
  1. Conecte la integración en Integraciones
  2. En la pestaña Canales, seleccione un recurso del menú desplegable (p. ej., un número de teléfono, un bot, una página)
  3. Haga clic en Habilitar — se genera una URL de webhook única
Cada tarjeta de canal muestra el estado de conexión, nombre del recurso, total de conversaciones y la URL de webhook con un botón de copiar.

Personalización del widget

La pestaña Widget tiene una vista previa en vivo a la izquierda (selector de escritorio/tablet/móvil) y un panel de configuración a la derecha con 3 sub-pestañas.

Apariencia

Comportamiento

Voz

Configuraciones de STT y TTS — las mismas descritas en la sección Voz. Se configuran aquí o en los nodos STT/TTS del flujo de trabajo (se sincronizan).

Análisis

Diseño de dos columnas: lista de conversaciones (izquierda) + detalle de conversación (derecha).

Filtros

La lista de conversaciones muestra 20 por página con paginación “Cargar más”. Las nuevas conversaciones aparecen en tiempo real vía WebSocket.

Detalle de conversación (4 sub-pestañas)


Arquitectura del prompt del sistema

Comprender cómo se ensambla el prompt final le ayuda a escribir mejores instrucciones.
1

Su prompt del sistema

El texto de la pestaña Agente (o el Objetivo de conversación del nodo para nodos personalizados). Si está vacío, se genera un prompt predeterminado con el nombre de su empresa y reglas básicas.
2

Bloque de seguridad

Se añade automáticamente. 4 reglas anti-inyección — el agente no revelará su prompt, cambiará su rol ni seguirá intentos de anulación.
3

Instrucciones de estilo

Generadas a partir de los controles deslizantes de personalidad — mapea la longitud de respuesta, humor, formalidad, claridad y emojis a instrucciones de texto.
4

Descripciones de herramientas

Esquemas de funciones para todas las herramientas habilitadas, para que el LLM sepa qué puede llamar.
5

Contexto RAG

Segmentos relevantes de la base de conocimiento, inyectados como bloque “Contexto de la base de conocimiento”.
6

Contexto de campaña

Si el visitante llegó a través de una campaña con Comportamiento del agente de IA configurado, ese prompt se inyecta.
7

Estado de la memoria

Valores actuales de los campos de memoria recopilados (p. ej., name: Juan, email: juan@ejemplo.com), para que el agente sepa lo que ya ha recopilado.
8

Detección de idioma

Si el mensaje del visitante no tiene caracteres cirílicos, se añade una instrucción del sistema: “Responda en el mismo idioma que el mensaje del usuario.”

Código de inserción

Haga clic en Insertar en el encabezado del agente para obtener el fragmento HTML:
Esto carga tanto el rastreador (analíticas, campañas, eventos, triggers, intercambio de teléfono) como el widget de chat con su agente activo. Si no existe una clave API, haga clic primero en Generar clave API.

Límites del plan