PDF Reader Tool

A Tool PDF Reader permite que um Agente leia, interprete e raciocine sobre o conteúdo completo de um documento PDF enviado durante a configuração do Agente.

Diferente das Knowledge Bases, que dividem o conteúdo em blocos para recuperação, a PDF Reader preserva a estrutura e a continuidade completas de um único documento, permitindo um raciocínio mais profundo e contextual.

🔎 O que ela faz

Com a PDF Reader, um Agente pode:

Ler um documento PDF pré-configurado
Ler PDFs criptografados ou protegidos quando o texto ainda pode ser extraído
Entender o documento como um todo, sem fragmentação
Extrair insights, resumos, regras ou informações estruturadas
Raciocinar entre seções, páginas e referências de forma consistente

Essa tool é ideal quando um documento deve ser tratado como contexto de autoridade, e não como trechos pesquisáveis.

🧠 Como a PDF Reader funciona

A PDF Reader atua como uma extensão cognitiva estática do Agente.

No momento da configuração:

O criador do Agente envia um arquivo PDF.
O documento completo é ingerido como uma única fonte contextual.
Durante as conversas, o Agente pode raciocinar sobre o documento inteiro sempre que necessário.
O documento permanece disponível para o Agente enquanto a tool existir.

O Agente decide usar a PDF Reader com base na descrição da tool, não por ação do usuário.

Compatibilidade de modelos

Os modelos suportados, incluindo o Grok 4.5, recebem corretamente as informações configuradas da PDF Reader quando o Agente prepara uma chamada de tool.

A definição da tool deve permanecer completa no contexto do Agente. Se a configuração for inválida ou indisponível, a execução deve reportar uma falha clara em vez de passar uma property de tool indefinida.

🔐 PDFs criptografados e legibilidade

O Zaia não rejeita um PDF apenas por ele estar criptografado ou protegido.

Se o arquivo ainda permitir seleção ou extração de texto, o Zaia o processa normalmente.

Quando o caminho de extração principal não retorna conteúdo utilizável, o Zaia tenta novamente com um fallback de texto simples.

O Zaia só trata o arquivo como ilegível quando nenhum texto pode ser extraído após todas as tentativas suportadas.

Isso reduz falsos negativos para arquivos protegidos que ainda contêm conteúdo legível.

PDFs que ainda falham

O Zaia não consegue extrair conteúdo de:

PDFs somente de imagem ou escaneados sem texto selecionável
Arquivos PDF inválidos ou corrompidos
PDFs que realmente não contêm texto extraível

Quando a extração falha, o Zaia reporta que o conteúdo não pôde ser extraído em vez de presumir proteção por senha.

📚 PDF Reader vs. Knowledge Base

Use a PDF Reader quando:

O documento deve ser interpretado como um todo
É necessário entendimento entre seções
O conteúdo representa uma única fonte de verdade (por exemplo, contrato, política, manual)
O documento não precisa de recuperação semântica por fragmentos

Use a Knowledge Base quando:

O conteúdo precisa ser pesquisável e modular
A informação muda com frequência
Múltiplos documentos precisam ser consultados
Você quer uma recuperação escalável e de longo prazo

💡 Regra prática:
A PDF Reader é para raciocínio profundo sobre um único documento.
A Knowledge Base é para busca em vários documentos.

📄 Casos de uso comuns

Políticas da empresa ou manuais de regras internas
Contratos legais ou documentos de conformidade
Manuais técnicos ou especificações
PDFs institucionais que devem ser seguidos rigorosamente

⚙️ Configuração da tool

Ao criar uma PDF Reader Tool, você configura:

Name
Um identificador claro para a tool
Exemplo: Company Policy PDF
Description
Orienta o Agente sobre quando usar o documento
Exemplo:

“Use esta tool sempre que o usuário perguntar sobre regras, políticas ou procedimentos internos da empresa.”
PDF File
O documento enviado durante a configuração do Agente

A descrição é essencial — ela determina quando o Agente vai recorrer ao PDF.

🧠 Boas práticas

Use a PDF Reader para documentos que devem ser interpretados na íntegra
Evite duplicar documentos grandes no prompt principal
Mantenha a descrição explícita e delimitada
Se o documento precisar de atualizações ou busca frequentes, prefira uma Knowledge Base
Combine com Tasks ou Follow Ups para agir sobre conclusões baseadas no documento

✅ Resumo

A Tool PDF Reader permite que um Agente raciocine sobre um único documento PDF completo, configurado pelo criador do Agente, sem divisão em blocos ou fragmentação.

É a melhor escolha quando integridade estrutural, coerência e compreensão de contexto completo são fundamentais — incluindo PDFs protegidos que ainda expõem texto legível.