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. Na paleta de nós, abra a categoria Ferramentas do agente e selecione Analisar Arquivos.O fluxo adiciona o nó da ferramenta à tela.
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 da configuração

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

Campo	Required	Padrão	Description
Descrição da ferramenta	Não	Analyze one or more files with an LLM to extract, synthesize, or answer queries about their content.	Descrição em linguagem natural do que a ferramenta faz, que o agente usa para decidir quando chamá-la. Refine para restringir quando o agente usa a ferramenta.
anexos (array)	Não	Array of files, documents, images, or other attachments to process	Descrição dos arquivos que o agente passa para a ferramenta. Edite-a para informar ao agente que tipo de anexos enviar.
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.
TarefaDeAnálise (string)	Sim	Nenhum	Tarefa, pergunta ou instrução para processar os arquivos. Descreva-o em linguagem simples, por exemplo, summarize this document, extract key points ou what is in this image.
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

A ferramenta retorna seu resultado para o agente que a chamou. Quando você precisar ler a saída da ferramenta diretamente no fluxo, acesse-a em $vars.<nodeName>.output, onde <nodeName> é o nome do nó Analisar arquivos na tela.

$vars.analyzeFiles1.output

In most flows 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. Refer to Autonomous Agent for 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. Na paleta, abra Ferramentas do agente e selecione Analisar arquivos.
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.

Páginas relacionadas

• Agente Autônomo
• Resumir
• Extrair