Coding Agent V2

Este componente es un asistente especializado de IA diseñado para ayudarte a trabajar con código de manera más eficiente. Puedes imaginarlo como un programador experto que está siempre disponible: tú le das las instrucciones sobre qué necesitas (como crear una nueva funcionalidad, corregir un error o mejorar un archivo existente) y el agente se encarga de planificar, escribir y revisar el código por ti.

A diferencia de las herramientas básicas que solo completan una línea a la vez, este agente utiliza un proceso de “razonamiento profundo”. Esto significa que piensa paso a paso antes de escribir, verificando si su solución es correcta y corrigiéndose a sí mismo si detecta errores durante el proceso. Es ideal para tareas complejas que requieren múltiples archivos o lógica intricate.

¿Cómo funciona?

El Coding Agent V2 funciona como un ciclo automatizado de desarrollo. Cuando le envías una solicitud, el agente no solo responde inmediatamente; en cambio, entra en un proceso estructurado que simula las etapas de un ingeniero de software real:

Análisis: El agente lee tu instrucción y el contexto del código que le proporcionas.
Planificación: Decide los pasos necesarios (por ejemplo: “primero leeré este archivo”, “luego modificaré esta función”).
Ejecución y Prueba: Escribe el código y, si es necesario, lo “ejecuta” internamente en un entorno seguro para comprobar que funciona.
Refinamiento: Si encuentra errores o si el código no cumple exactamente con lo que pediste, lo reescribe y vuelve a verificarlo hasta que esté listo.

Al final de este proceso, te entrega el código final listo para usar y una explicación clara de lo que hizo y por qué.

Conexión y Credenciales

Este componente está diseñado para trabajar también con servidores remotos si tu flujo de automatización lo requiere. Para habilitar funciones avanzadas como conectar con servidores externos, editar archivos en otros sistemas o ejecutar scripts remotos, debes configurar una credencial previa.

Si no necesitas conectar con servidores remotos, puedes ignorar esta sección y usar el agente solo en tu entorno local. Si necesitas esa conectividad, sigue estos pasos:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial del tipo SSH Client. Deberás configurar los datos de acceso a tu servidor (como la dirección IP, usuario y contraseña o clave privada).
Una vez guardada la credencial, vuelve a este componente y selecciona esa credencial en el campo Credential.

Esto permitirá al agente, si lo configuras con las opciones SSH activadas, trabajar de forma segura con archivos en servidores remotos.

Entradas

A continuación, encontrarás los campos disponibles para configurar este componente. Estos campos te permiten darle al agente la información necesaria para realizar su tarea.

Campos de Entrada

Memory top message: Número de mensajes de historial que se pasarán al agente como contexto. Para pasar todos los mensajes usa -1.
- Visible en: N/A
System Prompt: System prompt for the agent (managed internally)
- Visible en: N/A
Just Dropped: Internal flag to indicate if the component was just dropped
- Visible en: N/A
Enable SSH: Enable SSH/SFTP capabilities for remote server operations
- Visible en: N/A
SSH Allowed Hosts: Whitelist of allowed hosts (one per line). If empty, configured hostname is allowed.
- Visible en: N/A
SSH Allowed Paths: Whitelist of allowed paths for file operations (one per line)
- Visible en: N/A
SSH Read-Only Mode: Enable read-only mode (blocks write and edit operations)
- Visible en: N/A

Nota importante para el usuario: La mayoría de los campos anteriores (Memory top message, Enable SSH, SSH Allowed Hosts, etc.) son configuraciones técnicas o de sistema que no suelen requerir interacción directa en cada uso del agente. El campo principal que usarás es implícito: la instrucción o el texto que escribas para pedirle al agente que realice una tarea.

Salidas

Cuando el Coding Agent V2 completa su tarea, te devuelve resultados claros que puedes usar en el resto de tu flujo de trabajo.

Principalmente, recibirás dos tipos de información:

El Código Resultante: El bloque de código generado, editado o traducido, listo para ser copiado, guardado o utilizado por otros componentes.
Análisis y Explicación: Un texto descriptivo que explica qué cambios se hicieron, por qué se tomaron ciertas decisiones y si se encontraron errores durante el proceso. Esto te ayuda a entender el trabajo del agente y verificar que sea seguro.

