JsonAgent
JsonAgent responde preguntas sobre el contenido de un archivo JSON o YAML. Le subes el archivo y le preguntas con tus palabras (“¿qué tiempo de entrega tiene configurado el almacén de Valencia?”). El agente recorre la estructura del archivo, mira qué apartados contiene, entra en los que necesita y te contesta con los valores que encuentra.
Es un componente antiguo que se mantiene por compatibilidad con flujos existentes.
Cuándo usarlo
- Consultar un archivo de configuración largo sin tener que leerlo entero.
- Encontrar un dato concreto dentro de una exportación JSON de otra aplicación.
- Responder preguntas sobre un catálogo o una ficha de producto guardados en JSON o YAML.
Configuración
| Conexión | Qué conectar |
|---|---|
| Model (obligatorio) | El modelo de IA que interpreta la pregunta y decide qué partes del archivo revisar. |
| Campo | Qué hace |
|---|---|
| Input | La pregunta que debe responder, normalmente desde Chat Input. |
| File Path (obligatorio) | El archivo que se consulta. Admite archivos .json, .yaml y .yml. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| 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 (consultas al archivo) 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 empresa de logística Rutas Norte guarda en un archivo JSON la configuración de sus almacenes:
- Sube el archivo en File Path.
- Conecta un modelo de IA a Model y Chat Input a Input.
- Conecta Response a Chat Output.
- Desde el chat, el responsable de operaciones pregunta: “¿Qué horario de recogida tiene el almacén de Bilbao?”.
El agente localiza el apartado del almacén de Bilbao y responde con su horario.
Buenas prácticas
- Usa nombres de campos descriptivos en el archivo: el agente se orienta por ellos.
- Si el archivo es muy grande, sube Max Iterations para que el agente tenga pasos suficientes para llegar al dato.