Base de Conhecimento
A seção Base de conhecimento permite gerenciar documentos e dados que serão usados para treinar e enriquecer seus agentes de IA. Nesta seção, você pode fazer upload de arquivos, adicionar conteúdo manualmente, indexar URLs, configurar provedores e testar pesquisas semânticas.Acessando a Seção de Conhecimento
Utilize o menu de navegação principal para acessar a área de Conhecimento. Na barra lateral, clique em Conhecimento para abrir a tela de gerenciamento de conhecimento.Tela principal do conhecimento
Após acessar a seção Conhecimento, você verá a tela principal listando todos os documentos e fontes de dados disponíveis.
Editando uma entrada de conhecimento existente
Você pode editar um documento existente para atualizar seu título, descrição ou conteúdo. Clique no menu de três pontos no cartão do documento e selecione a opção de edição para abrir o modal de edição.
Adicionando novo conteúdo à base de conhecimento
Para adicionar novo conteúdo, use o botão Adicionar Conteúdo disponível na tela Knowledge. Clique em Adicionar conteúdo para abrir o modal de criação de conteúdo. O modal oferece três métodos diferentes para adicionar conhecimento: Manual, Upload e URL.
Adicionando conteúdo manualmente
Você pode criar entradas de conhecimento digitando o conteúdo diretamente no editor. Passo a passo:- Clique em Adicionar conteúdo na tela Knowledge
- No modal que se abre, selecione a aba Manual
- Preencha os campos disponíveis:
- Base de Conhecimento: Selecione qual base de conhecimento será utilizada. Se nenhuma for selecionada, a configuração padrão da conta será usada
- Título: Título da entrada de conhecimento (por exemplo, “Como configurar o sistema”)
- Descrição: Breve descrição do conteúdo
- Conteúdo: Conteúdo completo em formato de texto. Você pode usar Markdown para formatação
- Tags: Tags para categorização e filtragem. Digite uma tag e pressione Enter para adicionar
- Ativo: alterne para ativar ou desativar a entrada
- Após preencher todos os campos, clique em Criar para salvar a entrada
Adicionando conteúdo via upload de arquivo
Você pode fazer upload de documentos diretamente do seu computador. Passo a passo:- Clique em Adicionar conteúdo na tela Knowledge
- No modal que se abre, selecione a aba Upload
- Arraste e solte um arquivo na área indicada ou clique em Escolher arquivo para selecionar um arquivo
- O arquivo será processado e indexado automaticamente
- Documentos: PDF, DOCX, XLSX, PPTX, HTML
- Texto: TXT, MD, MDX
- Imagens: PNG, JPG, JPEG, TIFF, BMP
Adicionando conteúdo via URL
Você também pode indexar conteúdo de um URL público. Passo a passo:- Clique em Adicionar conteúdo na tela Knowledge
- No modal que se abre, selecione a aba URL
- Cole o URL da página ou documento online no campo indicado
- Configure as opções disponíveis:
- Incluir subpáginas: quando ativado, processa automaticamente as páginas vinculadas
- Máximo de páginas: Limite de páginas para processar (1-50). Útil para controlar quantas páginas serão indexadas
- Clique em Process URL para iniciar o processamento e adicionar o conteúdo à base de conhecimento
Testando a pesquisa de conhecimento
Depois de adicionar conteúdo, você pode testar como o agente recuperará as informações. Use esta funcionalidade para validar resultados de pesquisa semântica com base em consultas e tags. Configurações de teste:- Consulta de pesquisa: consulta de pesquisa para testar
- Base de conhecimento: selecione qual base de conhecimento usar
- Tags: filtro de tags opcional
- Resultados Máximos: Número máximo de resultados retornados
Configurações da base de conhecimento
Você pode definir provedores e configurações de indexação para a base de conhecimento. Nesta tela você pode gerenciar provedores como Pinecone ou Qdrant e controlar a ativação.
Criando uma nova configuração de conhecimento
Você pode criar uma nova configuração de provedor para a base de conhecimento. Configurações disponíveis:- Provedor: Selecione o provedor (Pinecone, Qdrant, etc.)
- Nome: Nome da configuração
- Ativo: alterne para ativar/desativar
- Padrão: Definir como configuração padrão
- Chave API: Chave Pinha API
- Ambiente: ambiente Pinecone (por exemplo, us-east-1-aws)
- Nome do Índice (Conhecimento): Nome do índice usado para conhecimento
- Nome do Índice (Memória): Nome do índice usado para memória do agente
- Dimensão: Dimensão vetorial (por exemplo, 1536)
- Métrica: métrica de pesquisa (Cosseno, Euclidiano, DotProduct)
- Tipo de pesquisa padrão: Tipo de pesquisa padrão (híbrido, vetorial, texto)
- Alfa Híbrido: Controle do equilíbrio entre busca textual e semântica (0,0 = somente texto, 1,0 = somente semântica)
- Threads do Pool: Número de threads do pool
- Tamanho máximo do pool de conexões: tamanho máximo do pool de conexões
Considerações Finais
A Base de Conhecimento é essencial para permitir que os agentes respondam perguntas com base em seus documentos e dados. Certifique-se sempre de que o conteúdo esteja devidamente indexado e testado antes de usá-lo em agentes de produção. Dicas importantes:- Sempre teste a pesquisa semântica após adicionar novo conteúdo
- Use tags para organizar e filtrar conhecimento
- Configure provedores adequadamente para melhor desempenho
- Mantenha o conteúdo atualizado e relevante
- Use a funcionalidade de teste antes de ativar agentes em produção
Alternativa: Knowledge Nexus (começando em v1.0.0-rc3)
Para equipes que mantêm uma base de conhecimento separada do CRM (wiki, live docs, conteúdo em evolução contínua), a partir dev1.0.0-rc3 é possível vincular espaços Knowledge Nexus ao agente. A integração é complementar à Base de Conhecimento integrada — você pode usar ambas no mesmo agente.
Quando usar o Nexus em vez (ou junto) da KB do CRM:
- Sua organização já mantém uma base centralizada.
- O conteúdo evolui com frequência.
- Várias equipes consomem a mesma base.