Project flow as Tool

Crea una herramienta que ejecuta un flujo de proyecto dentro de Nappai.
El componente convierte un flujo ya cargado en tu proyecto en una herramienta (Tool) que puede ser llamada por otros procesos o por la IA de Nappai.

¿Cómo funciona?

El componente no realiza ninguna operación por sí mismo. Cuando lo añades a tu dashboard, simplemente define los parámetros que describen la herramienta que quieres crear. Internamente, Nappai toma el flujo cuyo nombre indicas, empaqueta su lógica en un objeto Tool y lo devuelve como salida. Esa herramienta puede ser usada luego por otros componentes o por la IA para ejecutar el flujo de forma automática.

Entradas

Campos de Entrada

• Flow Name: El nombre del flujo que deseas ejecutar. Debe coincidir exactamente con el nombre que aparece en la lista de flujos de tu proyecto.
• Return Direct: Si se marca, la herramienta devolverá el resultado del flujo directamente, sin necesidad de pasos intermedios.
• Description: Una breve descripción de lo que hace la herramienta. Se muestra en la interfaz cuando la herramienta se llama desde la IA.
• Name: El nombre que le darás a la herramienta. Este será el identificador que usarás para referenciarla en otros componentes o en la IA.

Salidas

• Tool: Devuelve un objeto de tipo Tool que contiene la función que ejecuta el flujo especificado. Puedes conectar esta salida a cualquier componente que acepte una herramienta, como un nodo de “Run Tool” o a la propia IA de Nappai.

Ejemplo de Uso

1. Añade el componente “Project flow as Tool” al flujo de trabajo.
2. Configura las entradas:
   • Flow Name: Send Email Flow
   • Name: SendEmailTool
   • Description: Tool to send an email using the Send Email Flow
   • Return Direct: True
3. Conecta la salida Tool a un nodo “Run Tool” o a la IA de Nappai.
4. Cuando la IA o el nodo “Run Tool” invoque SendEmailTool, se ejecutará el flujo Send Email Flow y devolverá el resultado directamente.

Componentes Relacionados

• FlowToolInternal – Base del componente que gestiona la creación de herramientas a partir de flujos.
• Run Tool – Nodo que permite ejecutar una herramienta creada con este componente.

Consejos y Mejores Prácticas

• Usa nombres claros: El nombre de la herramienta debe reflejar su función para que sea fácil de identificar en la IA.
• Prueba el flujo antes: Asegúrate de que el flujo funciona correctamente cuando lo ejecutas manualmente.
• Define una descripción útil: La descripción ayuda a la IA a decidir cuándo usar la herramienta.
• Controla los permisos: Si el flujo accede a datos sensibles, revisa los permisos antes de exponerlo como herramienta.

Consideraciones de Seguridad

• La herramienta ejecuta el flujo tal cual está configurado; cualquier acción dentro del flujo (lectura de datos, llamadas externas, etc.) se realizará con los permisos del usuario que creó el flujo.
• Evita exponer flujos que modifiquen datos críticos sin una validación adecuada.
• Si el flujo incluye llamadas a APIs externas, verifica que las credenciales estén protegidas y que la comunicación sea segura (HTTPS).