Arquivo direto ou File Search para agentes de IA?

A escolha aparece antes do primeiro prompt

Um agente recebe um contrato e precisa localizar três obrigações. Enviar o arquivo junto da solicitação pode resolver o caso. Outra operação consulta centenas de políticas todos os dias, com versões, permissões e atualizações frequentes. Reenviar todo o acervo em cada execução produz custo, latência e risco desnecessários.

As duas situações usam documentos, mas pedem arquiteturas diferentes.

Arquivo direto coloca um documento específico no contexto da execução. File Search mantém arquivos numa base pesquisável e recupera trechos relevantes quando a pergunta chega. A decisão afeta qualidade, custo, atualização, evidência, segurança e manutenção.

Este guia compara os dois caminhos na Responses API da OpenAI, conforme a documentação oficial verificada em 21 de setembro de 2026. O princípio vale para outros fornecedores: escolha o mecanismo pela tarefa, pelo ciclo de vida da fonte e pela prova que a resposta precisa carregar.

O que acontece com um arquivo direto

A Responses API aceita arquivos como itens input_file. O arquivo pode entrar por um identificador criado pela Files API, por dados codificados em Base64 ou por uma URL externa compatível.

Segundo a documentação oficial de File inputs, o processamento depende do formato:

PDFs podem fornecer texto e imagens das páginas a modelos com visão;
documentos como DOCX, PPTX e arquivos de texto fornecem texto extraído;
planilhas passam por um fluxo específico de processamento;
o arquivo participa daquela solicitação como contexto disponível ao modelo.

Esse desenho funciona bem quando a pessoa ou o sistema já sabe qual arquivo deve ser analisado. O contrato chegou junto do caso. A proposta pertence àquela compra. O relatório mensal está identificado. A unidade de trabalho e a fonte são explícitas.

O arquivo direto reduz a necessidade de montar uma camada de recuperação para uma tarefa isolada. Em troca, o conteúdo enviado ocupa contexto, gera consumo e precisa ser selecionado corretamente antes da chamada.

O que muda com File Search

O File Search é uma ferramenta hospedada da Responses API. Os arquivos são adicionados a um vector store. Quando a execução precisa de conhecimento, o modelo pode acionar a busca e recuperar trechos por mecanismos semânticos e textuais.

A resposta pode trazer citações aos arquivos. A aplicação também pode solicitar os resultados da busca para inspecionar o que foi recuperado. É possível limitar a quantidade de resultados e aplicar filtros por metadados.

Esse caminho atende perguntas recorrentes sobre um conjunto maior de fontes. A execução deixa de carregar todo o acervo e passa a buscar candidatos para aquela pergunta.

A busca acrescenta um componente operacional que precisa ser governado:

ingestão e status de processamento;
divisão do conteúdo em trechos;
metadados;
atualização e remoção;
filtros de acesso;
qualidade da recuperação;
citações e ausência de evidência;
custo de armazenamento e consulta.

A conveniência da ferramenta hospedada reduz código de infraestrutura. A empresa continua responsável por escolher fontes, definir elegibilidade e verificar se o trecho recuperado sustenta a resposta.

Quando usar arquivo direto

Um documento conhecido por execução

Use arquivo direto quando cada caso já chega com a fonte correta. Uma análise de proposta, uma revisão de relatório ou a extração de campos de um formulário não precisa pesquisar uma biblioteca para descobrir o documento.

O vínculo entre caso e arquivo deve ser confirmado fora do modelo. Nome parecido não prova que o anexo pertence ao cliente, ao período ou à versão correta.

Trabalho pontual ou exploratório

Uma equipe pode testar a análise de poucos documentos antes de investir em indexação. O envio direto ajuda a observar qualidade, formato de saída e esforço de revisão com uma arquitetura menor.

O piloto precisa registrar quais arquivos foram usados e evitar dados empresariais sem autorização. Exploração não suspende política de acesso.

Conteúdo visual relevante em PDF

Quando gráficos, diagramas, carimbos ou disposição visual fazem parte da pergunta, o PDF direto pode oferecer texto e imagens das páginas ao modelo compatível. Isso aumenta o consumo de tokens e exige avaliação com os formatos reais.

A mesma suposição não deve ser aplicada a todos os formatos. A documentação informa que PPTX e DOCX têm texto extraído no fluxo de entrada de arquivos. Se o layout for material para a decisão, teste uma representação adequada, como PDF ou imagens autorizadas, e confira visualmente o resultado.

