Agentes, equipos y herramientas

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 pulsa Nuevo agente: se abre su propia página con Nombre, Instrucciones (system prompt), Proveedor de IA, Modelo, Descripción para handoffs, Bases de conocimiento (RAG) y Herramientas. Al terminar pulsa Crear agente (o Guardar si lo estás editando).

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.

Debajo de las instrucciones tienes dos bloques más. Datos del cliente en el prompt inserta marcadores como {{cliente.nombre}} o un campo personalizado: en cada conversación se sustituyen por el dato de ese cliente, y si no lo hay se escribe (sin dato). Imágenes del agente guarda hasta 20 fotos que el agente puede enviar, con una indicación de cuándo usar cada una; para enviarlas necesita la capacidad Enviar imágenes del negocio.

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.

Validar revisa el equipo guardado sin gastar saldo de IA: avisa si falta el agente de entrada, si hay agentes inactivos o a los que nadie llega, o si un agente recibe conversaciones sin tener su descripción para handoffs.

El Playground permite probar el equipo sin WhatsApp. Usa la versión guardada y cada respuesta gasta saldo de IA. Escribe como si fueras el cliente: verás qué agente responde, qué herramientas usa y si solicita transferencia a humano. Como ahí no hay una conversación real, las capacidades que dependen de ella (reservar una cita, guardar datos en la ficha o arrancar un flujo) se niegan; tus herramientas HTTP y MCP sí se llaman de verdad.

En la misma pantalla, Compartir demo genera un enlace público para que alguien sin cuenta pruebe el equipo, y Si el cliente no responde programa hasta tres recordatorios que la IA envía si el cliente deja de contestar (dentro de las 24 h desde su último mensaje; cada uno gasta un poco de saldo).

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 cuatro tipos: Endpoint HTTP, Servidor MCP, Apps Script (Google) o Capacidad del sistema. Cuántas herramientas puedes tener depende de tu plan.

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.

Apps Script (Google)

Sirve para que el agente llame a un script tuyo de Google que lee o escribe tus hojas. Pega la URL de la implementación (termina en /exec), escribe la Acción que despacha tu script y genera la clave compartida. En el mismo formulario tienes el código para tu script.

Capacidad del sistema

Son herramientas que ya trae FlujosChat: Agenda de citas, Botones tocables (en Instagram salen como respuestas rápidas), Enviar imágenes del negocio, Ficha del cliente, Flujos del negocio y las de Google (Contactos, Calendar, Gmail, Sheets, Drive y Directorio). Elige Capacidad del sistema, marca la que quieres, pulsa Activar y asígnala al agente en su página. Las de Google necesitan antes la cuenta conectada: ver Conectar Google.

Usa el botón Probar antes de asignar una herramienta a agentes (es el icono de reproducir de cada fila). Si la herramienta HTTP o Apps Script 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 Agentes IA. En él eliges el Equipo IA, decides si La IA saluda inmediatamente y, opcionalmente, qué Variables que se pasan como contexto (vacío = todas). El flujo recoge lo predecible, pasa ese contexto y cierra su sesión; desde ese punto, el equipo IA atiende los siguientes mensajes. Necesitas tener antes un equipo creado.

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.