Workflows
Los workflows son pipelines de ejecución compuestos por una o más etapas. Cada etapa puede llamar a un agente, definir qué entrada recibe ese agente y pasar resultados hacia adelante para componer la ejecución completa. Los workflows pueden ejecutar agentes de forma secuencial, paralela, condicional o en colaboración basada en equipo.
Cuándo usar
- Usa workflows para convertir tareas repetibles en ejecuciones guiadas.
- Úsalos cuando un entregable necesita pasar por más de un agente.
- Úsalos para generar resultados que pueden revisarse, exportarse, ajustarse o enviarse a integraciones.
- Úsalos para rutinas de monitoreo, informes periódicos, sincronización de backlog u otros pipelines programados.
Antes de empezar
- Confirma la organización activa.
- Crea o selecciona los agentes que deben participar en el workflow.
- Prepara bases de conocimiento si el workflow necesita contexto documental.
- Configura adaptadores antes de usar acciones de entrega por integración.
Paso a paso: navegar por workflows
- Haz clic en Workflows en la navegación principal.
- Usa la búsqueda para encontrar un workflow.
- Filtra por tipo o estado cuando sea necesario.
- Ordena por nombre o fecha.
- Haz clic en una tarjeta para abrir los detalles del workflow.
Paso a paso: crear un workflow
- Haz clic en Crear Workflow.
- Ingresa nombre y descripción.
- Elige el tipo de workflow.
- Define el idioma de salida o mantén la selección automática cuando esté disponible.
- Asocia un proyecto cuando el workflow necesite bases de conocimiento específicas del proyecto.
- Selecciona bases de conocimiento cuando aplique.
- Agrega una o más etapas.
- En cada etapa, elige el agente responsable.
- Configura adaptadores de entrega cuando sea necesario.
- Haz clic en Crear Workflow.
Entiende los campos principales
| Campo | Qué significa |
|---|---|
| Tipo | Define la estructura del workflow, como secuencial, paralela, condicional o basada en equipo. |
| Idioma de salida | Idioma preferido para las respuestas generadas. |
| Proyecto | Contexto usado para habilitar bases de conocimiento relacionadas. |
| Bases de conocimiento | Fuentes que pueden consultarse durante la ejecución. |
| Metadatos personalizados | Campos adicionales de documento incluidos en el contexto enviado al agente. |
| Etapas | Lista de agentes que participan en el workflow. |
| Entrada de etapa | Mensaje, plantilla o salida anterior pasada a una etapa de agente. |
| Clave de salida | Nombre opcional usado para identificar la salida de una etapa. |
| Adaptadores | Integraciones que pueden recibir el resultado del workflow. |
Tipos de workflow
| Tipo | Qué hace |
|---|---|
| Secuencial | Ejecuta etapas en orden, normalmente usando la salida de una etapa como contexto para la siguiente. |
| Paralelo | Ejecuta varias etapas de agente de forma independiente cuando el trabajo puede ocurrir al mismo tiempo. |
| Condicional | Dirige la ejecución según condiciones configuradas o resultados intermedios. |
| Equipo | Permite que varios agentes especializados colaboren en una tarea o entregable compartido. |
Formateadores de salida
Los formateadores de salida definen cómo se presentan o entregan los resultados de workflow.
| Formateador | Qué produce |
|---|---|
| Texto o Markdown | Texto formateado mostrado directamente en la interfaz. |
| JSON Schema | Salida estructurada que sigue un schema JSON definido. |
| Documento PDF generado a partir del resultado o plantilla del workflow. | |
| Jira | Issues o tarjetas creadas automáticamente desde la salida del workflow. |
| BusinessMap | Tarjetas creadas en BusinessMap desde la salida del workflow. |
| MCP | Entrega o integración mediante Model Context Protocol cuando está habilitado. |
Paso a paso: ejecutar un workflow
- Abre el workflow que deseas ejecutar.
- En Ejecutar Workflow, escribe el mensaje de entrada.
- Haz clic en Ejecutar.
- Espera a que se abra la página de resultado.
- Sigue el estado de ejecución y el progreso de las etapas.
Paso a paso: revisar historial de ejecuciones
- Abre el workflow.
- Ve a Historial de Ejecuciones.
- Haz clic en una ejecución para abrir el resultado.
- Usa los controles de paginación cuando el historial tenga muchos registros.
Paso a paso: programar ejecuciones
- Abre el workflow.
- En Ejecuciones Programadas, ingresa la expresión cron.
- Usa el enlace de ayuda visual cuando necesites entender el formato de programación.
- Confirma la zona horaria usada por la programación.
- Escribe el mensaje o payload que debe enviarse a cada ejecución automática.
- Elige si la programación debe iniciar activa.
- Haz clic en Crear Programación.
Las ejecuciones programadas usan la zona horaria configurada para la programación o el entorno. Confirma el horario esperado antes de habilitar rutinas importantes.
Paso a paso: editar una programación
- Abre el workflow.
- Encuentra la programación.
- Actívala o desactívala usando el control mostrado.
- Haz clic en Editar Mensaje para actualizar el mensaje enviado durante la ejecución.
- Haz clic en Guardar.
Paso a paso: eliminar un workflow o programación
- Abre el elemento que deseas remover.
- Haz clic en Eliminar.
- Lee el mensaje de confirmación.
- Confirma solo si estás seguro.
precaución
Eliminar workflows o programaciones puede detener rutinas usadas por la organización.
Resultado esperado
Deberías tener un workflow que usa los agentes, contexto y opciones de entrega correctos, y poder ejecutarlo o programarlo según las necesidades de la organización.