Por que meu agente não está usando a base de conhecimento anexada?

4 causas comuns:

1. Arquivo ainda não processado — veja se tem ícone verde. PDFs grandes demoram. Vermelho = falha de processamento.

2. Usuário sem acesso à coleção — anexar ao agente não bypassa controle de acesso. Usuário precisa ter read na base.

3. Function calling 'native' sem instrução — em modo native, RAG não é injetado automaticamente. O modelo precisa chamar query_knowledge_files. Solução: adicione no prompt 'Sempre consulte a base usando query_knowledge_files antes de responder dúvidas sobre políticas.'

4. 'Contexto completo' em doc muito grande — documento inteiro consume toda janela. Troque para Busca focada clicando no item.

Debug rápido: peça ao agente 'Liste os documentos que você consegue acessar e cite 2 trechos aleatórios'. Se não listar nada, problema é de acesso ou ferramentas.

📖 Documentação completa na Wiki:

• RAG — Troubleshooting