Modo pipeline

El modo pipeline es un modo interactivo que ejecuta el trabajo paso a paso. Es útil para tareas de infraestructura que son más largas o más propensas a errores que una solicitud normal de chat: entender el requisito, planificar un enfoque, generar artefactos, pedir confirmación al usuario y continuar con las siguientes acciones.

Pipeline en sí es una capacidad general. La implementación integrada disponible hoy es el pipeline selling. selling está orientado a escenarios de infraestructura de Alibaba Cloud y puede llevar una solicitud de despliegue por arquitecturas candidatas, plantillas ROS, estimaciones de costo y despliegue después de la confirmación.

Ejemplos de solicitudes adecuadas para el modo pipeline:

Seleccionar una VPC existente y crear un VSwitch

Diseñar un despliegue de aplicación web de bajo costo en Alibaba Cloud y generar una plantilla

Iniciar el modo pipeline

Actualmente el modo pipeline requiere el REPL interactivo. No se puede combinar con --prompt.

En macOS o Linux:

IAC_CODE_MODE=pipeline iac-code

En PowerShell:

$env:IAC_CODE_MODE = "pipeline"
iac-code

El nombre de pipeline predeterminado es selling. Para indicarlo de forma explícita:

IAC_CODE_MODE=pipeline IAC_CODE_PIPELINE_NAME=selling iac-code

Relación entre Pipeline y selling

Nombre	Significado
Modo pipeline	Modo general de ejecución paso a paso de IaC Code para flujos largos, puntos de confirmación, recuperación y visualización de progreso.
Pipeline selling	Pipeline integrado actual para diseño de infraestructura de Alibaba Cloud, generación de plantillas, estimación de costos y despliegue.

Si en el futuro se agregan más pipelines, se podrán seleccionar con IAC_CODE_PIPELINE_NAME. La versión actual incluye selling.

Variables de entorno

Variable	Propósito
IAC_CODE_MODE=pipeline	Activa el modo pipeline. Cualquier otro valor vuelve al modo normal.
IAC_CODE_PIPELINE_NAME	Selecciona la definición de pipeline. El valor predeterminado es selling.
IAC_CODE_CWD	Sobrescribe el directorio de trabajo usado por el pipeline.
IAC_CODE_PIPELINE_SELLING_ENABLE_REVIEWING	Activa el paso opcional de revisión de plantilla en el pipeline selling.

Qué ocurre en el pipeline selling

El pipeline selling divide una solicitud de infraestructura en etapas comprensibles para el usuario:

Etapa	Qué verás
Entender el requisito	IaC Code comprueba si la solicitud es una tarea de infraestructura en Alibaba Cloud. Si faltan detalles importantes, pregunta antes de generar un plan.
Planificar arquitecturas	IaC Code propone una o más arquitecturas candidatas para que puedas comparar compromisos.
Generar y evaluar	IaC Code genera plantillas ROS para los planes candidatos y estima costos de recursos.
Confirmar un plan	IaC Code muestra los detalles de los candidatos y espera a que elijas el plan con el que quieres continuar.
Desplegar	Después de seleccionar un plan, IaC Code entra en la etapa de despliegue y maneja herramientas u operaciones de mayor riesgo según la política de permisos.

Si mencionas restricciones como “usar una VPC existente” o “no crear este tipo de recurso”, el pipeline selling intentará respetarlas en los planes y plantillas posteriores. No necesitas conocer campos internos; basta con escribir las restricciones en la solicitud.

Interacción y recuperación

El modo pipeline puede pausar y esperar entrada del usuario, por ejemplo:

• El requisito no está claro y IaC Code necesita objetivo, escala, región o presupuesto.
• Hay varios planes candidatos y debes elegir uno.
• Una herramienta o acción de despliegue requiere aprobación de permisos.
• La ejecución fue interrumpida y necesita recuperarse o continuar.

Si el proceso termina o la sesión se interrumpe, IaC Code guarda el estado del pipeline. Cuando vuelvas más tarde a esa sesión con --resume, podrás revisar el progreso anterior y continuar desde un punto recuperable.

Cuando el pipeline termina, falla, sale antes de tiempo o se cancela, IaC Code vuelve al chat normal. Luego puedes hacer preguntas de seguimiento, ajustar el plan o resolver problemas posteriores al despliegue.

Integraciones de automatización

El modo pipeline está diseñado actualmente sobre todo para el REPL interactivo. El modo servidor A2A puede exponer progreso del pipeline, artefactos, resultados de permisos e información de recuperación, lo que resulta útil para conectar un pipeline a una consola externa o a un sistema de tareas.

Al integrar el pipeline mediante A2A, los llamadores también pueden declarar dos capacidades en los metadatos del mensaje: metadata.iac_code.preferredLanguage hace que el progreso, las preguntas y los avisos de permisos se devuelvan en el idioma preferido del llamador; metadata.iac_code.candidatePresentation: rich-v1 hace que el paso de confirmación del plan devuelva una carga estructurada (nombre del candidato, resumen, diagrama de arquitectura, coste mensual total, partidas de coste) apta para renderizado enriquecido en interfaces externas. Cuando un despliegue u operación de herramienta requiere permiso, el pipeline publica un sobre de permiso pendiente y los llamadores responden con allow_once o deny mediante un mensaje de banda lateral; consulta la Referencia del protocolo para más detalles.

ACP no admite actualmente el modo pipeline. --prompt / el modo no interactivo ejecuta una solicitud normal de una sola vez y no ejecuta pasos de Pipeline.

Limitaciones actuales

• La versión actual incluye solo el pipeline selling, principalmente para flujos de infraestructura de Alibaba Cloud.
• El modo pipeline requiere el REPL interactivo. --prompt se rechaza cuando IAC_CODE_MODE=pipeline.
• El modo pipeline admite entrada de texto. Las imágenes pegadas en el REPL se ignoran mientras el pipeline está activo.
• Durante el pipeline, los shell escapes, disparadores de skills y la mayoría de los slash commands están restringidos salvo que la definición del pipeline los permita explícitamente. Comandos básicos como /help, /status, /resume y /exit siguen disponibles.

Puntos de control de backup

El modo Pipeline no crea backups al completar steps del agent loop. Primero publica input_required o waiting_input y después ejecuta un único backup crítico; si falla, publica backup_blocked y se pausa en un estado recuperable. pipeline_handoff_ready y los estados terminales siguen protegidos por un backup crítico previo a su publicación. Para observadores A2A, las publicaciones protegidas terminales y pipeline_handoff_ready van seguidas de un evento backup_committed con committedEventId, committedEventType y committedSequence cuando el límite de backup del modo actual ya es durable. Con IAC_CODE_CONFIG_BACKUP_TMP_DIR, ese límite es el snapshot local inmutable y permite recuperar en el mismo sandbox; la recuperación en otro sandbox depende de que el proceso en segundo plano lo copie a IAC_CODE_CONFIG_BACKUP_DIR. Sin preparación local, el límite sigue siendo el directorio final. El progreso de parallel_sub_pipeline se captura en el siguiente backup de espera, handoff o terminal, no en checkpoints por step.