Saltearse al contenido
Nappai Documentation

Code Agent

El Code Agent es un asistente inteligente que permite a los usuarios de Nappai transformar su código fuente de manera automática. Con él puedes migrar tu código a otro lenguaje, actualizarlo a las mejores prácticas actuales o corregir vulnerabilidades de seguridad, todo sin salir del dashboard.

¿Cómo funciona?

El Code Agent utiliza un modelo de lenguaje avanzado (por ejemplo, GPT‑4) para analizar el código que le entregas y generar la versión solicitada. Cuando seleccionas una operación, el agente envía el código y los parámetros a la API del modelo, recibe la respuesta y la devuelve como datos estructurados o texto. Si habilitas Enable Streaming, verás el resultado en tiempo real a medida que el modelo lo genera. Los reintentos automáticos garantizan que, en caso de fallos temporales, el proceso se reintente sin intervención manual.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Code Language migration: Transfiere tu código de un lenguaje de programación a otro, manteniendo la lógica y estructura original.
  • Code modernization: Actualiza tu código a las últimas prácticas y patrones de desarrollo, mejorando legibilidad y rendimiento.
  • Code security fix: Identifica y corrige vulnerabilidades de seguridad en tu código, asegurando que cumpla con estándares de protección.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Campos de Entrada

  • Language Model: El modelo de lenguaje que se usará para la conversión de código.
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Sources: El código fuente que deseas procesar.
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Operations: Selecciona la operación que quieres ejecutar.
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Conversion Type: Tipo de conversión de código que se realizará. (REQUIRED)
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Enable Retries: Permite reintentos automáticos en caso de fallos.
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Enable Streaming: Activa la transmisión de respuestas en tiempo real.
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Max Execution Steps: Número máximo de pasos de ejecución que el agente puede realizar.
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Source Language: El lenguaje de programación del código fuente. (REQUIRED)
    • Visible en: Code Language migration, Code modernization, Code security fix
  • Target Language: El lenguaje de programación al que quieres convertir el código. (REQUIRED)
    • Visible en: Code Language migration, Code modernization, Code security fix

Nota: Los campos marcados como REQUIRED deben completarse antes de ejecutar la operación.

Salidas

  • Data: Devuelve el código convertido o actualizado como un objeto de datos que puede ser usado por otros componentes del flujo.
  • Text: Devuelve un mensaje de texto con el resultado, útil cuando se activa la opción de streaming.

Ejemplo de Uso

1. Migrar código de Python a JavaScript

  1. Selecciona la operación Code Language migration.
  2. En Source Language elige Python y en Target Language JavaScript.
  3. Pega tu script Python en el campo Sources.
  4. Elige un modelo de lenguaje (por ejemplo, GPT‑4) en Language Model.
  5. Marca Enable Streaming si quieres ver el resultado en tiempo real.
  6. Haz clic en Run.
  7. El resultado aparecerá en la salida Data como un bloque de código JavaScript listo para usar.

2. Modernizar código Java legacy

  1. Selecciona la operación Code modernization.
  2. Configura Source Language y Target Language ambos como Java.
  3. Pega el código Java legacy en Sources.
  4. Elige el modelo de lenguaje y ajusta Max Execution Steps si tu código es muy grande.
  5. Ejecuta y revisa la salida Data para ver las mejoras aplicadas.

Componentes Relacionados

  • None – No hay componentes directamente vinculados a este agente en el flujo actual.

Consejos y Mejores Prácticas

  • Revisa siempre el código generado antes de integrarlo en producción.
  • Usa un modelo actualizado para obtener resultados más precisos y seguros.
  • Mantén copias de seguridad de tu código original antes de ejecutar operaciones de migración o modernización.
  • Activa streaming cuando trabajes con archivos grandes para monitorear el progreso.
  • Ajusta Max Execution Steps según la complejidad del código para evitar tiempos de espera excesivos.

Consideraciones de Seguridad

  • El código que envías al agente puede contener información sensible; asegúrate de que el entorno de Nappai esté protegido y que los datos no se almacenen en lugares no seguros.
  • Si tu código incluye credenciales o datos confidenciales, remuévelos antes de enviarlo al agente.
  • Revisa las políticas de privacidad del modelo de lenguaje que utilizas para garantizar el cumplimiento de tus requisitos de seguridad.