Base de Conhecimento
A base de conhecimento é o conjunto de informações que a Dani consulta para responder perguntas específicas do seu negócio. Pense nela como a "memória técnica" do agente: tabela de preços, FAQ, políticas, manuais.
Salve o agente antes de adicionar itens
A aba Base de conhecimento só fica disponível após o agente ser salvo pela primeira vez. Crie o agente, salve, reabra e depois adicione os itens.
Acessando a base de conhecimento
- Acesse Agentes IA e abra o agente desejado (ícone de lápis)
- Clique na aba Base de conhecimento (sexta aba)
Tipos de itens suportados
| Tipo | Ícone | Como adicionar |
|---|---|---|
| Texto livre | Clipboardcopy | Pelo botão "+ Adicionar" → tipo "Texto" |
| URL | Link | Pelo botão "+ Adicionar" → tipo "URL" |
| Documento | Pelo botão "Upload" | |
| DOC / DOCX | Texto | Pelo botão "Upload" |
| TXT | Texto | Pelo botão "Upload" |
| MP3 / WAV (áudio) | Áudio | Pelo botão "Upload" |
| MP4 / AVI / MOV (vídeo) | Vídeo | Pelo botão "Upload" |
Adicionando texto ou URL
- Clique em "+ Adicionar"
- No campo Nome, dê um título descritivo (ex: "Tabela de preços 2025", "FAQ de suporte")
- No seletor Tipo, escolha "Texto" ou "URL"
- Preencha o campo de conteúdo:
- Texto: cole ou digite o conteúdo diretamente
- URL: informe o endereço completo (ex:
https://meusite.com/faq)
- Clique em "Salvar"
Fazendo upload de arquivo
- Clique em "Upload"
- Selecione o arquivo no seu computador (formatos aceitos:
.pdf,.doc,.docx,.txt,.mp3,.wav,.mp4,.avi,.mov) - O sistema processa o arquivo automaticamente e o adiciona à lista
Sobre arquivos grandes
Arquivos pesados podem levar alguns segundos para processar. Aguarde o toast de confirmação antes de fechar o painel.
Gerenciando os itens
Cada item da lista tem:
- Toggle liga/desliga: desativa temporariamente um item sem excluir. Itens desativados (opacidade reduzida) não são consultados pela Dani
- Botão lixeira: exclui o item permanentemente (pede confirmação)
- Indicador de tipo: ícone e texto mostrando o tipo e um trecho do conteúdo
Como a Dani usa a base de conhecimento
Quando um cliente faz uma pergunta, o sistema busca os trechos mais relevantes da base de conhecimento e os inclui automaticamente no contexto enviado ao modelo de IA. O agente então responde com base nesse contexto.
Esse processo é chamado de RAG (Retrieval-Augmented Generation). O número de trechos considerados por consulta é controlado internamente (campo ragTopK nas configurações avançadas do backend).
Boas práticas para a base de conhecimento
- Use nomes descritivos nos itens — o sistema usa o nome para indexar o conteúdo
- Divida temas em itens separados — um item por assunto facilita a recuperação
- Prefira texto puro a PDFs complexos com tabelas e imagens — o texto extraído de PDFs pode perder formatação
- Revise o conteúdo regularmente — preços, políticas e horários mudam; itens desatualizados geram respostas erradas
- Desative, não exclua — se um item for sazonal (promoção de natal, por exemplo), desative e reative quando necessário
Problemas comuns
"Salve o prompt primeiro antes de criar itens" O agente ainda não foi salvo. Feche o painel, clique em "Salvar" na aba anterior e reabra.
Upload não aparece na lista Aguarde alguns segundos e clique em outra aba e volte para recarregar. Arquivos grandes podem demorar.
A Dani não usa as informações da base Verifique se o item está com o toggle ativo (não opaco). Se estiver ativo e o agente ainda ignora, revise se o prompt principal não está contradizendo a base de conhecimento.