Escopo pequeno e estável

Poucos arquivos, selecionados por uma regra clara, podem ser mais simples de enviar diretamente. Criar uma base pesquisável para três documentos estáveis acrescenta manutenção sem provar ganho.

Quando usar File Search

Perguntas recorrentes sobre muitas fontes

Manuais, políticas, contratos-modelo, documentação de produto e procedimentos podem formar um acervo grande. As perguntas variam e a fonte relevante não é conhecida antes da consulta. A busca reduz o contexto enviado ao modelo e localiza candidatos por linguagem textual e semântica.

Reutilização entre muitas execuções

Se o mesmo conjunto de fontes serve a centenas de perguntas, reenviar tudo em cada chamada desperdiça contexto. Uma base pesquisável permite ingestão prévia e recuperação sob demanda.

A economia precisa ser medida. Busca, armazenamento, atualização e avaliação também custam. Compare custo por resposta aceita, não apenas tokens de uma chamada.

Necessidade de filtros por fonte e versão

O vector store permite atributos usados na busca. Esses metadados podem restringir produto, categoria, região, versão ou status editorial.

Permissão exige uma camada mais rigorosa. A identidade autenticada e a política de acesso devem produzir o filtro. O texto da pergunta não concede direito de consultar outro cliente ou uma classe superior de documento.

O guia sobre filtros de metadados em RAG detalha a separação entre identidade, elegibilidade e ranking.

Respostas que precisam apontar evidência

Citações ajudam o revisor a voltar ao arquivo. Ainda assim, a aplicação deve conferir se cada afirmação material possui suporte no trecho citado. Um link correto pode acompanhar uma conclusão errada ou incompleta.

Para processos sensíveis, mantenha documento, versão, trecho e data de recuperação. A página sobre citações verificáveis em RAG mostra como avaliar a ligação entre alegação e evidência.

Compare os dois caminhos pela unidade de trabalho

Antes de escolher a tecnologia, descreva uma execução real.

Considere um agente que apoia compras:

entrada: uma proposta de fornecedor;
pergunta: quais condições divergem da solicitação aprovada;
fonte principal: a proposta anexada ao caso;
fontes de comparação: pedido, política e cadastro vigentes;
saída: divergências por campo, com referência;
decisão: comprador revisa e encaminha.

A proposta específica pode entrar como arquivo direto. A política e o catálogo de regras, reutilizados em muitos casos, podem ficar numa base pesquisável. O pedido e o cadastro talvez devam vir por API estruturada.

Essa composição evita dois excessos: indexar cada anexo temporário como conhecimento permanente e enviar toda a biblioteca junto de cada proposta.

Uma arquitetura híbrida costuma ser útil

Arquivo direto e File Search podem participar da mesma execução com responsabilidades separadas.

Um desenho prático contém:

o sistema identifica o caso e o arquivo específico;
valida tipo, tamanho, origem e autorização;
envia o arquivo como entrada da execução;
habilita busca somente nas bases permitidas para aquele caso;
recupera políticas e procedimentos vigentes;
compara o arquivo com as fontes recuperadas;
devolve divergências, citações e campos ausentes;
encaminha a saída para revisão antes de qualquer gravação.

Dados estruturados continuam em APIs, SQL ou serviços de domínio. Similaridade semântica não deve calcular imposto, confirmar saldo ou decidir alçada.

O artigo sobre banco vetorial para IA compara busca textual, vetorial, híbrida e consultas estruturadas por responsabilidade.

Confirme a ingestão antes de pesquisar

Adicionar um arquivo ao vector store é uma operação assíncrona. A documentação recomenda acompanhar o processamento até o status indicar conclusão. Consultar cedo demais pode produzir uma base parcial e uma resposta que parece definitiva.

Registre para cada arquivo:

identificador da fonte;
versão;
status de ingestão;
erro observado;
data de disponibilidade;
atributos aplicados;
responsável pelo conteúdo;
condição de substituição ou exclusão.

O agente deve informar ausência de evidência quando a fonte necessária ainda está em processamento, falhou ou ficou fora do filtro. Buscar no restante da base e preencher a lacuna por plausibilidade é uma falha de contrato.

Trate atualização e remoção como parte do produto

