Tipos de pasos de un agente
Un agente se compone de pasos que se ejecutan en orden. Esta página explica los pasos básicos del constructor y qué configurar en cada uno. Los pasos de herramientas y de conectores están resumidos al final.
| Paso | Categoría | Para qué sirve |
|---|---|---|
| Preguntar al agente | IA | Envía un texto a un modelo de IA y guarda la respuesta. |
| Enviar mensaje | Canales | Envía un mensaje (con o sin documento) por un canal o en la conversación de un chatbot. |
| Generar informe | Utilidades | Resume con IA la actividad de tu cuenta en un periodo. |
| Ruta | Controles de flujo | Divide el flujo en ramas según condiciones. |
Para agregar cualquiera de ellos, haz clic en + en el constructor y elige el paso en Agregar paso.
Preguntar al agente
Es el paso de inteligencia: le envías un mensaje a un modelo de IA y su respuesta queda disponible como variable para los pasos siguientes.
img/pasos-preguntar-agente.pngCampos principales
- Modelo: el modelo de IA a usar. Si lo dejas en Modelo predeterminado, se usa el modelo por defecto de la plataforma.
- Rol del agente: las instrucciones generales (por ejemplo: «Eres un asistente de ventas amable y breve…»).
- Mensaje del usuario: lo que se le pregunta al modelo. Normalmente
{message_text}para pasarle el mensaje recibido, pero puedes combinarlo con otras variables y texto.
Salida estructurada
Activa Salida estructurada para pedirle al modelo varios datos a la vez en lugar de un solo bloque de texto. En Campos de salida escribe los nombres separados por comas (por ejemplo nombre, correo, telefono). Cada campo se convierte en su propia variable ({nombre}, {correo}, {telefono}) para usarla en pasos posteriores, como crear un contacto en el CRM.
Opciones avanzadas
- Turnos de historial: cuántos pares de mensajes anteriores de la conversación se incluyen como contexto. Pon 0 para no usar historial.
- Memorias: antepone al prompt las memorias del usuario que selecciones (por ejemplo «El usuario prefiere respuestas en inglés»). Puedes agregar nuevas memorias desde el mismo panel.
- Búsqueda web: usa la búsqueda web integrada del modelo (disponible en modelos de OpenAI y Gemini).
- Base de conocimiento (Personaliza tu agente): agrega fuentes de conocimiento subiendo un archivo (PDF o .doc) o pegando texto, y selecciónalas para que el agente las consulte al responder.
Si el mensaje recibido trae una imagen adjunta, el agente la envía al modelo junto con el texto.
Enviar mensaje
Envía un texto (y opcionalmente un documento) a un destinatario.
img/pasos-enviar-mensaje.pngOrigen del mensaje
| Opción | Cuándo usarla |
|---|---|
| Canal del agente de IA | Envía por uno de los canales que conectaste al agente (Telegram, WhatsApp, Slack). Eliges el Canal y el Destinatario. |
| Conversación de chatbot existente | Responde en el mismo chat que activó el flujo, por el canal en el que el cliente ya escribe (por ejemplo WhatsApp o el chat web). Solo funciona cuando el disparador del agente es un chatbot de IA existente. |
Campos
- Destinatario: usa
{sender_id}para responder a quien escribió, o un identificador de chat específico. - Mensaje: el texto. Normalmente incluye la respuesta de un paso anterior, por ejemplo la variable del paso Preguntar al agente.
- Adjuntar documento (opcional): elige un documento ya subido o usa Subir documento nuevo. Si lo defines, se envía como archivo adjunto y el campo Mensaje pasa a ser su leyenda.
Generar informe
Resume con IA la actividad de tu cuenta en un periodo y guarda el texto como variable (para enviarlo después con Enviar mensaje).
img/pasos-generar-informe.png- Rango de fechas: Hoy, Ayer, Esta semana o Este mes.
- Secciones: qué incluir en el informe: Mensajes de la bandeja, Agentes (ejecuciones), Uso de IA, y, si tienes las funciones correspondientes activas: Chatbot, Marketing, Contactos de marketing, Blog Pilot, Redes sociales, Agente de redes sociales, CRM, Creative Suite e Imágenes de IA.
- Rol del agente: las instrucciones para redactar el resumen. Viene con un texto predeterminado (analista breve y amigable, menos de 300 palabras) que puedes cambiar.
Ruta (condiciones)
El paso Ruta divide el flujo en ramas. Cada rama tiene condiciones y sus propios pasos, que solo se ejecutan si esas condiciones se cumplen.
img/pasos-ruta.png- Agrega el paso Ruta. Se crean dos ramas (Ruta A y Ruta B).
- En cada rama escribe un nombre y, en Continuar solo si, define las reglas: un valor (normalmente una variable, como
{categoria}), un operador y el valor a comparar. - Dentro de cada rama usa el botón + para agregar los pasos que se ejecutarán cuando se cumpla.
- Usa Agregar ruta si necesitas más ramas.
Operadores
contiene, no contiene, es igual a, no es igual a, está vacío, no está vacío, empieza con, termina con, mayor que y menor que. Para «mayor que» y «menor que», Makia entiende números escritos con símbolos o separadores (por ejemplo «$50,000» se compara como 50000).
Cómo se combinan las reglas
- Dentro de un mismo grupo, las reglas se unen con y: todas deben cumplirse.
- Con Agregar grupo de reglas «O», la rama se activa si se cumple cualquiera de los grupos.
- Una rama sin condiciones es la alternativa: se ejecuta solo si ninguna de las ramas anteriores se cumplió.
- Varias ramas con condiciones pueden ejecutarse en la misma pasada si todas se cumplen.
- Una variable que no tiene valor se compara como vacía, así que puedes usar está vacío para detectar datos que faltan.
{monto} del mensaje. Una ruta con la regla «{monto} mayor que 1000» avisa a un vendedor; la ruta alternativa responde al cliente con información general.Pasos de herramientas y conectores
Además de los pasos básicos, el catálogo incluye pasos que actúan sobre otras partes de Makia o sobre tus cuentas:
| Paso | Qué hace | Dónde se explica |
|---|---|---|
| Bookflow Agent | Consulta disponibilidad y gestiona citas. | Herramientas del agente |
| CRM Agent | Contactos, empresas, negocios, tareas y notas. | Herramientas del agente |
| External Chatbot | Consulta chatbots y genera respuestas con su personalidad. | Herramientas del agente |
| Marketing Bot | Campañas de marketing y estadísticas. | Herramientas del agente |
| Social Media Agent | Agentes y publicaciones de redes sociales. | Herramientas del agente |
| Gmail | Enviar, responder y gestionar correos. | Canales y conectores del agente |
| Google Sheets | Leer, buscar y escribir filas. | Google Sheets en un agente de IA |