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 seu conteúdo.

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

Quando usar

Conecte Arquivos de análise quando o agente precisar ler tipos de arquivo mistos ou dois ou mais anexos de uma vez e responder a uma pergunta ou extrair conteúdo deles.

Consulte Analisar arquivos sobre as 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 está nesta imagem", "extrair os pontos-chave"), 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 digitados de um documento usando um modelo treinado, use o nó Extract .

Adicionando a ferramenta a um agente

Analisar arquivos anexa 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 de 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 enquanto raciocina.

Referência da configuração

Configure a ferramenta na seção Analisar configurações de 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, usada pelo agente para decidir quando chamá-la. Refine-o 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-o para informar ao agente que tipo de anexos enviar.
itens (arquivo)	Não	Vazio	Descrição opcional por item para um único arquivo dentro da matriz de anexos. Deixe em branco 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-a 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 ao vivo. Selecione Adicionar chamada de exemplo para definir um exemplo.

Entradas e saídas

Entradas

O agente fornece os arquivos e a tarefa quando 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 ao agente que a chama. Quando você precisar ler a saída da ferramenta diretamente no fluxo, acesse-a $vars.<nodeName>.output, onde <nodeName> é o nome do nó Analisar Arquivos na tela.

$vars.analyzeFiles1.output

Na maioria dos fluxos, você não lê a saída da ferramenta diretamente. O agente consome o resultado como parte de seu raciocínio e retorna seu próprio resultado $vars.<agentNode>.output. Consulte Agente para formato de saída do agente.

Exemplo

Um agente processa um e-mail de entrada com anexos mistos (uma imagem de recibo digitalizada e uma instrução 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 de 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 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 é executado, ele chama Analisar arquivos com os anexos, recebe a análise e retorna sua resposta $vars.agent1.output.content.

Páginas relacionadas

• Agente
• Resumir
• Extrair