Analizar archivos

Analizar archivos adjuntos a un agente: extraer, sintetizar o responder consultas sobre contenido.

Lo que hace

Analizar archivos es una herramienta integrada que se adjunta a un agente autónomo. Pasa uno o más archivos a un modelo lingüístico de gran tamaño (LLM) para extraer, sintetizar o responder consultas sobre su contenido.

Los archivos pueden ser documentos, imágenes u otros archivos adjuntos. El agente decide cuándo llamar a la herramienta mientras razona, pasando los archivos y una tarea, y la herramienta devuelve el resultado para que lo utilice el agente.

Cuándo usarlo

Conecta Analizar archivos cuando el agente necesita leer tipos de archivos mixtos, o dos o más archivos adjuntos a la vez, y responder a una pregunta o extraer contenido de ellos.

Busca Analizar archivos sobre las alternativas en estos casos:

• Tienes uno o más archivos de tipos variados (documentos, imágenes, escaneos) y deseas que el agente extraiga o razone sobre su contenido.
• La tarea se describe en lenguaje natural ("resumir este documento", "lo que hay en esta imagen", "extraer los puntos clave") en lugar de un esquema fijo de campos.

Para otras formas de trabajo:

• Para sintetizar en un documento largo (hasta 1000 páginas) con citas, utiliza la herramienta Resumir .
• Para extraer campos estructurados y escritos de un documento utilizando un modelo entrenado, utiliza el nodo Extraer .

Añadir la herramienta a un agente

Analizar archivos se adjunta a un agente autónomo como herramienta. No se ejecuta por sí solo.

1. Añade un agente autónomo al lienzo.
2. Desde la paleta del nodo, abre la categoría Herramientas de agente y selecciona Analizar archivos. Flow añade el nodo de herramienta al lienzo.
3. Conecta la herramienta al identificador de la herramienta del agente.
4. Selecciona el nodo de herramienta para abrir su panel de propiedades.
5. Configura la herramienta como se describe a continuación.

Resultado: la herramienta Analizar archivos está conectada al agente. El agente ahora puede llamarlo mientras razona.

Referencia de configuración

Configura la herramienta en la sección Configuración de analizar archivos del panel de propiedades.

Campo	Obligatorio	Predeterminado	Descripción
Descripción de la herramienta	No	Analyze one or more files with an LLM to extract, synthesize, or answer queries about their content.	Descripción en lenguaje natural de lo que hace la herramienta, utilizada por el agente para decidir cuándo llamarla. Refinarlo para restringir cuándo el agente utiliza la herramienta.
archivos adjuntos (matriz)	No	Array of files, documents, images, or other attachments to process	Descripción de los archivos que el agente pasa a la herramienta. Edítala para decirle al agente qué tipo de archivos adjuntos enviar.
elementos (archivo)	No	Vacío	Descripción opcional por elemento para un solo archivo dentro de la matriz de archivos adjuntos. Déjalo vacío si la descripción a nivel de matriz es suficiente.
tareaDeAnálisis (cadena)	Sí	Ninguno	Tarea, pregunta o instrucción para procesar los archivos. Descríbelo en lenguaje sencillo, por ejemplo, summarize this document, extract key points o what is in this image.
Configuración de la simulación	No	Contraído	Llamadas de ejemplo utilizadas para probar la herramienta sin invocar el modelo en vivo. Selecciona Añadir llamada de ejemplo para definir un ejemplo.

Entradas y salidas

Entradas

El agente proporciona los archivos y la tarea cuando llama a la herramienta. La configuración anterior define lo que el agente puede pasar y cómo se comporta la herramienta.

Salida

La herramienta devuelve su resultado al agente que la llamó. Cuando necesites leer la salida de la herramienta directamente en el flujo, accede a ella $vars.<nodeName>.output, donde <nodeName> es el nombre del nodo Analizar archivos en el lienzo.

$vars.analyzeFiles1.output

En la mayoría de los flujos, no se lee la salida de la herramienta directamente. El agente consume el resultado como parte de su razonamiento y devuelve su propio resultado el $vars.<agentNode>.output. Consulta Agente para ver la forma de salida del agente.

Ejemplo

Un agente procesa un correo electrónico entrante con archivos adjuntos mixtos (una imagen de recibo escaneada y un extracto en PDF) y responde una pregunta sobre ellos.

1. Añade un agente autónomo al lienzo.
2. Desde la paleta, abre Herramientas de agente y selecciona Analizar archivos.
3. Conecta la herramienta al identificador de la herramienta del agente.
4. En la herramienta Analizar archivos, edita los archivos adjuntos (matriz) para describir lo que debe enviar el agente, por ejemplo The receipt image and statement PDF attached to the incoming email.
5. Establece tareaDeAnálisis (cadena) en el trabajo que deseas realizar:

Read each attached file. Identify the merchant, the date, and the total amount on
the receipt, and confirm whether the statement lists a matching charge.

6. En la solicitud de usuario del agente, indícale que utilice la herramienta, por ejemplo: Use the Analyze Files tool to check the attachments and tell me whether the receipt matches a charge on the statement.

Cuando el agente se ejecuta, llama a Analizar archivos con los archivos adjuntos, recibe el análisis y devuelve su respuesta el $vars.agent1.output.content.

Páginas relacionadas

• Agente
• Resumir
• Extraer