Planner Executor Agent

El Planner Executor Agent es un componente avanzado dentro del sistema de automatización Nappai. Su función principal es actuar como un asistente inteligente capaz de desglosar problemas complicados en pasos manejables y ejecutarlos de manera autónoma.

A diferencia de una simple acción directa, este agente se enfoca en el “razonamiento”: primero planifica la estrategia para resolver una tarea y luego ejecuta las acciones necesarias para completar el trabajo. Es ideal para flujos de trabajo donde necesitas que un asistente de IA analice información, cree un plan de acción y realice las acciones correspondientes en tus aplicaciones de gestión.

Nota Importante: Este componente se encuentra actualmente en fase de desarrollo. Esto significa que puede experimentar cambios en su funcionamiento o configuración en futuras actualizaciones. Se recomienda probarlo cuidadosamente antes de usarlo en procesos críticos de producción.

¿Cómo funciona?

Este componente utiliza una arquitectura inteligente conocida como “Planificador y Ejecutor” (Planner-Executor). Funciona de la siguiente manera:

Planificación: Cuando le proporcionas una tarea compleja, el agente primero “piensa” y crea un plan detallado de los pasos necesarios para completarla. Utiliza modelos de lenguaje avanzados para entender el contexto y decidir la mejor estrategia.
Ejecución: Una vez diseñado el plan, el agente procede a ejecutar las acciones específicas en el orden previsto. Puede interactuar con herramientas o datos para llevar a cabo cada paso del plan.
Entrega: Al finalizar la ejecución, te devuelve el resultado final de la tarea, sintetizando la información procesada durante el proceso.

En esencia, no solo responde a una solicitud, sino que la resuelve paso a paso, lo que mejora la precisión en tareas no triviales.

Conexión y Credenciales

Este componente no requiere la configuración manual de credenciales externas específicas (como claves de API de terceros) dentro de sus parámetros visibles, ya que hereda la configuración de conectividad de su estructura base en Nappai. Asegúrate de que tu instancia de Nappai tenga los modelos de lenguaje y las integraciones básicas correctamente configuradas para que el agente pueda operar.

Entradas

Los siguientes campos están disponibles para configurar este componente. Ten en cuenta que, debido a su naturaleza de agente autónomo, la entrada principal suele ser la descripción de la tarea o el mensaje que deseas que se ejecute.

Planner Executor Agent: El mensaje o la tarea principal que deseas que el agente planifique y ejecute. Se le explica al agente qué problema resolver o qué proceso automatizar.

Salidas

Al finalizar su proceso, el componente devuelve el resultado de la tarea completada.

Resultado de la Ejecución: Generalmente, recibirás una cadena de texto que contiene la respuesta final o el resumen de la tarea planificada. Este resultado puede contener información procesada, respuestas a preguntas complejas o el estado final de un proceso automatizado.

Ejemplo de Respuesta JSON

Dado que este componente devuelve una respuesta de texto estructurada basada en la tarea completada, el resultado podría verse similar al siguiente ejemplo en un entorno de desarrollo: json { “result”: “La tarea de análisis de datos ha sido completada. Se ha generado un reporte resumen con las métricas clave para el periodo Q3.”, “status”: “success”, “steps_completed”: 3 }

Nota: El formato exacto puede variar en fase de desarrollo. El campo principal que podrás utilizar en nodos siguientes es el texto de “result” o la salida de mensaje completa.

Conectividad

Este componente es flexible y puede conectarse lógicamente a varias partes de un flujo de trabajo:

Después de un Componente de Trigger o LLM: Es común conectarlo después de un nodo que inicia un proceso (como un disparador de evento o un resumen de texto inicial) para que el agente tome esa información e ejecute la tarea compleja.
Antes de un Componente de Salida o Notificación: Una vez que el agente ha completado la tarea y generado un resultado, puedes conectar su salida a un nodo de correo electrónico, Slack o base de datos para distribuir los resultados.

Ejemplo de Uso

Imagina que tienes un flujo para gestionar reportes mensuales de ventas:

Trigger: Un nodo se activa el último día del mes.
Planner Executor Agent: Recibe la instrucción: “Analiza los datos de ventas del mes pasado y genera un resumen de las tendencias principales”.
- El agente planifica: Extraer datos, calcular totales, identificar tendencias, redactar resumen.
- El agente ejecuta: Realiza estas acciones automáticamente.
Resultado: El componente devuelve el texto del resumen generado.
Email: Un nodo posterior envía ese resumen por correo a los directores.

Consejos y Mejores Prácticas

Sé Específico en las Instrucciones: Dado que el agente crea su propio plan, proporciona instrucciones claras sobre qué datos usar y qué formato deseado para el resultado final.
Prueba con Tareas Moderadas: En fase de desarrollo, prueba con tareas de complejidad media antes de delegar procesos críticos.
Revisa la Lógica del Plan: Si el resultado no es el esperado, considera si el plan inicial que el agente generó fue lógico para la tarea dada.

Consideraciones de Seguridad

Fase de Desarrollo: El componente tiene la marca is_development: True. Esto implica que la interfaz (API) o el comportamiento podrían cambiar sin previo aviso en actualizaciones futuras. No lo uses en entornos de producción críticos sin una evaluación de estabilidad adecuada.
Acceso a Datos: Al ser un agente que puede ejecutar acciones, asegúrate de que las herramientas o datos a los que se conecta estén protegidos y que el agente solo tenga acceso a la información necesaria para su tarea.