Base de Conhecimento
A Base de Conhecimento permite que você faça upload de documentos para alimentar seus agentes com informações específicas do seu negócio. O sistema utiliza RAG (Retrieval Augmented Generation) para buscar contexto relevante durante as conversas.Como Funciona?
Upload
Envie documentos em diversos formatos (PDF, Word, Excel, etc.)
Processamento
O sistema extrai o conteúdo e divide em chunks otimizados
Embeddings
Cada chunk é convertido em vetor para busca semântica
Busca Inteligente
Durante a conversa, o agente busca trechos relevantes automaticamente
Fluxo de Processamento
1
Upload do Arquivo
Você envia um documento através da interface ou API
2
Extração de Conteúdo
O sistema extrai automaticamente o texto do documento
3
Divisão em Chunks
O conteúdo é dividido em trechos menores para melhor precisão na busca
4
Geração de Embeddings
Cada chunk é convertido em vetor usando modelo de embedding
5
Armazenamento
Os vetores são salvos no banco de dados vetorial (Qdrant)
6
Pronto para Uso
Vincule o documento aos agentes que devem acessá-lo
Formatos Suportados
O sistema aceita uma ampla variedade de formatos de arquivo:- Documentos
- Planilhas
- Apresentações
- Web & Texto
- Outros
| Formato | Extensão | Descrição |
|---|---|---|
.pdf | Documentos PDF (mais comum) | |
| Word | .docx, .doc | Microsoft Word |
| OpenDocument | .odt | LibreOffice/OpenOffice Writer |
| Rich Text | .rtf | Formato de texto rico |
Acessando a Página de Documentos
1
Acesse o Dashboard
Faça login em app.tropicall.ai
2
Navegue para Documentos
No menu lateral, clique em Documentos ou Base de Conhecimento
3
Visualize seus documentos
A página exibe cards de estatísticas e a lista de documentos enviados
Interface da Página
A página de Documentos oferece:-
Cards de Estatísticas:
- Total de documentos
- Tamanho total ocupado
- Total de chunks processados
- Campo de Busca: Pesquise documentos por nome
-
Grid de Cards: Visualize todos os seus documentos com:
- Ícone do tipo de arquivo
- Nome do arquivo
- Preview do conteúdo
- Tamanho e quantidade de chunks
- Data de upload
Fazendo Upload de Documentos
1
Clique em Novo Documento
No canto superior direito da página, clique no botão Novo Documento
2
Selecione o Arquivo
Você pode:
- Arrastar e soltar o arquivo na área indicada
- Clicar na área para abrir o seletor de arquivos
3
Verifique o Arquivo
O sistema mostra:
- Nome do arquivo selecionado
- Tamanho do arquivo
- Ícone do tipo
4
Envie o Documento
Clique em Enviar para iniciar o upload e processamento
5
Aguarde o Processamento
O sistema irá:
- Enviar o arquivo
- Extrair o conteúdo
- Gerar embeddings
- Confirmar com quantidade de chunks criados
Status do Upload
Durante o processo, você verá indicadores de status:| Status | Descrição |
|---|---|
| Enviando | Arquivo sendo transferido para o servidor |
| Processando | Extração de conteúdo e geração de embeddings |
| Concluído | Documento pronto para uso |
| Erro | Falha no processamento (verifique o formato/tamanho) |
Vinculando Documentos a Agentes
Após fazer upload, você precisa vincular os documentos aos agentes que devem acessá-los:1
Acesse o Agente
Vá para a página Agentes e clique no agente desejado
2
Localize a Seção Base de Conhecimento
Role até encontrar a seção Base de Conhecimento
3
Clique em Adicionar Documento
Clique no botão Adicionar Documento
4
Selecione o Documento
Na lista de documentos disponíveis:
- Use a busca para encontrar rapidamente
- Clique em Vincular ao lado do documento desejado
Desvinculando Documentos
Para remover um documento de um agente:- Acesse a página do agente
- Na seção Base de Conhecimento, localize o documento
- Clique no ícone de lixeira
- Confirme a desvinculação
Como o RAG Funciona na Prática
Durante uma conversa, quando o usuário faz uma pergunta:Parâmetros do RAG
| Parâmetro | Valor Padrão | Descrição |
|---|---|---|
top_k | 3 | Número máximo de chunks retornados |
score_threshold | 0.7 | Similaridade mínima (0-1) |
max_context_length | 2000 | Tamanho máximo do contexto em caracteres |
Gerenciando Documentos
Visualizar Detalhes
Clique em um documento para ver:- Nome completo do arquivo
- Preview do conteúdo extraído
- Tamanho do arquivo
- Quantidade de chunks
- Data de upload
- Agentes que utilizam o documento
Excluir Documento
1
Localize o Documento
Na página de Documentos, encontre o documento que deseja excluir
2
Abra o Menu
Clique no menu de três pontos (⋮) no card do documento
3
Selecione Excluir
Clique em Excluir
4
Confirme
Leia o aviso e confirme a exclusão
Boas Práticas
Organize por Tema
Nomeie seus arquivos de forma descritiva para facilitar a busca e organização.
Mantenha Atualizado
Substitua documentos desatualizados por versões novas para manter a precisão.
Seja Específico
Documentos focados em um tema geram respostas mais precisas do que documentos genéricos.
Vincule com Propósito
Vincule apenas documentos relevantes a cada agente para evitar contextos confusos.
Dicas para Melhor Performance
- Prefira PDFs bem formatados: Documentos com boa estrutura são extraídos com maior precisão
- Evite imagens como texto: O sistema não faz OCR em imagens dentro de PDFs
- Divida documentos muito grandes: Documentos com mais de 50 páginas podem ser divididos por capítulo/seção
- Use títulos e subtítulos: Documentos bem estruturados geram chunks mais coerentes
Resolução de Problemas
| Problema | Causa Provável | Solução |
|---|---|---|
| Upload falha | Arquivo muito grande | Reduza para menos de 10MB |
| Upload falha | Formato não suportado | Use um dos formatos listados |
| Poucos chunks criados | Documento com pouco texto | Normal para documentos pequenos |
| Agente não encontra informação | Documento não vinculado | Vincule o documento ao agente |
| Resposta imprecisa | Similaridade baixa | Reformule a pergunta ou melhore o documento |
| Documento não aparece | Processamento em andamento | Aguarde alguns segundos e atualize |
Limites e Cotas
| Recurso | Limite |
|---|---|
| Tamanho máximo por arquivo | 10 MB |
| Formatos suportados | 20+ formatos |
| Documentos por conta | Conforme plano |
| Chunks por documento | Ilimitado |