Crea tu primer pipeline

Qué vas a construir

Al terminar este tutorial tendrás:

• Una plantilla de pipeline guardada que despacha un agente con un prompt
• Las ejecuciones manuales activadas en ella, para poder iniciarla a mano
• Una ejecución completada, con la entrada y la salida del paso visibles

Requisitos previos: Despacha tu primer agente completado, de modo que tengas un agente con un adaptador y un modelo.

Un pipeline es un DAG de pasos. Las plantillas definen el grafo; las ejecuciones lo ponen en marcha. Para el modelo que hay detrás, lee Pipelines y automatización; para el vocabulario completo de pasos, Tipos de pasos de pipeline.

Paso 1: Crear una plantilla

1. Ve a Ajustes → Espacio de trabajo → Plantillas de pipeline
2. Haz clic en Nueva plantilla

El editor se abre en un esqueleto predefinido llamado Nuevo pipeline (id pipeline_N). Haz clic en el título de la cabecera y cámbiale el nombre — para este tutorial, code_quality_check es un buen nombre. No hay ningún diálogo de id ni campo de descripción.

El lienzo no está vacío. Una plantilla nueva llega ya cableada como Trigger → Step → terminal, donde «Step» es un nodo de agente de prompt y el terminal es un centinela invisible que el editor reconecta a cada sumidero alcanzable.

Configuras el Step que ya está ahí.

Paso 2: Configurar el paso

1. Haz clic en el nodo Step del lienzo
2. En el panel Configuración del nodo de la derecha, establece:
   • Agente: tu agente del tutorial anterior
   • Plantilla del prompt: «Revisa el código de la rama actual en busca de problemas de calidad. Enumera lo que encuentres.»
3. No toques Disparadores desde: el nodo ya está cableado para dispararse después de Trigger

Paso 3: Guardar

Presiona Guardar en la cabecera del editor.

Punto de control. La etiqueta «Cambios sin guardar» desaparece.

Paso 4: Permitir ejecuciones manuales

1. Haz clic en la tarjeta discontinua Añadir un disparador del lienzo (o arrastra Ejecución manual desde la sección Disparadores de la biblioteca de nodos) y elige Ejecución manual.
2. Selecciona ese nodo. En el inspector de la derecha, activa Activado: «Mostrar en la página de ejecución e iniciar a mano.»

Esto no es opcional y es fácil pasarlo por alto. Una plantilla nueva se crea sin ninguna fila de disparador, así que hasta que actives esto la página de ejecución no la listará y no habrá nada que iniciar. El interruptor escribe el disparador de inmediato; no espera a otro guardado.

El mismo interruptor está detrás de Ejecución manual en la cabecera del editor, donde aparece junto a las entradas declaradas de la plantilla.

Paso 5: Ejecutarlo

1. Haz clic en Pipelines en la barra lateral
2. Haz clic en Ejecutar pipeline en la cabecera
3. Elige code_quality_check en el riel izquierdo
4. Haz clic en Ejecutar pipeline en el formulario — tu plantilla no declara entradas, así que no hay nada que llenar

Punto de control. Un aviso confirma que la ejecución se inició y Control Center abre el detalle de la ejecución.

El motor crea el registro de la ejecución, completa el disparador, programa el paso, despacha al agente y completa la ejecución cuando termina la rama entrante del terminal.

Paso 6: Inspeccionar el resultado

Haz clic en el paso dentro de la ejecución para abrir su panel de detalle:

• Las marcas de tiempo Iniciado y Finalizado, y la Duración
• Entrada: el estado que se pasó al paso
• Salida: lo que produjo — aquí, la respuesta del agente
• Actividad del agente, con un enlace a la conversación que dirigió el paso

Punto de control. El paso figura como completado y su salida contiene la revisión del agente.

Agregar más pasos

Los nodos se agregan arrastrando una entrada de la biblioteca de nodos de la izquierda al lienzo, o presionando Añadir paso (+) justo después de un nodo. Arrastra desde el puerto de salida de un nodo hasta otro para conectarlos, o selecciona el nodo nuevo y marca su paso anterior en Disparadores desde.

El nodo terminal no se dibuja y no se puede seleccionar. El editor lo reconecta a cada sumidero alcanzable, así que un nodo que agregues después del Step predefinido sigue ejecutándose.

Resumen

Creaste una plantilla, configuraste el nodo de agente de prompt con el que se creó, la guardaste, la hiciste ejecutable a mano, iniciaste una ejecución y leíste la entrada y la salida del paso.

Los pipelines pueden crecer mucho más que esto —enrutadores condicionales, ramas paralelas, nodos de unión, despliegue en abanico for-each, compuertas humanas—, pero la forma nunca cambia: pasos en un DAG que pasan estado.

Siguiente: Conecta Slack a tu espacio de trabajo, el último tutorial de esta secuencia.

• Configurar disparadores de pipeline para iniciar pipelines a partir de eventos o de una programación
• Pipelines y automatización para el modelo que hay debajo
• Tipos de pasos de pipeline para cada tipo de paso