Usar el modo plan

Esta guía te muestra cómo obtener un plan estructurado de un agente antes de que escriba una sola línea de código.

En el modo plan el agente investiga en solo lectura y su único entregable es un plan tipado: un grafo de dependencias de pasos que tú apruebas y que Control Center compila después en trabajo real. Úsalo cuando quieras ver el alcance de un cambio, tener los pasos desglosados o conocer los riesgos y las dependencias antes de tocar nada.

Cambiar un espacio al modo plan

Cualquiera de estas acciones cambia el modo del espacio y el cambio se guarda:

Elige Plan en el desplegable de modo, en el extremo izquierdo de la barra de herramientas del compositor
Presiona Shift+Tab
Envía /plan. Un /plan a secas solo arma el modo; /plan <request> lo arma y envía el resto como tu mensaje

/plan nunca viaja como texto: fija el modo almacenado, que es la autoridad que leen la superficie de herramientas, el preajuste de barandillas y el prompt. Así que el modo se mantiene durante este turno y todos los siguientes, hasta que lo vuelvas a cambiar.

El modo se almacena en el espacio, así que un mismo agente puede estar en modo plan aquí y en modo agente en otro sitio.

Qué produce el agente

Investiga en solo lectura: la memoria, el índice de código, los archivos
Llama a submit_plan una sola vez, con un goal más nodes, y cada nodo lleva una key estable, un title, una description y las claves de nodo indicadas en dependsOn (los nodos de los que depende; eso es lo que permite que el trabajo independiente se ejecute en paralelo)
Se detiene

La herramienta valida el grafo —claves duplicadas, dependencias colgantes, ciclos— y devuelve las infracciones para que el agente las corrija, en lugar de aceptar un plan roto.

El plan aparece en la conversación como una fila compacta que muestra el objetivo, su estado y el número de pasos. Plan Studio —el grafo de dependencias, el inspector por nodo y la estimación de costos— se abre como una pestaña junto a la conversación: presiona Abrir en la fila o simplemente espera, porque un plan que llega en menos de 30 segundos mientras estás mirando la conversación abre su pestaña solo.

Cuando la solicitud es ambigua, un agente en modo plan puede detenerse y hacerte hasta tres preguntas bloqueantes con la herramienta ask_user. Muestra un formulario en la conversación —opciones o texto libre— y la ejecución se bloquea hasta que respondas. La herramienta es de nivel de lectura, así que sobrevive a la superficie de solo lectura del modo plan, y está exenta del envoltorio de aprobación (un prompt delante de otro prompt fallaría en cerrado sin ningún aprobador conectado, lo que le negaría al agente el propio acto de preguntar).

Necesita un espacio en el que mostrarse, así que un despacho puntual sin conversación no la tiene. Aun así, adelantar el alcance, el repo de destino y los criterios de aceptación en tu primer mensaje sigue siendo más rápido que una ida y vuelta.

La prosa no es un entregable aquí. Una ejecución que termina sin llamar a submit_plan publica una línea visible «Ended without submitting a plan (no submit_plan call).» en la conversación y marca la ejecución como una que no produjo su entregable. El estado de la ejecución se queda deliberadamente en completed —así las máquinas de estados de pipelines y tickets no se tocan—, así que fíjate en la línea, no en la insignia de estado.

Aprobar el plan

En la fila del plan en la conversación, presiona Aprobar y ejecutar. En la barra de aprobación de Plan Studio, presiona Aprobar plan (o Rechazar, justo al lado; la aprobación está desactivada mientras el grafo tenga un error de validación).

Después:

Control Center compila el plan en una orquestación y la materializa: los tickets y la ejecución. En este paso no interviene ningún modelo; es determinista
El plan se ejecuta como el agente que lo escribió. Decidir si entra alguien más es cosa de ese agente en tiempo de ejecución: puede delegar un paso con delegate_task a un compañero de equipo más adecuado, dentro del límite de profundidad de delegación del espacio de trabajo
El objetivo del plan pasa a ser el objetivo de la conversación y el trabajo se ejecuta en esa misma conversación: cada paso publica lo que se le pidió al agente y transmite su turno de vuelta, así que lo sigues (y puedes detener un turno) donde ya estás
La fila del objetivo en el panel lateral General de la conversación (bajo Tareas) lleva el progreso de la ejecución como settled/total y su botón de detener; Plan Studio muestra el estado de cada nodo en el grafo y también permite cancelar allí

Seguir trabajando sin aprobar

Si prefieres quedarte en esta conversación en lugar de aprobar el plan, el agente puede llamar a exit_plan_mode. Es la única salida autorizada: abre una solicitud de aprobación duradera vinculada a la conversación y devuelve pending: el espacio sigue en modo plan y el agente no debe actuar. Una vez aprobada la solicitud, la siguiente llamada del agente a exit_plan_mode pasa el espacio del modo plan al modo agente y desbloquea sus herramientas que mutan. Un rechazo le permite abrir una solicitud nueva contra un plan revisado.

Para salir del modo plan, cambia el desplegable del compositor (o Shift+Tab), o aprueba el plan enviado. exit_plan_mode abre una aprobación duradera que se decide con la herramienta MCP decide_approval. La superposición de barandillas para las llamadas de herramientas bloqueadas es otra cola, en memoria, y no transporta solicitudes de salida del modo plan.

El modo plan en un paso de pipeline

Un nodo de pipeline messaging.createSpace lee el modo de conversación del extra mode de la configuración del nodo: extras['mode']: 'plan'. La clave debe coincidir exactamente: cualquier otra grafía, incluidas conversationMode o dispatchMode, se ignora en silencio y la sala recurre al valor predeterminado del cuerpo, que es el modo revisión, no el de chat. Un paso promptAgent se une a una sala que no creó y no le vuelve a definir los permisos. El selector Modo de despacho del editor de configuración de nodos (allParallel / manager) es para los nodos de despacho de equipo. Define el modo de conversación con extras['mode'] en una plantilla que abra el espacio, o en la configuración de ese nodo a través de la API.