Analisar arquivos

Analise arquivos anexados a um agente: extraia, sintetize ou responda a consultas sobre conteúdo.

O que faz

Analisar arquivos é uma ferramenta integrada que você anexa a um Agente autônomo. Ele passa um ou mais arquivos para um grande modelo de linguagem (LLM) para extrair, sintetizar ou responder a consultas sobre o conteúdo deles.

Os arquivos podem ser documentos, imagens ou outros anexos. O agente decide quando chamar a ferramenta durante o raciocínio, passando os arquivos e uma tarefa, e a ferramenta retorna o resultado para o agente usar.

Quando usar

Conecte Analisar arquivos quando o agente precisar ler tipos de arquivos mistos ou dois ou mais anexos de uma só vez e responder a uma pergunta ou extrair conteúdo delas.

Opte por Analisar Arquivos em vez das alternativas nestes casos:

• Você tem um ou mais arquivos de tipos variados (documentos, imagens, digitalizações) e deseja que o agente extraia ou raciocine sobre o conteúdo deles.
• A tarefa é descrita em linguagem natural ("resumir este documento", "o que há nesta imagem", "extraia os pontos principais"), em vez de um esquema fixo de campos.

Para outras formas de trabalho:

• Para sintetizar em um documento longo (até 1.000 páginas) com citações, use a ferramenta Resumir.
• Para extrair campos estruturados e tipificados de um documento usando um modelo treinado, use o nó Extrair.

Adição da ferramenta a um agente

Analisar Arquivos anexa-se a um Agente autônomo como uma ferramenta.Ele não é executado por conta própria.

1. Adicione um Agente autônomo à tela.
2. From the Add node panel, select Analyze Files. Maestro Orchestrate adds the tool node to the canvas.
3. Conecte a ferramenta ao identificador da ferramenta do agente.
4. Selecione o nó da ferramenta para abrir seu painel de propriedades.
5. Configure a ferramenta conforme descrito abaixo.

Resultado: a ferramenta Analisar Arquivos está conectada ao agente. O agente agora pode chamá-lo durante o raciocínio.

Referência de configuração

Configure a ferramenta na seção Configurações do Analisar Arquivos do painel de propriedades.

Campo	Required	Padrão	Description
Description	Não	Vazio	What the tool is for, in plain language. The agent reads it to decide when to call the tool.
Anexos	Não	Array of files, documents, images, or other attachments to process	The files to analyze. The agent fills this in when it calls the tool, so the field shows in purple.
itens (arquivo)	Não	Vazio	Descrição opcional por item para um único arquivo dentro do array de anexos. Deixe-o vazio se a descrição no nível do array for suficiente.
Tarefa de análise	Sim	The task, question, or instruction for processing the files	What to do with the files, such as summarize this document. The agent fills this in when it calls the tool.
Configurações da Simulação	Não	Recolhido	Chamadas de exemplo usadas para testar a ferramenta sem invocar o modelo ativo. Selecione Adicionar chamada de exemplo para definir um exemplo.

Entradas e saídas

Entradas

O agente fornece os arquivos e a tarefa quando ele chama a ferramenta. A configuração acima define o que o agente pode passar e como a ferramenta se comporta.

Saída

The tool returns its result to the agent that called it. When you need to read the tool's output directly in the workflow, access it at $vars.<nodeName>.output, where <nodeName> is the name of the Analyze Files node on the canvas.

$vars.analyzeFiles1.output

In most workflows you don't read the tool output directly. The agent consumes the result as part of its reasoning and returns its own result on $vars.<agentNode>.output. Autonomous Agent describes the agent's output shape.

Exemplo

Um agente processa um e-mail de entrada com anexos mistos (uma imagem de recibo escaneada e uma declaração em PDF) e responde a uma pergunta sobre eles.

1. Adicione um Agente autônomo à tela.
2. From the Add node panel, select Analyze Files.
3. Conecte a ferramenta ao identificador da ferramenta do agente.
4. Na ferramenta Analisar arquivos, edite anexos (array) para descrever o que o agente deve enviar, por exemplo, The receipt image and statement PDF attached to the incoming email.
5. Defina analysisTask (string) para o trabalho que você deseja fazer:

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. Na solicitação do usuário do agente, instrua o agente a usar a ferramenta, por exemplo: Use the Analyze Files tool to check the attachments and tell me whether the receipt matches a charge on the statement.

Quando o agente executa, ele chama Analisar arquivos com os anexos, recebe a análise e retorna sua resposta em $vars.agent1.output.content.

Próximas Etapas

• Agente Autônomo
• Resumir
• Extrair