A seção Conhecimento tem três coisas diferentes, e a diferença importa muito.
As três, e quando usar cada uma
| Texto | Arquivos | Mídias | |
|---|---|---|---|
| O que é | Regras e informações curtas — "O que ele precisa saber sempre" | Documentos que ele consulta | Anexos que ele envia |
| Como funciona | Vai inteiro no prompt, toda mensagem | Vira busca: ele recupera só o trecho relevante | Ele escolhe quando mandar, pela descrição |
| Bom para | Regra de desconto, horário, o que nunca dizer | Manual, tabela de preços, contrato, política | Catálogo em PDF, foto de ambiente, vídeo |
| Cuidado | É caro e some no meio de um prompt grande | Precisa de texto selecionável | A descrição é obrigatória |
A regra curta: o que é curto e vale sempre vai no texto. O que é longo e vale às vezes vai em arquivo.
A descrição da mídia é o que ele lê
Ela não é enfeite: é por ela que o agente decide quando mandar aquele arquivo. Uma mídia chamada
catalogo.pdf sem descrição nunca é enviada, porque ele não sabe o que tem dentro.
"Pronto" com zero trechos indexados
É o caso que engana: o arquivo subiu, foi processado, e mesmo assim o agente não vai achar nada nele.
Acontece com PDF que é só imagem — um documento digitalizado, sem texto selecionável. A tela mostra os dois números (processado e quantos trechos foram indexados) exatamente para você ver isso.
A saída é subir uma versão em texto do mesmo documento.
Erros comuns
"O agente não sabe uma coisa que está no arquivo." — confira os trechos indexados. Zero quer dizer que o texto não foi extraído.
"O agente fala de um preço antigo." — o arquivo antigo continua na base. Remova antes de subir o novo, senão os dois são consultados.
"O agente inventou." — informação que não está na base nem na persona sai do modelo. Escreva a regra no texto curto: "Nunca informe prazo de entrega; diga que o time confirma."