> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt > Use this file to discover all available pages before exploring further. # 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 buscas semânticas. *** ## Acessando a Seção Knowledge Use o menu de navegação principal para acessar a área Knowledge. Na barra lateral, clique em **Knowledge** para abrir a tela de gerenciamento de conhecimento. ## Tela Principal do Knowledge Após acessar a seção Knowledge, você verá a tela principal listando todos os documentos e fontes de dados disponíveis. Acessando a seção Knowledge Cada card representa um documento ou entrada de conteúdo indexado na base de conhecimento, incluindo seu status e tags. *** ## 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 card do documento e selecione a opção de edição para abrir o modal de edição. Editando entrada de conhecimento *** ## Adicionando Novo Conteúdo à Base de Conhecimento Para adicionar novo conteúdo, use o botão **Add Content** disponível na tela do Knowledge. Clique em **Add Content** 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**. Botão Add Content *** ## Adicionando Conteúdo Manualmente Você pode criar entradas de conhecimento digitando o conteúdo diretamente no editor. **Passo a passo:** 1. Clique em **Add Content** na tela do Knowledge 2. No modal que abrir, selecione a aba **Manual** 3. Preencha os campos disponíveis: Adicionando conteúdo manualmente **Campos disponíveis:** * **Knowledge Base**: Selecione qual base de conhecimento será usada. Se nenhuma for selecionada, será usada a configuração padrão da conta * **Title**: Título da entrada de conhecimento (ex.: "Como configurar o sistema") * **Description**: Descrição breve do conteúdo * **Content**: 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 * **Active**: Toggle para ativar ou desativar a entrada 4. Após preencher todos os campos, clique em **Create** para salvar a entrada *** ## Adicionando Conteúdo via Upload de Arquivo Você pode fazer upload de documentos diretamente do seu computador. **Passo a passo:** 1. Clique em **Add Content** na tela do Knowledge 2. No modal que abrir, selecione a aba **Upload** 3. Arraste e solte um arquivo na área indicada ou clique em **Choose File** para selecionar um arquivo 4. O arquivo será processado e indexado automaticamente Upload de documento **Formatos suportados:** * **Documentos**: PDF, DOCX, XLSX, PPTX, HTML * **Texto**: TXT, MD, MDX * **Imagens**: PNG, JPG, JPEG, TIFF, BMP **Tamanho máximo**: 50MB *** ## Adicionando Conteúdo via URL Você também pode indexar conteúdo de uma URL pública. **Passo a passo:** 1. Clique em **Add Content** na tela do Knowledge 2. No modal que abrir, selecione a aba **URL** 3. Cole a URL da página ou documento online no campo indicado 4. Configure as opções disponíveis: Adicionando conhecimento via URL **Opções disponíveis:** * **Include Sub-pages**: Quando ativado, processa automaticamente páginas vinculadas * **Max Pages**: Limite de páginas para processar (1-50). Útil para controlar quantas páginas serão indexadas 5. Clique em **Process URL** para iniciar o processamento e adicionar o conteúdo à base de conhecimento *** ## Testando a Busca de Conhecimento Após adicionar conteúdo, você pode testar como o agente recuperará informações. Use esta funcionalidade para validar resultados de busca semântica com base em consultas e tags. **Configurações de teste:** * **Search Query**: Consulta de busca para testar * **Knowledge Base**: Seleciona qual base de conhecimento usar * **Tags**: Filtro opcional por tags * **Maximum Results**: Número máximo de resultados retornados Teste de busca de conhecimento *** ## Configurações da Base de Conhecimento Você pode configurar 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. Configurações do Knowledge *** ## 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:** * **Provider**: Seleciona o provedor (Pinecone, Qdrant, etc.) * **Name**: Nome da configuração * **Active**: Toggle para ativar/desativar * **Default**: Define como configuração padrão **Configurações do Pinecone:** * **API Key**: Chave de API do Pinecone * **Environment**: Ambiente do Pinecone (ex.: us-east-1-aws) * **Index Name (Knowledge)**: Nome do índice usado para conhecimento * **Index Name (Memory)**: Nome do índice usado para memória do agente * **Dimension**: Dimensão dos vetores (ex.: 1536) * **Metric**: Métrica de busca (Cosine, Euclidean, DotProduct) **Configurações de Busca:** * **Default Search Type**: Tipo de busca padrão (Hybrid, Vector, Text) * **Hybrid Alpha**: Controle do equilíbrio entre busca textual e semântica (0.0 = apenas texto, 1.0 = apenas semântica) **Configurações de Conexão:** * **Pool Threads**: Número de threads do pool * **Connection Pool Max Size**: Tamanho máximo do pool de conexões Preencha os detalhes do provedor, chaves de API, nomes de índices e configurações de busca, depois salve a configuração. Nova configuração de conhecimento *** ## Considerações Finais A Base de Conhecimento é essencial para permitir que os agentes respondam perguntas com base em seus documentos e dados. Sempre certifique-se de que o conteúdo está adequadamente indexado e testado antes de usá-lo em agentes de produção. **Dicas importantes:** * Teste sempre a busca semântica após adicionar novo conteúdo * Use tags para organizar e filtrar o conhecimento * Configure adequadamente os provedores para melhor performance * Mantenha o conteúdo atualizado e relevante * Use a funcionalidade de teste antes de ativar agentes em produção *** ## Alternativa: Knowledge Nexus (a partir do v1.0.0-rc3) Para times que mantêm uma base de conhecimento separada do CRM (wiki, docs vivos, conteúdo evoluindo continuamente), a partir do `v1.0.0-rc3` é possível vincular **Knowledge Nexus spaces** ao agente. A integração é complementar à Base de Conhecimento embutida — você pode usar os dois ao mesmo tempo no mesmo agente. Quando usar Nexus em vez (ou junto) da KB do CRM: * Sua organização já mantém base centralizada. * Conteúdo evolui frequentemente. * Múltiplos times consomem a mesma base. Para o passo a passo, ver [Integração com Knowledge Nexus](/user-guides/agents/knowledge-nexus). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.