Planner Executor Agent

Planner Executor Agent coordina a otros agentes para resolver tareas que tienen varias partes. Cuando le pides algo complejo, prepara un plan con los pasos necesarios y el agente que se encargará de cada uno, y te lo muestra antes de empezar. Puedes aprobarlo o rechazarlo. Una vez aprobado, ejecuta los pasos en orden, pasa a cada agente lo que necesita y, al terminar, redacta una respuesta final que reúne todos los resultados.

Si solo le haces una pregunta o una conversación sencilla, responde directamente sin preparar un plan.

Cuándo usarlo

Quieres un informe que requiere buscar datos, analizarlos y redactar el resultado, cada parte a cargo de un agente distinto.
Una tarea de varios pasos debe pasar por tu aprobación antes de ejecutarse.
Tienes agentes especializados (ventas, soporte, análisis) y quieres uno que organice el trabajo entre ellos.
Necesitas ver qué se hizo en cada paso y qué agente lo hizo.

Configuración

Campo	Qué hace
Agent Name	El nombre del agente. Se usa cuando lo conectas como herramienta o como agente de otro agente. Por defecto, `Agent`.
Agent Description	Qué hace el agente, en una frase. Ayuda a otros agentes a decidir cuándo usarlo.
User Prompt	El texto que recibe el agente. Por defecto, `{input}`, que se sustituye por lo que llega a Input. Puedes añadir otras variables entre llaves; cada una aparece como un campo nuevo.
Input	La petición del usuario, normalmente conectada desde un Chat Input.

Conexión	Qué conectar
Worker Agents (obligatorio)	La salida Agent de los agentes que harán el trabajo, por ejemplo Agent, Code Task Agent o Simple Report Agent. El planificador los conoce por su Agent Name y su Agent Description, así que dale a cada uno un nombre distinto y una descripción clara de lo que sabe hacer.
Model (obligatorio)	El modelo de IA que prepara el plan y la respuesta final, por ejemplo OpenAI.

Opciones avanzadas

Campo	Qué hace
Use memory	Hace que el agente recuerde la conversación. Actívalo: lo necesita para recordar el plan entre el mensaje en que te lo propone y el mensaje en que lo apruebas. Al activarlo aparece la conexión Memory, donde puedes conectar un componente de memoria como Postgres Memory. Por defecto, desactivado.
Stop on Error	Si un paso falla, detiene la ejecución y redacta la respuesta con lo conseguido hasta ese momento. Desactivado, salta el paso fallido y continúa con el siguiente. Por defecto, desactivado.
Recursion Limit	El número máximo de pasos internos del agente en cada respuesta. Por defecto, 1000.
Stream	Muestra en el chat el avance de cada paso mientras se ejecuta el plan. Por defecto, desactivado.

Procesamiento por lotes

Con el interruptor Batch Mode activado, el componente se ejecuta una vez por cada elemento de la lista que conectes en Batch Input y devuelve todos los resultados juntos en una lista. Parallel Executions indica cuántos elementos se procesan a la vez (de 1 a 5). Skip if Empty Batch Input salta el componente si la lista llega vacía, y Skip Branch if Empty Output detiene los componentes siguientes si el resultado está vacío. Más información en Conceptos clave.

Uso como herramienta de un agente

Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.

Aprobar el plan

Cuando el agente propone un plan, responde en el chat:

aprobar, sí, ok o adelante para ejecutarlo.
rechazar, no o cancelar para descartarlo.

Si quieres un plan distinto, recházalo y vuelve a pedir la tarea en un mensaje nuevo, explicando lo que debe cambiar, por ejemplo sin el paso de traducción o con un paso final para revisar la ortografía.

Resultado

Response: los mensajes del agente en el chat: el plan para aprobar y, después, la respuesta final con los resultados de todos los pasos. Conéctala a un Chat Output.
Agent: el agente completo, para conectarlo a otro componente que coordine agentes.
Tool: el agente como herramienta, para conectarlo a la entrada Tools de otro agente.

Ejemplo

Una consultora prepara cada mes un análisis de la competencia para sus clientes.

Añade un Agent llamado investigador, con una herramienta de búsqueda en internet, y un Simple Report Agent llamado redactor. Conecta la salida Agent de los dos a Worker Agents.
Conecta un modelo de IA a Model y activa Use memory.
Conecta un Chat Input a Input y Response a un Chat Output.
En el chat escribe: Prepara un análisis de los tres principales competidores de Hoteles Mirador con sus precios y novedades del último mes.

El agente propone un plan, por ejemplo investigar a cada competidor y luego redactar el informe. Al responder aprobar, lo ejecuta y entrega el análisis.

Buenas prácticas

Describe bien a cada agente de Worker Agents: el plan solo es bueno si el planificador entiende qué sabe hacer cada uno.
Revisa el plan antes de aprobarlo. Si falta algún paso, recházalo y vuelve a pedir la tarea con más detalle.

Componentes relacionados

Supervisor Agent: coordina agentes sin pasar por un plan aprobado.
Agent: el agente general de NappAI, útil como agente de trabajo.