Qué es un agente de IA y cómo crearlo

Un agente de IA es una automatización que se activa sola ante un evento (por ejemplo, un mensaje de un cliente o una hora del día) y ejecuta una secuencia de pasos: preguntarle algo a la IA, enviar un mensaje, guardar datos en el CRM, agendar una cita, etc.

Todo agente tiene dos partes:

Disparador: cuándo se ejecuta el agente.
Pasos: qué hace, en orden, cada vez que se dispara.

Antes de empezarSi tu agente va a responder mensajes, primero conecta un canal o usa un chatbot que ya tengas (ver Canales y conectores del agente). Tu plan puede limitar cuántos agentes y canales puedes crear; si llegas al máximo, Makia te lo indica con un aviso.

Tres formas de crear un agente

Entra a Agentes de IA. Tienes tres caminos:

Describirlo con texto. En la pantalla principal escribe qué quieres que haga tu agente (por ejemplo: «Todas las mañanas a las 9 a. m., genera un informe de la actividad de ayer y envíalo a mi canal de Telegram»). Makia arma el flujo por ti y lo abre en el constructor para que lo revises.
Captura pendiente: Pantalla principal de Agentes de IA con el cuadro para describir el agente
img/crear-agente-describir.png
Usar una plantilla. Haz clic en Nuevo agente (en la lista de agentes). Se abre Agregar agente con plantillas por categoría (CRM, Gmail, Outlook, Redes sociales, Marketing, Chatbot, Informes, IA y web). Cada plantilla indica si se dispara Al recibir un mensaje, Programado o Con webhook.
Captura pendiente: Ventana Agregar agente con plantillas por categoría
img/crear-agente-plantillas.png
Empezar desde cero. En la misma ventana elige Empezar desde cero para construir el flujo en un lienzo vacío.

También puedes marcar plantillas como favoritas con la estrella para encontrarlas más rápido.

El constructor de flujos

El constructor muestra el flujo de arriba hacia abajo: primero el bloque del disparador y debajo los pasos. Arriba tienes los botones Deshacer, Rehacer, Chat con Copilot, Probar y Guardar.

Captura pendiente: Constructor de flujos con el disparador y varios pasos
img/crear-agente-constructor.png

Datos del agente

En Configuración del agente puedes definir:

Avatar: elige uno de los predefinidos o sube tu propia imagen.
Nombre del agente y Rol del agente (una descripción breve que se muestra en las tarjetas y en el panel de información del contacto de la bandeja de Mensajes).
Conectores: acceso rápido para administrar tus cuentas de Gmail, Outlook y Google.

1. Elegir el disparador

Haz clic en el bloque del disparador. Verás la pregunta ¿Cuándo debe ejecutarse este agente? con dos opciones:

Disparador	Cuándo se ejecuta
Programación	A una hora o frecuencia fija. Elige un valor predefinido o una programación personalizada con minuto (cada minuto, 5, 10, 15, 30 min, en :00, en :30), hora, día de la semana (todos los días, entre semana, fines de semana o un día concreto) y día del mes.
Mensaje del canal	Cada vez que llega un mensaje. En Origen del mensaje eliges entre un Canal del agente de IA (un canal propio, como Telegram, WhatsApp o Slack) o un chatbot de IA existente (reutiliza los canales ya conectados a ese chatbot, como WhatsApp o Messenger, sin credenciales nuevas).

Chatbot existenteCuando el origen es un chatbot, el agente se ejecuta junto con la respuesta automática del chatbot, no en lugar de ella. Si quieres que solo conteste el agente, agrega un paso Enviar mensaje que responda en la misma conversación (ver Tipos de pasos).

Filtro de palabras clave

Con el disparador Mensaje del canal puedes activar el Filtro de palabras clave para que el agente solo actúe cuando el mensaje cumpla tus reglas. Cada regla compara el mensaje con un valor usando: contiene, no contiene, es igual a, no es igual a, está vacío, no está vacío, empieza con o termina con. Las reglas dentro de un grupo se combinan con y; con Agregar grupo de reglas «O» el agente actúa si se cumple cualquiera de los grupos. La comparación no distingue mayúsculas de minúsculas.

2. Agregar pasos

