Trabajar en Plan Studio

Esta guía te muestra cómo trabajar con planes en Plan Studio. Para saber qué son las orquestaciones y los documentos de plan, consulta Orquestación y Usar el modo plan.

Abrir un plan

Un plan pertenece a la conversación que lo produjo, así que normalmente llegas a él desde ahí: la fila del plan en la conversación tiene una acción Abrir y Plan Studio se abre como una pestaña de editor junto a la conversación.

El centro de planes lista tres secciones:

Planes activos — orquestaciones, primero las propuestas, con su estado, número de pasos y número de revisión.
Documentos de plan — planes que un solo agente envió con submit_plan en el modo plan, mientras están propuestos o aprobados.
Playbooks — plantillas de plan guardadas y parametrizadas.

Haz clic en una tarjeta para abrirla en Plan Studio. La ruta es /workspaces/<workspace-id>/plans/<kind>/<plan-id>, donde kind es orchestration o document, así que también puedes enlazar directamente un plan concreto.

Si abriste una orquestación, tienes el lienzo editable, la línea temporal de versiones y la barra de aprobación. Si abriste un documento de plan, el mismo grafo se muestra como solo lectura: los documentos de plan los redacta el agente; tú los revisas, los estimas y los apruebas o rechazas, y un documento aprobado muestra el estado de ejecución en vivo de cada nodo de la orquestación en la que se compiló.

Editar el DAG

Una orquestación se puede editar mientras está en estado proposed. Todas las ediciones del lienzo se hacen con el teclado:

Haz clic en el lienzo y mueve la selección con las teclas de flecha.
Presiona n para agregar un paso. Aparece seleccionado como «Nuevo paso»; cámbiale el nombre en el inspector de la derecha.
Presiona e en el paso que deba ejecutarse primero y luego haz clic en el paso dependiente (o selecciónalo y presiona Enter) para conectar una dependencia. Presiona Esc para descartar una conexión pendiente.
Presiona x para cortar la dependencia más reciente del paso seleccionado, o activa o desactiva dependencias concretas en el editor de dependencias del inspector.
Presiona Delete para eliminar el paso seleccionado; las referencias a él se eliminan de las dependencias de los pasos restantes.

En el inspector también puedes editar la descripción, el rol y el esquema de salida del paso. Las ediciones se guardan automáticamente como una nueva revisión tras una breve pausa; un error de validación (que se muestra en la barra de aprobación) bloquea el guardado hasta que lo corrijas.

Solo se pueden editar los pasos de trabajo. Los nodos estructurales —investigación, debate y síntesis— son de solo lectura, igual que cualquier paso cuyo trabajo ya se haya ejecutado (está marcado como «ya ejecutado», porque editarlo bifurcaría el plan).

El guardado usa concurrencia optimista sobre la revisión desde la que empezaste. Si el orquestador replanifica por debajo de ti, tu guardado se rechaza con «el plan ya avanzó» en lugar de fusionarse o sobrescribirse en silencio; vuelve a leer la revisión actual y rehaz tu edición. Las replanificaciones iniciadas por agentes tienen un límite de una cada dos minutos, así que esto sigue siendo poco frecuente.

Leer las estimaciones de costo, tiempo y riesgo

Presiona Estimar en la barra de aprobación.

Cada paso del lienzo recibe una insignia con un rango de costo y el tamaño de muestra que lo respalda, o «Aún sin historial» cuando el rol del paso nunca se ha ejecutado. Selecciona un paso para ver el detalle completo en el inspector: rango de costo con tamaño de muestra, un rango de duración y un radio de impacto (archivos y símbolos) derivado de la procedencia del paso, o «desconocido» cuando el paso no tiene procedencia.
La barra de aprobación muestra el total del plan: un rango de costo general, un rango de duración para la ruta crítica (las ramas paralelas se superponen, así que no es la suma) y el techo de presupuesto cuando el plan define uno.
Si solo algunos pasos tienen historial, el total se marca como parcial y abarca únicamente los pasos estimables. Si el extremo superior de la estimación supera el techo de presupuesto, el total se vuelve rojo con una advertencia de «sobre presupuesto».

