Sub Project flow Agent

El Sub Project flow Agent te permite crear un agente que ejecuta una parte específica de un flujo de trabajo ya existente dentro de Nappai. Solo necesitas indicar qué flujo y qué nodo quieres usar, y el componente se encargará de compilar el agente que podrás ejecutar en tu dashboard.

¿Cómo funciona?

Cuando seleccionas un flujo y un nodo, el componente busca esos elementos dentro del proyecto. Luego construye un agente que incluye únicamente los pasos necesarios para ejecutar ese nodo y sus dependencias. Si marcas la opción Stream, el agente enviará los resultados en tiempo real a medida que se procesan, lo que es útil para tareas largas o que generan salidas continuas.

El proceso se realiza localmente dentro de Nappai; no se llama a APIs externas. El resultado es un objeto CompiledGraph que representa el agente listo para usar.

Entradas

Campos de Entrada

• Agent Node: Selecciona el nodo dentro del flujo que quieres ejecutar.
• Flow Name: Escoge el flujo de trabajo del proyecto donde se encuentra el nodo.
• Stream: Marca esta casilla si quieres que el agente envíe los resultados en tiempo real.

Salidas

• Agent Graph: Un objeto CompiledGraph que contiene el agente construido. Puedes usarlo como entrada para otros componentes que ejecuten agentes o para guardarlo y reutilizarlo en otros flujos.

Ejemplo de Uso

1. Selecciona el flujo: En el menú desplegable Flow Name, elige el flujo que contiene el proceso que deseas ejecutar.
2. Escoge el nodo: En Agent Node, selecciona el nodo que quieres que el agente ejecute.
3. Activa streaming (opcional): Marca Stream si quieres ver los resultados a medida que se generan.
4. Ejecuta: Haz clic en el botón de ejecución del dashboard. El componente devolverá el Agent Graph.
5. Utiliza el agente: Conecta la salida Agent Graph a otro componente que ejecute agentes, como un “Run Agent” o “Execute Flow”, para iniciar la tarea.

Componentes Relacionados

• Run Agent – Ejecuta el agente generado por este componente.
• Agent Builder – Crea agentes desde cero sin usar un flujo existente.

Consejos y Mejores Prácticas

• Revisa el flujo antes de seleccionar: Asegúrate de que el nodo elegido no dependa de datos que no estén disponibles en el contexto actual.
• Usa streaming solo cuando sea necesario: El streaming puede consumir más recursos y generar más tráfico de red.
• Guarda el Agent Graph: Si planeas reutilizar el mismo subflujo, guarda el objeto CompiledGraph para evitar reconstruirlo cada vez.

Consideraciones de Seguridad

• Control de acceso: Solo los usuarios con permisos de lectura sobre el flujo pueden crear agentes a partir de él.
• Validación de entradas: El componente valida que el nodo y el flujo existan; evita errores de ejecución.

---