Code Task Agent

Code Task Agent es un agente de IA que resuelve tareas escribiendo pequeños programas y ejecutándolos en un entorno aislado. Le pides algo como “lee este Excel, calcula las ventas por región y haz un gráfico”, y el agente escribe el código, lo ejecuta, revisa el resultado y lo corrige hasta terminar la tarea.

Los archivos que genera, como gráficos, hojas de cálculo o documentos, se guardan en la conversación y aparecen en la respuesta: las imágenes se muestran directamente y el resto como enlaces de descarga.

Cuándo usarlo

Quieres que el equipo comercial pregunte por sus datos de ventas en el chat y reciba cifras y gráficos.
Necesitas limpiar, unir o transformar archivos de Excel o CSV sin hacerlo a mano.
Quieres extraer información de documentos PDF y resumirla en una tabla.
Necesitas cálculos que un modelo de IA no hace bien por sí solo, como sumas sobre miles de filas.

Configuración

Campo	Qué hace
Agent Name	El nombre del agente. Se usa cuando lo conectas como herramienta o como agente de otro agente. Por defecto, `Agent`.
Agent Description	Qué hace el agente, en una frase. Ayuda a otros agentes a decidir cuándo usarlo.
User Prompt	El texto que recibe el agente. Por defecto, `{input}`, que se sustituye por lo que llega a Input. Puedes añadir otras variables entre llaves; cada una aparece como un campo nuevo.
Input	La petición del usuario, normalmente conectada desde un Chat Input.
System Prompt	Las instrucciones generales del agente: su papel, el tono y las reglas que debe seguir. Por defecto, `You are a helpful AI assistant.`

Conexión	Qué conectar
Model (obligatorio)	El modelo de IA que dirige al agente, por ejemplo OpenAI o Anthropic.
Tools	Opcional. Otras herramientas que el agente puede usar además de ejecutar código.
Input Files	Opcional. Los archivos con los que debe trabajar el agente. Los archivos que se suben en la conversación del chat también están disponibles, sin conectarlos aquí.

Opciones avanzadas

Campo	Qué hace
Max Iterations	El número máximo de veces que el agente puede ejecutar código en cada tarea. Por defecto, 35.
Recursion Limit	El número máximo de pasos internos del agente en cada respuesta. Debe ser mucho mayor que Max Iterations. Por defecto, 1000.
Use memory	Hace que el agente recuerde los mensajes anteriores de la conversación. Al activarlo aparece la conexión Memory, donde puedes conectar un componente de memoria como Postgres Memory. Por defecto, desactivado.
Stream	Muestra la respuesta en el chat a medida que se genera. Al activarlo aparece Stream Thinking, que muestra también el razonamiento del agente. Por defecto, desactivado.
Include State in response	Añade a la respuesta los datos internos de trabajo del agente, para usarlos en componentes posteriores. Por defecto, desactivado.
Enable Python	Permite al agente escribir y ejecutar código en este lenguaje. Por defecto, activado.
Enable Node.js	Permite al agente escribir y ejecutar código en este lenguaje. Por defecto, activado.
Execution Timeout (s)	El tiempo máximo, en segundos, de cada ejecución de código. Por defecto, 120.
Python Version	La versión del lenguaje con la que se ejecuta el código. Por defecto, `3.13`.
Node.js Version	La versión del lenguaje con la que se ejecuta el código. Por defecto, `22`.
Memory Limit	La memoria máxima que puede usar el entorno donde se ejecuta el código, por ejemplo `512m` o `1g`. Por defecto, `1g`.
Default Packages	Los complementos que el entorno tiene instalados de antemano para que el código los use, uno por línea. La lista inicial ya permite trabajar con hojas de cálculo, gráficos, imágenes, páginas web y PDF. Para los de Node.js, escribe `npm:` delante del nombre.
Extra Instructions	Instrucciones que se añaden a las del agente, por ejemplo el formato en que quieres los resultados.

Procesamiento por lotes

Con el interruptor Batch Mode activado, el componente se ejecuta una vez por cada elemento de la lista que conectes en Batch Input y devuelve todos los resultados juntos en una lista. Parallel Executions indica cuántos elementos se procesan a la vez (de 1 a 5). Skip if Empty Batch Input salta el componente si la lista llega vacía, y Skip Branch if Empty Output detiene los componentes siguientes si el resultado está vacío. Más información en Conceptos clave.

Uso como herramienta de un agente

Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.

Resultado

Response: la respuesta del agente como mensaje de chat, con los archivos generados al final. Conéctala a un Chat Output.
Agent: el agente completo, para conectarlo a otro componente que coordine agentes, como Planner Executor Agent o Supervisor Agent.
Tool: el agente como herramienta, para conectarlo a la entrada Tools de otro agente.

Ejemplo

El departamento financiero de una cadena de tiendas quiere analizar sus ventas desde el chat.

Conecta un Chat Input a Input y un modelo de IA a Model.
En System Prompt escribe: Eres un analista financiero. Responde con cifras claras y, cuando ayude, con un gráfico.
Conecta Response a un Chat Output.
En el chat, sube el Excel de ventas del trimestre y pregunta: ¿Qué tienda ha crecido más respecto al trimestre anterior? Hazme un gráfico de barras.

El agente lee el archivo, hace los cálculos y responde con la explicación y el gráfico.

Buenas prácticas

Explica en la petición qué resultado esperas y en qué formato (tabla, gráfico, archivo de Excel).
Si las tareas son pesadas y se cortan, sube Execution Timeout (s).
Revisa las cifras importantes antes de usarlas en una decisión.

Componentes relacionados

Coding Agent V2: un asistente conversacional para escribir y revisar código.
Agent: el agente general de NappAI.