Python Executor Tool

El Python Executor Tool es una herramienta sencilla que permite a los usuarios de Nappai ejecutar fragmentos de código Python dentro de su flujo de trabajo. No necesita configuraciones externas ni conexiones a APIs; simplemente recibe el nombre de la herramienta y, opcionalmente, un modo de depuración, y devuelve un objeto que puede ser usado por otros componentes del dashboard.

¿Cómo funciona?

Cuando activas el Python Executor Tool, Nappai crea un entorno aislado donde se ejecuta el código Python que el agente necesita. El componente no llama a servicios externos; todo el procesamiento ocurre localmente en el servidor de Nappai. El resultado de la ejecución se empaqueta en un objeto de tipo Tool, que puede ser pasado a otros componentes para que el agente continúe con su tarea.

Entradas

Campos de Entrada

• Debug Mode: Activa un modo de depuración que muestra información detallada sobre errores y excepciones que ocurran durante la ejecución del código. Útil cuando necesitas diagnosticar problemas en scripts complejos.
• Tool Name: Nombre descriptivo de la herramienta que se está creando. Este nombre aparecerá en los registros y en la interfaz de usuario cuando el agente invoque la herramienta.

Salidas

• Tool: Devuelve un objeto de tipo Tool que encapsula la lógica de ejecución de Python. Este objeto puede ser conectado a otros componentes, como un Agent o un Workflow Runner, para que el agente lo invoque cuando lo necesite.

Ejemplo de Uso

1. Añade el componente “Python Executor Tool” al flujo de trabajo.
2. Configura las entradas:
   • Tool Name: DataCleaner
   • Debug Mode: False (o True si quieres ver errores detallados)
3. Conecta la salida Tool a un componente Agent que necesita ejecutar código Python para limpiar datos.
4. Cuando el agente se active, llamará a la herramienta DataCleaner, y el código Python definido en el flujo se ejecutará automáticamente.

Componentes Relacionados

• PythonExecutorToolBase – Clase base que define la lógica común para ejecutar código Python.
• Agent – Componente que puede invocar la herramienta Tool generada por el Python Executor Tool.

Consejos y Mejores Prácticas

• Usa nombres claros: El nombre de la herramienta debe reflejar su función (ej. DataCleaner, ReportGenerator).
• Activa el modo de depuración solo cuando sea necesario: Mantenerlo desactivado en producción reduce la cantidad de información sensible que se muestra.
• Revisa el código antes de ejecutarlo: Asegúrate de que el script Python no contenga operaciones peligrosas o que puedan comprometer la seguridad del sistema.

Consideraciones de Seguridad

Ejecutar código Python arbitrario puede ser riesgoso. Asegúrate de que solo usuarios autorizados tengan acceso a este componente y que el código que se ejecuta provenga de fuentes confiables. Si es posible, limita los permisos del entorno de ejecución para evitar accesos no deseados a archivos o recursos del sistema.