Ejecutar una orquestación

Esta guía te muestra cómo convertir un objetivo grande en un plan de todo el equipo que se ejecuta solo. Consulta Orquestación para saber cómo funciona.

Cuándo usar una orquestación

Recurre a una orquestación cuando la petición es más grande que un solo agente y todavía no conoces los pasos exactos. Para una sola tarea, envía un mensaje a un agente en un espacio; para un proceso que puedes detallar a mano, crea una plantilla de pipeline.

Paso 1: Pide el plan

1. Abre (o crea) un espacio y un ticket de anclaje. Toda propuesta requiere uno (propose_orchestration toma ticket_id); el espacio compartido proviene de ese ticket.
2. Opcionalmente, cambia el desplegable de modo del compositor a Orquestación. Ese modo limita al agente a leer y proponer —memoria, el grafo de código, lecturas de repos y tickets, propose_orchestration y las herramientas de playbook—, así que no puede ponerse a escribir código en lugar de planificar.
3. Menciona con @ a tu orquestador (normalmente el agente CEO) y expón el objetivo en lenguaje llano:

@ceo Investiga el panorama competitivo de una grabadora de reuniones offline-first y escribe un documento de posicionamiento de una página.

El orquestador responde con una tarjeta de propuesta estructurada en el espacio: los roles que necesita, el trabajo desglosado en subtickets, una fase opcional de investigación y debate, un paso de síntesis que produce el entregable y un presupuesto.

Como la propuesta es un objeto tipado, la aplicación la valida (roles bien formados, esquemas de salida declarados, un DAG sin ciclos) antes de que se ejecute nada. Una propuesta que no supera la validación no se puede aprobar.

Paso 2: Revisa y edita la propuesta

La tarjeta del chat ofrece tres acciones: Aprobar plan, Rechazar y Abrir, que abre el plan en Plan Studio como una pestaña de editor. La propia tarjeta no se puede editar.

Para cambiar algo, presiona Abrir y trabaja en el inspector de la derecha:

• Título, descripción, rol, dependencias y esquema de salida de cualquier paso de trabajo. Aquí rol significa cuál de las claves de rol existentes del plan posee el paso: no puedes fijar un rol a un agente con nombre ni editar la lista de contrataciones desde el inspector, y tampoco puedes editar el presupuesto.

Dos cosas son de solo lectura: los nodos estructurales (investigación, debate, síntesis) y cualquier nodo cuyo trabajo ya se haya ejecutado. Solo se puede editar mientras la orquestación siga en proposed.

Presiona Estimar en la barra de aprobación para ver rangos de costo, duración y radio de impacto antes de comprometerte. Consulta Trabajar en Plan Studio para conocer el editor completo.

El presupuesto no es un límite de gasto

El presupuesto de una propuesta se compara con la estimación de la barra de aprobación: cuando el extremo superior de la estimación lo supera, el total se pone en rojo con un aviso de presupuesto excedido. Nada revisa el gasto mientras el plan se ejecuta, así que no detendrá ni hará fallar una ejecución. Para detener el gasto de verdad, usa las políticas de presupuesto por agente; consulta Administrar costos.

Paso 3: Aprueba

Aprueba el plan desde la tarjeta del chat o desde la barra de aprobación de Plan Studio. Esta es la única decisión que tomas. Aprobar es exclusivo del operador: no hay ninguna herramienta MCP para ello, así que un agente puede proponer y revisar, pero nunca aprobar su propio plan.

A partir de aquí, un materializador determinista (una función pura, sin LLM) convierte la propuesta en un pipeline real y crea el andamiaje:

• contrata cualquier rol nuevo (y registra los identificadores de los agentes contratados para que un fallo a mitad de la aprobación pueda reanudarse sin contrataciones duplicadas)
• agrupa los roles en un equipo
• crea un proyecto y archiva el ticket principal en él
• inicia la ejecución de pipeline que lo impulsa todo

El estado pasa a approved y después a executing.

Paso 4: Observa cómo se ejecuta

Los subtickets se ejecutan como pasos de pipeline; si activaste una ronda de debate, cada rol publica primero su postura. El progreso aparece donde ya miras:

• el ticket principal sobre el que se ancló la orquestación
• el espacio compartido en el que habla el equipo, donde la fila del plan sigue el estado de cada nodo
• el detalle de la ejecución de pipeline, con su cascada de tiempos y su costo por paso habituales; consulta Monitorear ejecuciones de pipeline
• el proyecto en el que se archivó el ticket principal

Cuando los subtickets terminan, el estado pasa a synthesizing y el paso de síntesis produce el entregable. Ese texto se publica en el espacio compartido y el ticket principal se marca como completado; después, completed.

Detenla antes de tiempo

Presiona Cancelar orquestación en la tarjeta del chat, o Cancelar ejecución en la barra de aprobación de Plan Studio. La cancelación desmonta el trabajo en curso.

Una orquestación falla cuando falla la materialización, o cuando falla la ejecución del pipeline generado (investigación, debate, síntesis o persistencia: esos pasos no continúan si fallan). Los pasos de trabajo generados siempre continúan aunque fallen, así que un subticket fallido no hace fallar la ejecución. No hay ninguna vía de fallo por presupuesto excedido ni ningún umbral de «todos los subtickets fallaron».

Guías relacionadas

• Trabajar en Plan Studio: edita, estima, compara y aprueba el plan
• Crear y administrar tickets: el ticket principal sobre el que se ancla una orquestación
• Organizar el trabajo con proyectos: dónde se archiva el ticket principal
• Monitorear ejecuciones de pipeline: cómo se ve una orquestación materializada en el motor
• Formar un equipo de agentes: los roles que una orquestación cubre o contrata

Conceptos relacionados

• Orquestación
• Modos