Ejemplo de Respuesta JSON

json { “code”: “def calculate_total(items):\n total = 0\n for item in items:\n total += item[‘price’] * item[‘quantity’]\n return total”, “explanation”: “He creado una función simple que itera a través de una lista de diccionarios. Calcula el precio total multiplicando el precio unitario por la cantidad de cada artículo y suma todos los valores. El código incluye comentarios para mejorar la legibilidad.”, “files_modified”: [ { “path”: “/src/main.py”, “action”: “updated” } ] }

Conectividad

Este componente actúa como un “cerebro” de programación dentro de tu flujo. Por lo general, se conecta:

Entrada: Recibe instrucciones desde otros componentes que extraen datos, analizan errores previos o simplemente capturan la solicitud del usuario (como un nodo de texto o un analizador de errores).
Salida: Sus resultados (código y explicaciones) suelen enviarse a:
- Componentes de Visualización de Código para mostrar el resultado al usuario final.
- Componentes de Gestión de Archivos para guardar el código generado en una carpeta.
- Componentes de Ejecución de Código para probar el script recién creado.
- Otros agentes de Automatización que necesiten el código resultante para integrarlo en una aplicación.

Su capacidad de conectar con servidores remotos (vía SSH) lo hace especialmente útil en flujos donde necesitas generar o modificar archivos en servidores de producción o bases de datos.

Ejemplo de Uso

Imagina que estás automatizando la gestión de reportes mensuales en tu sistema de datos.

Situación: Necesitas un script Python que extraiga datos de una base de datos y los formatee en un archivo CSV.
Uso del Agente: Arrastras el Coding Agent V2 a tu flujo.
Instrucción: En el campo de instrucción (implícito o contextual), escribes: “Crea un script Python que conecte a mi base de datos MySQL, extraiga los registros de ventas del último mes y los guarde en un archivo llamado ‘ventas_mes.csv’.”
Resultado: El agente analiza tu petición, escribe el código Python necesario (incluyendo la conexión a la BD), te muestra una explicación de cómo funciona el script y te proporciona el código listo para ser ejecutado por un componente de ejecución posterior.

Plantillas

Nota: No hay plantillas predefinidas asociadas a este componente en el momento.

Componentes Relacionados

Nota: No hay componentes relacionados específicos listados.

Notas Importantes

Nota: No hay notas de usuario críticas (limitaciones de seguridad, comportamientos extraños, etc.) definidas explícitamente en la fuente para este componente específico en esta lista vacía.

Consejos y Mejores Prácticas

Sé claro con tus instrucciones: Cuanto más específica sea la tarea (por ejemplo, “usa la librería pandas” o “maneja los errores de conexión”), mejor será la planificación del agente.
Revisa las explicaciones: El campo de “Análisis y Explicación” es tu mejor amigo. Úsalo para verificar que el agente no ha hecho suposiciones incorrectas sobre tus datos.
Itera si es necesario: Si el código generado no es exactamente lo que necesitabas, puedes usar la explicación para entender por qué y volver a pedir una corrección en una nueva iteración del flujo.
Cuidado con SSH: Si activas el modo SSH, asegúrate de haber configurado correctamente las credenciales y las whitelists de hosts para evitar bloqueos de seguridad o accesos no deseados.

Consideraciones de Seguridad

Privacidad del Código: Ten en cuenta que el código que envías al agente puede ser procesado por modelos de IA. Si manejas código con datos sensibles o secretos comerciales, revisa las políticas de privacidad de Nappai y de los proveedores de IA subyacentes.
Control de Acceso SSH: Si utilizas las capacidades SSH, asegúrate de definir estrictamente las rutas (SSH Allowed Paths) y hosts permitidos para que el agente solo pueda modificar los archivos necesarios y no tenga acceso a todo el servidor.
Modo Solo Lectura: Considera usar el SSH Read-Only Mode si solo necesitas analizar código o archivos sin riesgo de modificarlos accidentalmente.