Los agentes IA son piezas configurables: cada uno tiene instrucciones, conocimiento y herramientas. Solo el propietario y los administradores pueden crear y editar esta sección.
Qué es un agente
Un agente es una especialidad dentro de la IA. En Agentes IA → Agentes puedes crear un agente con Nombre, Proveedor de IA, Modelo, Instrucciones, Descripción para handoffs, categorías de conocimiento y herramientas.
Por defecto, el agente usa la conexión de la empresa. Si necesitas que un agente concreto use otro proveedor, puedes elegirlo en su formulario, añadir su propia API key, completar la Base URL si corresponde y pulsar Probar conexión. Al editar, puedes dejar la clave vacía para conservar la actual.
Las categorías de conocimiento definen qué documentos puede consultar. Si aún no tienes categorías claras, revisa La base de conocimiento. Las herramientas definen qué acciones o consultas externas puede hacer el agente.
Buenas instrucciones
Las Instrucciones son la personalidad y las reglas del agente. No escribas solo “responde amable”. Explica su rol, qué puede resolver, qué no debe prometer, cuándo debe buscar en conocimiento y cuándo debe transferir a un humano.
- Define el rol: “Eres un agente de soporte para cambios y devoluciones”.
- Marca límites: “No inventes stock, precios ni fechas si no aparecen en documentos o herramientas”.
- Indica tono: breve, claro, cordial y orientado a resolver.
- Explica cuándo derivar: reclamos sensibles, cliente molesto o solicitud explícita de una persona.
La Descripción para handoffs es diferente: la leen otros agentes para decidir cuándo derivarle una conversación. Escríbela como una ficha corta, por ejemplo Especialista en problemas técnicos y devoluciones.
Equipos y lienzo
Un equipo agrupa agentes y define cómo colaboran. En Agentes IA → Equipos crea un Nuevo equipo con nombre y descripción. Luego entra al equipo para dibujarlo en el lienzo visual.
Añade agentes al lienzo
Usa Añadir agente para colocar agentes activos en el canvas. Puedes moverlos para ordenar el equipo.
Marca el agente de entrada
El botón con estrella marca quién recibe el primer mensaje. En modo Handoffs aparece como Entrada; en modo Supervisor aparece como Orquestador.
Conecta derivaciones y guarda
Las líneas indican a quién puede derivar o consultar cada agente. En Handoffs, el agente destino pasa a hablar con el cliente. En Supervisor, el orquestador consulta a los agentes conectados y responde él al cliente. Pulsa Guardar o Guardar cambios antes de probar.
El Playground permite probar el equipo sin WhatsApp. Escribe como si fueras el cliente: verás qué agente responde, qué herramientas usa y si solicita transferencia a humano.
Herramientas
Una herramienta permite que un agente consulte un sistema externo desde la conversación. En Agentes IA → Herramientas puedes crear un Nuevo tool de tipo Endpoint HTTP o Servidor MCP, según tu plan y tu integración.
Endpoint HTTP
Sirve para llamar una URL concreta, por ejemplo consultar stock o estado de pedido. ConfiguraMétodo, URL, parámetros y, si hace falta, Header Authorization. El nombre debe ir en formato como consultar_stock, porque el agente lo usa como acción.
Servidor MCP
Sirve para conectar un servidor que expone varias herramientas. Completa la URL del servidor MCP (Streamable HTTP). Si tiene autorización, guarda el header correspondiente; se almacena protegido y no se muestra completo.
Usa el botón Probar antes de asignar una herramienta a agentes. Si la herramienta HTTP tiene parámetros requeridos, FlujosChat te pedirá valores de prueba. En MCP, la prueba intenta conectar y listar las herramientas disponibles.
Enlazar con un flujo
Los equipos IA entran en producción cuando un flujo les entrega la conversación mediante el paso entrega a un equipo de IA. El flujo recoge lo predecible, pasa el contexto que ya tenga y cierra su sesión; desde ese punto, el equipo IA atiende los siguientes mensajes.
Para diseñar esa parte, primero crea y prueba el equipo. Después edita el flujo y añade el paso de entrega donde la conversación deja de ser cerrada y necesita lenguaje natural. Puedes repasar los tipos de paso y la lógica general en Flujos.
No entregues todo a la IA