🔁 Invocar un Agente del Estudio de Agentes IA desde un Workflow
Invocar Agente conecta tus Workflows con el Estudio de Agentes IA, para que tu automatización pueda enviar contexto a un agente de IA, recibir una respuesta, y continuar al siguiente paso sin código personalizado.
📋 Contenido de este Tutorial
🔁 ¿Qué es Invocar Agente?
✨ Beneficios Clave
✅ Prerrequisitos y Permisos
⚙️ Configuración de la Acción de Workflow
📤 Usar el Resultado del Agente en Pasos Posteriores
✅ Buenas Prácticas y Casos de Uso
🧭 Cómo Configurar Invocar Agente
❓ Preguntas Frecuentes
🔁 ¿Qué es Invocar Agente?
Es una acción de workflow que ejecuta un agente seleccionado del Estudio de Agentes IA desde dentro de un workflow. Cuando el workflow llega a este paso, el agente se ejecuta en segundo plano, devuelve su respuesta, y la deja disponible para los pasos posteriores del workflow. Esto te permite combinar la lógica del workflow con el razonamiento del agente, contenido generado, y datos estructurados en un solo proceso conectado.
✨ Beneficios Clave
Ejecución de workflow potenciada por IA: corre un agente en un punto específico del workflow y continúa la automatización con el resultado devuelto.
Manejo flexible de datos: envía instrucciones mediante el campo de Mensaje, mapea datos del workflow a variables de entrada, y reutiliza la respuesta en acciones posteriores.
Mejor automatización posterior: usa el resultado del agente en emails, notificaciones internas, actualizaciones de campo, ramas de Si/Entonces, y webhooks.
Toma de decisiones estructurada: haz que el agente devuelva JSON legible por máquina para soportar ramificaciones más limpias.
Workflows operativos escalables: aplica el mismo patrón a enriquecimiento de leads, resúmenes, enrutamiento, preparación de seguimiento, y actualizaciones de registro.
✅ Prerrequisitos y Permisos
Antes de usar esta acción, confirma lo siguiente:
Tienes acceso activo al complemento de Agentes IA con acceso al Estudio de Agentes IA.
El agente está publicado en Producción. Las versiones en Borrador o Staging no aparecen en el selector de la acción de workflow.
Tienes permiso para editar workflows y agentes de IA en tu cuenta.
⚠️ Importante: construye el agente con el disparador de Workflows cuando el objetivo sea ejecutarlo desde esta acción. Este disparador está diseñado para agentes que deben lanzarse directamente desde un workflow, facilitando pasar entradas correctamente, recibir la respuesta, y usar ese resultado en pasos posteriores.
⚙️ Configuración de la Acción de Workflow
La acción incluye estos ajustes principales:
Agente: selecciona el agente en Producción que quieres que el workflow ejecute.
Mensaje: agrega instrucciones en texto libre para la ejecución. Puedes usar campos combinados para enviar contexto específico del contacto o del workflow.
Variables de Entrada: mapea valores del workflow o texto fijo a las entradas nombradas del agente. Las entradas obligatorias faltantes pueden detener la acción.
Guardar Resultado Como: guarda la respuesta completa del agente como un valor personalizado para pasos posteriores del workflow.
📤 Usar el Resultado del Agente en Pasos Posteriores
Usos comunes incluyen:
Guardar el resumen o resultado en un campo personalizado o nota.
Ramificar con lógica Si/Entonces usando valores devueltos por el agente.
Insertar la respuesta en Email, SMS, WhatsApp, o notificaciones internas.
Enviar el objeto completo de respuesta a un webhook o servicio externo.
Referenciar la respuesta en pasos posteriores usando la variable de respuesta del agente.
✅ Buenas Prácticas y Casos de Uso
Mantén las indicaciones concisas y da contexto detallado mediante variables mapeadas cuando sea posible.
Pide al agente que devuelva JSON estructurado cuando el resultado se use para ramificar o actualizar campos.
Renombra claramente cada acción si el workflow usa más de un agente.
Prueba el formato de resultado esperado del agente antes de usarlo en acciones posteriores importantes.
Publica los cambios del agente a Producción antes de esperar que aparezca en la acción de workflow.
Ejemplos de casos de uso: enriquecimiento de leads después de un envío de formulario, resúmenes de conversación después de cerrar un chat, clasificación de ventas según la última consulta, notas de traspaso interno para equipos de servicio, y resultado estructurado enviado a webhooks o herramientas externas.
🧭 Cómo Configurar Invocar Agente
Paso 1: Construye el Agente en el Estudio de Agentes IA. Ve a Agentes IA → Estudio de Agentes IA. Haz clic en Crear Agente, o abre uno existente. En el panel de selección de disparador, elige Workflows. Configura las instrucciones, herramientas, y variables de entrada del agente según los datos que quieras pasar desde el workflow.
Paso 2: Prueba el agente y confirma que el formato de resultado coincida con las necesidades de tu workflow.
Paso 3: Publica a Producción. Solo los agentes publicados en Producción están disponibles en el selector de la acción de workflow.
Paso 4: Agrega la Acción de Workflow. Ve a Automatización → Workflows. Abre un workflow existente o crea uno nuevo. Haz clic en + Agregar Acción. Bajo Estudio de Agentes IA, selecciona Invocar Agente del Estudio de Agentes IA.
Paso 5: Nombra la Acción con algo claro, especialmente si el workflow tiene varios pasos de IA (ej. "Analizador de Mensaje de Lead", "Paso de Resumen IA").
Paso 6: Selecciona el Agente (obligatorio). Si el agente correcto no aparece, confirma que esté publicado en Producción, que se haya construido con el disparador de Workflows, y refresca el constructor si es necesario.
Paso 7: Completa el campo de Mensaje (opcional pero recomendado). Define qué debe hacer el agente cuando el workflow llegue a este paso — puedes usar texto libre y campos combinados para valores dinámicos. Ejemplo: "Analiza el mensaje entrante más reciente de {{contact.name}} y da un resumen breve con próximas acciones recomendadas para el equipo de ventas."
Paso 8: Mapea las Entradas y Guarda. Mapea cada variable de entrada obligatoria. Agrega instrucciones opcionales en el campo de Mensaje. Elige "Guardar Resultado Como" si quieres guardar la respuesta completa. Haz clic en Guardar Acción.
❓ Preguntas Frecuentes
¿Por qué no aparece mi agente en el menú desplegable? Solo aparecen agentes elegibles. Confirma que esté publicado en Producción, que pertenezca a la cuenta actual, y que esté construido para invocación desde workflow.
¿Un workflow puede llamar a varios agentes? Sí. Puedes agregar varias acciones de Invocar Agente en el mismo workflow, en secuencia o en ramas separadas.
¿Qué pasa si el agente falla? La acción falla y el error aparece en el registro del workflow. Se recomienda manejar los fallos mediante lógica de workflow cuando sea necesario.
¿Se consumen recursos de IA adicionales? No hay un recargo separado de workflow — las ejecuciones del agente usan la misma medición que cuando se ejecuta desde el Estudio de Agentes IA.
¿Hay un tiempo límite? Sí. Los agentes deben responder dentro de 60 segundos.
¿Puedo probar esto en un workflow en Borrador? Sí. La acción se puede probar en modo Borrador, y los contactos se procesan una vez que el workflow se publica.
¿Qué tipo de resultado debe devolver el agente? Devuelve texto plano cuando el resultado se insertará en un mensaje o nota. Devuelve JSON estructurado cuando el resultado se usará en ramificaciones, actualizaciones, o integraciones posteriores.