CSVAgent
CSVAgent responde preguntas sobre el contenido de un archivo CSV. Le subes el archivo, le escribes la pregunta con tus palabras (“¿cuál es el importe medio de las facturas de enero?”) y el agente carga el archivo como una tabla, hace los cálculos necesarios y te contesta con el resultado.
Para hacer esos cálculos, el agente escribe y ejecuta pequeños fragmentos de código sobre la tabla. Es un componente antiguo que se mantiene por compatibilidad con flujos existentes.
Cuándo usarlo
- Consultar un listado de ventas, pedidos o clientes exportado a CSV sin abrir una hoja de cálculo.
- Obtener totales, medias o recuentos de un archivo concreto.
- Responder preguntas puntuales sobre un inventario o una tarifa en CSV.
Configuración
| Conexión | Qué conectar |
|---|---|
| Model (obligatorio) | El modelo de IA que interpreta la pregunta y prepara los cálculos. |
| Campo | Qué hace |
|---|---|
| Input | La pregunta que debe responder, normalmente desde Chat Input. |
| File Path (obligatorio) | El archivo CSV que se consulta. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Agent Type | Cómo razona el agente y usa sus herramientas: openai-tools (por defecto), openai-functions o zero-shot-react-description. Usa zero-shot-react-description si el modelo conectado no admite herramientas. |
| Handle Parse Errors | Si el modelo devuelve una respuesta con un formato inesperado, el agente intenta recuperarse en lugar de detenerse. Por defecto: activado. |
| Verbose | Registra con detalle los pasos del agente. Por defecto: activado. |
| Max Iterations | Número máximo de pasos antes de detenerse. Por defecto: 15. |
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 a la pregunta como mensaje. Conéctala a Chat Output o a cualquier componente que reciba texto.
- Agent: el agente configurado, para conectarlo a componentes que reciban un agente.
Ejemplo
La gestoría Martín & Asociados exporta cada mes las facturas emitidas a un archivo CSV:
- Sube el archivo de facturas en File Path.
- Conecta un modelo de IA a Model y Chat Input a Input.
- Conecta Response a Chat Output.
- Desde el chat, pregunta: “¿Qué tres clientes han facturado más este mes y por qué importe?”.
El agente calcula los totales por cliente y responde con los tres primeros y sus importes.
Buenas prácticas
- Usa archivos con una fila de encabezados clara: el agente se guía por los nombres de las columnas.
- Formula preguntas concretas e indica la columna o el periodo que te interesa.
Componentes relacionados
- CSV to Data List: convierte un CSV en registros para recorrerlos en el flujo.
- Agent: el agente principal de NappAI.