Las estimaciones son honestas o no existen: un paso cuyo rol no tiene historial de ejecuciones completadas reporta un tamaño de muestra de cero y ningún rango, y se muestra como desconocido en lugar de inventarse. Interpreta «Aún sin historial» como «nadie lo sabe», no como «barato».

El techo de presupuesto es una comparación solo de visualización con esta estimación. Nada lo aplica una vez que el plan está en ejecución; consulta Administrar costos para conocer los controles que de verdad detienen el gasto.

Comparar una revisión con una propuesta anterior

Cada edición y cada replanificación del orquestador se agrega a una línea temporal de revisiones que solo crece, visible en el panel Versiones a la izquierda de un plan de orquestación.

Haz clic en una revisión para compararla con la propuesta actual. Sin selección, el panel compara la revisión anterior con la actual.
Lee las diferencias en la mitad inferior del panel: pasos agregados, eliminados o modificados entre las dos revisiones.
Si el plan sigue en proposed, haz clic en el icono de rebobinado de una revisión para volver a ella. Rebobinar guarda esa propuesta como una revisión nueva: no se pierde nada.

Tanto propose_orchestration como el editor rechazan los cambios en cuanto el plan deja de estar en proposed, así que una ejecución en curso no incorpora una replanificación a mitad de la ejecución.

Aprobar, rechazar o ampliar un plan

En la app, un plan propuesto es una sola decisión que se toma en bloque: Aprobar plan o Rechazar en la barra de aprobación. Aprobar plan aprueba siempre todos los pasos: no hay forma de seleccionar antes un subconjunto. La aprobación se bloquea mientras la propuesta tenga errores de validación, que se muestran junto a los botones.

Aprobar es exclusivo del operador. No hay ninguna herramienta MCP para ello, así que un agente puede proponer y revisar un plan, pero nunca aprobarlo.

Cuando una orquestación está en ejecución, la barra cambia:

Si un paso se detuvo a preguntar a mitad de la ejecución, selecciónalo y presiona Continuar nodo para reanudarlo.
Presiona Aprobar seleccionados para ampliar una aprobación parcial al paso seleccionado y a todo aquello de lo que depende de forma transitiva (un paso nunca se puede aprobar sin sus dependencias). El control está en la barra de ejecución de todas las orquestaciones; no hace nada cuando el plan se aprobó en bloque.
Presiona Cancelar ejecución para detener toda la orquestación.

Los pasos que quedan fuera de un conjunto aprobado parcial se muestran como aplazados y no se ejecutan hasta que amplíes el conjunto.

Ejecutar un playbook con parámetros

Un playbook es una plantilla de plan guardada con marcadores {{param}} tipados en su objetivo, los títulos de los pasos, las descripciones y los prompts. La sustitución es literal, no hay ningún lenguaje de expresiones; si necesitas lógica, usa mejor un pipeline.

En la sección Playbooks del centro de planes, presiona Ejecutar en el playbook (o abre la paleta ⌘K y elige allí el playbook).
Rellena los parámetros. Los parámetros de enumeración se muestran como listas desplegables; los parámetros de repositorio y de agente aceptan una referencia a un repositorio o a un agente; los parámetros opcionales usan su valor predeterminado.
Elige el ticket de anclaje contra el que se propone el plan y confirma.

Ejecutar un playbook solo propone un plan: la orquestación instanciada se abre en Plan Studio como proposed y no se ejecuta nada hasta que la apruebes ahí. Para eliminar un playbook, presiona el icono de papelera de su tarjeta.

Los agentes crean y ejecutan playbooks con las herramientas MCP create_playbook y run_playbook; consulta la referencia de herramientas MCP.

Guías relacionadas

Usar el modo plan: cómo un agente produce un documento de plan con submit_plan
Ejecutar una orquestación: el ciclo de vida de aprobación única desde el lado de la conversación
Crear una plantilla de pipeline: cuando necesitas lógica que un playbook no puede expresar
Monitorear ejecuciones de pipeline: la vista del motor de un plan aprobado

Conceptos relacionados

Orquestación