Uma política pode ser substituída. Um contrato termina. Uma permissão muda. Um cliente solicita remoção de conteúdo.

A operação precisa responder:

qual sistema contém o original oficial;
quanto tempo leva para uma mudança ficar pesquisável;
como a versão anterior sai da elegibilidade;
como caches e resultados derivados são invalidados;
como comprovar a exclusão das cópias controladas;
que respostas anteriores precisam de revisão.

O índice deve ser reconstruível a partir das fontes oficiais. Ele não pode se tornar a única cópia do conhecimento empresarial.

Limite a recuperação e preserve a ausência

O File Search permite limitar resultados. Um limite baixo reduz tokens e latência, mas pode retirar a evidência necessária. Um limite alto aumenta contexto e pode trazer trechos concorrentes.

Avalie com perguntas representativas:

termos exatos e códigos;
linguagem diferente da fonte;
documentos com versões próximas;
regras acompanhadas de exceção;
perguntas sem resposta;
conteúdo permitido e proibido;
fonte recém-atualizada;
conflito entre dois documentos elegíveis.

O critério de aceite deve incluir resposta vazia correta. Um agente empresarial precisa saber dizer que a base autorizada não sustenta a conclusão.

Segurança começa antes do upload

Arquivos podem conter dados pessoais, estratégia, contratos, credenciais ou instruções maliciosas dirigidas ao modelo.

Antes de usar qualquer caminho:

confirme finalidade e base de autorização;
minimize páginas, campos e documentos;
separe clientes, ambientes e classes de dados;
trate conteúdo do arquivo como dado sem autoridade para mudar regras;
mantenha credenciais fora de arquivo, prompt e log;
defina retenção e exclusão;
registre acesso e uso sem copiar conteúdo sensível em excesso;
mantenha ações externas sob permissões e validações próprias.

A escolha entre arquivo direto e busca não elimina prompt injection em agentes de IA. Um documento recuperado continua sendo entrada não confiável.

Um piloto comparável em seis passos

1. Escolha uma pergunta concreta

Exemplo: localizar obrigações de renovação em contratos aprovados e apontar o trecho correspondente.

2. Monte um conjunto seguro

Use documentos sintéticos ou autorizados. Inclua versões, cláusulas parecidas, ausência de resposta e um arquivo fora do escopo.

3. Crie duas configurações

Na primeira, envie os documentos selecionados diretamente. Na segunda, pesquise o mesmo conjunto num vector store com metadados.

4. Fixe o critério de saída

Exija obrigação, prazo, parte responsável, trecho, documento, versão e estado de revisão.

5. Meça o trabalho completo

Compare recuperação correta, citação, omissão, custo, latência, esforço de revisão, atualização e falhas de isolamento.

6. Registre a decisão

Escolha arquivo direto, File Search ou composição híbrida por classe de tarefa. Nomeie o dono e a próxima revisão. Não transforme o resultado do piloto em regra universal para todo documento da empresa.

Checklist de decisão

O sistema já conhece o arquivo correto antes da execução?
A tarefa usa um documento pontual ou um acervo recorrente?
Layout, imagem ou gráfico influenciam a análise?
O conteúdo precisa ser reutilizado entre muitas consultas?
Versão, vigência e permissão alteram a elegibilidade?
A resposta precisa citar trecho e arquivo?
A ingestão possui estado e tratamento de falha?
Atualizações e exclusões chegam ao índice e aos caches?
Perguntas sem resposta fazem parte dos testes?
O custo inclui armazenamento, busca e revisão?
Dados estruturados permanecem em fontes adequadas?
Existe um responsável pela fonte, pela recuperação e pelo resultado?

Escolha a menor arquitetura que preserva a prova

Arquivo direto atende bem casos delimitados em que a fonte já está identificada. File Search atende consultas recorrentes sobre um acervo maior, desde que ingestão, filtros, atualização e qualidade recebam operação contínua.

Muitas empresas precisam dos dois. O arquivo do caso entra diretamente. O conhecimento reutilizável fica pesquisável. Sistemas estruturados confirmam fatos e regras. A saída mostra onde cada afirmação nasceu.

A boa escolha reduz contexto desnecessário sem perder evidência. Esse é o trabalho arquitetural: dar a cada fonte um caminho compatível com sua função, seu risco e seu ciclo de vida.