Haz clic en el botón + del flujo para abrir Agregar paso.
Busca por nombre o filtra por categoría: IA, Agentes, Canales, Controles de flujo, Utilidades o Personalizado.
Captura pendiente: Ventana Agregar paso con las categorías de pasos
img/crear-agente-agregar-paso.png
Elige el paso y configúralo en el panel lateral.
Repite para añadir más pasos. Se ejecutan en el orden en que aparecen.

Cada tipo de paso se explica en Tipos de pasos de un agente.

3. Usar variables entre llaves

Los pasos se comunican entre sí con variables, que se escriben entre llaves, por ejemplo {message_text}. Al ejecutarse, Makia reemplaza cada variable por su valor real.

Variable	Qué contiene
`{message_text}`	El mensaje recibido (con el disparador Mensaje del canal).
`{sender_id}`	El identificador de quien escribió; sirve como destinatario para responderle.
Resultado de un paso	Cada paso guarda su resultado en una variable propia, que puedes usar en los pasos siguientes.

En los campos que aceptan variables verás un botón { }: al hacer clic muestra las variables disponibles (el mensaje, el remitente y el resultado de los pasos anteriores) y la inserta por ti. Así no tienes que escribir el nombre a mano.

Variables que no existenSi un paso usa una variable que ningún paso anterior produce, el constructor te avisa («Estas variables no las produce ningún paso anterior y fallarán en tiempo de ejecución») y, si el agente se ejecuta así, esa ejecución falla en ese paso. Revisa que el paso que genera el dato esté antes del que lo usa.

Memoria y conocimiento

En el paso de IA puedes darle más contexto al agente: una base de conocimiento (archivos PDF o .doc, o texto que pegues) y las memorias del usuario. Se explica en Tipos de pasos de un agente.

Copilot: construir conversando

Dentro del constructor, el botón Chat con Copilot abre un panel donde describes lo que quieres («Describe un flujo de trabajo y lo crearé por ti, o pídeme que modifique pasos existentes»). Úsalo para crear un flujo desde cero o para ajustar pasos que ya tienes. Revisa siempre el resultado antes de guardar.

Probar el agente

Guarda el agente y asegúrate de que esté Activo.
Haz clic en Probar. Se abre el panel Probar agente.
Captura pendiente: Panel Probar agente con una conversación de prueba
img/crear-agente-probar.png
Escribe un mensaje de prueba. Verás la respuesta del agente y puedes abrirla con Ver en Mensajes.

Solo para disparador de mensajesEl panel de prueba funciona con el disparador Mensaje del canal. Si el agente es programado verás el aviso «Se requiere un disparador de canal»; en ese caso cambia temporalmente el disparador o espera a la hora programada y revisa el registro.

Activar, pausar y administrar

En Agentes de IA > Agentes cada agente aparece como una tarjeta con su estado (Activo o Pausado), la fecha de creación y la última ejecución. El menú Opciones del agente de la tarjeta permite:

Editar el agente en el constructor.
Pausar o Activar: un agente pausado no se dispara. Los agentes nuevos se crean activos.
Mostrar registros: abre el historial de ejecuciones.
Eliminar.

El botón Iniciar conversación de la tarjeta te lleva a la bandeja de Mensajes filtrada por ese agente.

Ver las ejecuciones

En Mostrar registros verás cada ejecución con su estado:

Estado	Significado
running (en curso)	El agente todavía está ejecutando sus pasos.
completed (completada)	Todos los pasos terminaron bien.
failed (fallida)	Un paso falló; los pasos siguientes no se ejecutaron y se muestra el motivo.

Con Detalles puedes abrir cada ejecución y ver el resultado paso a paso.

Captura pendiente: Registros de ejecuciones de un agente con sus pasos
img/crear-agente-registros.png

Solución de problemas

Problema	Qué hacer
El agente no se dispara	Comprueba que esté Activo, que el canal o chatbot del disparador sea el correcto y que el filtro de palabras clave no sea demasiado estricto.
La ejecución falla en un paso de IA con «créditos insuficientes»	Tu cuenta no tiene saldo de créditos para el modelo elegido. Revisa tu plan o saldo.
La ejecución falla con «variable sin resolver»	Un paso usa una variable que ningún paso anterior genera. Corrige el nombre o reordena los pasos.
No se envía el mensaje	El paso Enviar mensaje necesita un canal y un destinatario. Para responder al remitente usa `{sender_id}`.
No puedo crear más agentes o canales	Tu plan tiene un límite. Elimina uno que no uses o consulta un plan superior.