> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evo-ai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Base

> Crie e gerencie bases de conhecimento para que seus agentes tenham acesso a informações específicas da sua organização

## Visão Geral

A **Knowledge Base** (Base de Conhecimento) é onde você armazena e organiza informações específicas da sua empresa, produtos, processos ou qualquer conteúdo que seus agentes precisam saber. É como criar uma "biblioteca digital" que seus agentes podem consultar para dar respostas mais precisas e atualizadas.

**Por que usar Knowledge Base?**

* 🎯 **Respostas específicas**: Seus agentes usam informações da sua empresa, não apenas conhecimento geral
* 📚 **Informações atualizadas**: Mantenha dados sempre atuais sobre produtos, políticas, processos
* 🔍 **Busca inteligente**: Sistema encontra automaticamente informações relevantes para cada pergunta
* 🏷️ **Organização com tags**: Filtre e organize conteúdo por categorias específicas

<Note>
  **O que são "chunks"?** Quando você adiciona um documento, o sistema divide o conteúdo em pequenos pedaços chamados "chunks" (como páginas de um livro). Isso permite que o agente encontre exatamente a informação relevante sem ter que "ler" o documento inteiro a cada pergunta.
</Note>

## Como Criar sua Knowledge Base

### Passo 1: Acessar Knowledge Base

<AccordionGroup>
  <Accordion icon="book" title="Navegar para Knowledge">
    1. No menu principal da Evo AI, clique em **"Knowledge"**
    2. Você verá a lista de todas as bases de conhecimento existentes
    3. Clique em **"Add Knowledge"** para criar uma nova base

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/knowledge01_list.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=ecbe45f46a56c4f87574e9968f37c1f1" alt="Lista de Knowledge Bases" width="2458" height="1425" data-path="images/prints/knowledge01_list.png" />

    <Info>
      Você pode criar múltiplas bases de conhecimento para organizar informações por área: vendas, suporte, produtos, etc.
    </Info>
  </Accordion>
</AccordionGroup>

### Passo 2: Escolher Tipo de Conteúdo

Existem três formas de adicionar informações à sua knowledge base:

<AccordionGroup>
  <Accordion icon="keyboard" title="1. Entrada Manual (Texto)">
    **Ideal para:** Políticas, procedimentos, FAQs, informações específicas

    1. Selecione **"Manual Text Entry"**
    2. **Nome:** Dê um título descritivo (ex: "Política de Trocas")
    3. **Conteúdo:** Digite ou cole o texto diretamente
    4. **Tags:** Adicione palavras-chave para organizar (ex: "vendas", "política", "trocas")

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/knowledge03_form_manual.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=96d1a89795beeb13944330f20f44f89a" alt="Formulário de Entrada Manual" width="1583" height="1209" data-path="images/prints/knowledge03_form_manual.png" />

    **Exemplo prático:**

    ```markdown theme={null}
    Nome: Política de Garantia de Notebooks

    Conteúdo: 
    Nossos notebooks têm garantia de 12 meses para defeitos de fabricação.
    A garantia cobre: problemas de tela, teclado, bateria e componentes internos.
    Não cobre: danos físicos, quedas, líquidos ou mau uso.
    Para ativar, cliente deve apresentar nota fiscal e preencher cadastro.

    Tags: garantia, notebook, política, suporte
    ```
  </Accordion>

  <Accordion icon="file" title="2. Upload de Arquivos">
    **Formatos suportados:**

    **📄 Documentos:**

    * PDF, DOCX, XLSX, PPTX, HTML

    **📝 Texto:**

    * TXT, MD, MDX

    **🖼️ Imagens:**

    * PNG, JPG, JPEG, TIFF, BMP

    **Limite máximo:** 50MB por arquivo

    **Como fazer:**

    1. Selecione **"File Upload"**
    2. **Arraste e solte** o arquivo ou clique para selecionar
    3. **Nome:** O sistema sugere automaticamente, mas você pode alterar
    4. **Aguarde o processamento** - o sistema extrai texto e cria chunks automaticamente
    5. **Revise as tags** geradas automaticamente

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/knowledge04_form_file.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=11c939f9f194d0195529b7ad16751748" alt="Formulário de Upload de Arquivo" width="1594" height="1105" data-path="images/prints/knowledge04_form_file.png" />

    **Dica:** Para PDFs grandes, o sistema divide em chunks menores. Por exemplo, um manual de 50 páginas vira cerca de 20-30 chunks temáticos.
  </Accordion>

  <Accordion icon="globe" title="3. Processamento via URL">
    **Ideal para:** Sites, documentações online, artigos web

    **Funcionalidades:**

    * **URL simples:** Processa uma página específica
    * **Sub-páginas automáticas:** Descobre e processa páginas vinculadas do mesmo domínio

    **Como configurar:**

    1. Selecione **"URL Processing"**
    2. **URL:** Cole o link da página ou documento online
    3. **Include Sub-pages:** ✅ Marque para processar páginas relacionadas
    4. **Máximo de sub-páginas:** Defina limite (recomendado: 10-50 dependendo do site)
    5. **Aguarde processamento** - pode levar alguns minutos para sites grandes

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/knowledge05_form_url.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=7f369b1e06830e5dcb951948a2d1944a" alt="Formulário de Processamento de URL" width="1590" height="1026" data-path="images/prints/knowledge05_form_url.png" />

    **Exemplo prático:**

    ```
    URL: https://empresa.com/documentacao/produtos
    Include Sub-pages: ✅ Sim
    Max Sub-pages: 25

    Resultado: Sistema processa página principal + até 25 páginas relacionadas
    automaticamente (ex: /produtos/notebook, /produtos/smartphone, etc.)
    ```

    **Vantagens:**

    * Atualização automática de conteúdo web
    * Captura estrutura completa de documentações
    * Economiza tempo vs. fazer upload manual
  </Accordion>
</AccordionGroup>

### Passo 3: Tags e Metadados Automáticos

<AccordionGroup>
  <Accordion icon="tags" title="Sistema de Tags Automáticas">
    **Como funciona:**

    * O sistema **analisa o conteúdo** usando IA
    * **Gera tags automaticamente** baseado nos temas principais
    * **Você pode editar, adicionar ou remover** tags conforme necessário
    * **Tags ajudam na busca** e filtros por agentes

    **Exemplos de tags automáticas:**

    ```
    Documento: "Manual do iPhone 15"
    Tags geradas: smartphone, apple, iphone, manual, configuração, uso

    Documento: "Política de RH - Férias"  
    Tags geradas: rh, férias, política, colaboradores, direitos

    Documento: "Relatório Financeiro Q3"
    Tags geradas: financeiro, relatório, Q3, receita, despesas, lucro
    ```

    **Como personalizar:**

    * ✅ **Mantenha tags relevantes** que facilitam busca
    * ➕ **Adicione tags específicas** do seu negócio
    * ❌ **Remova tags genéricas** que não agregam valor
    * 🎯 **Use tags consistentes** entre documentos similares
  </Accordion>

  <Accordion icon="database" title="Metadados dos Chunks">
    **O que são metadados?**

    * Informações extras sobre cada chunk (pedaço de conteúdo)
    * Incluem: fonte, data, tipo de arquivo, tamanho, relevância
    * Ajudam o sistema a encontrar informações mais precisas

    **Metadados automáticos gerados:**

    ```
    Chunk 1 - Manual iPhone (Pág. 1-2):
    - Fonte: manual_iphone_15.pdf
    - Tamanho: 1.2kb
    - Temas: configuração inicial, primeiro uso
    - Relevância: alta para "como configurar"

    Chunk 2 - Manual iPhone (Pág. 10-12):
    - Fonte: manual_iphone_15.pdf  
    - Tamanho: 0.8kb
    - Temas: câmera, fotos, vídeos
    - Relevância: alta para "tirar fotos"
    ```

    **Como o sistema usa:**

    * **Busca contextual:** Encontra chunk mais relevante para cada pergunta
    * **Filtragem inteligente:** Evita informações desnecessárias
    * **Rankeamento:** Prioriza chunks mais úteis para a resposta
  </Accordion>
</AccordionGroup>

## Testando sua Knowledge Base

### Busca e Verificação

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="Como testar se está funcionando">
    **Aba Search:**

    1. Após criar conteúdo, vá para aba **"Search"** na Knowledge Base
    2. **Digite uma pergunta** relacionada ao conteúdo que você adicionou
    3. **Veja os resultados:** Sistema mostra chunks mais relevantes
    4. **Verifique relevância:** Os resultados fazem sentido para sua pergunta?

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/knowledge02_search.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=0a747a9bece8416d358e589c28bcfaae" alt="Busca na Knowledge Base" width="2471" height="1161" data-path="images/prints/knowledge02_search.png" />

    **Exemplo de teste:**

    ```
    Conteúdo adicionado: Manual de garantia de notebooks

    Pergunta teste: "Quanto tempo dura a garantia do notebook?"

    Resultado esperado: Chunk com informação "12 meses de garantia"

    Se não aparecer: Verifique se tags incluem "garantia" e "notebook"
    ```
  </Accordion>

  <Accordion icon="chart-line" title="Melhorando a qualidade da busca">
    **Se busca não está boa:**

    **1. Refine as tags:**

    * Adicione sinônimos: "garantia" + "cobertura" + "proteção"
    * Use termos que clientes realmente falam
    * Evite tags muito técnicas

    **2. Melhore o conteúdo:**

    * Use linguagem clara e direta
    * Inclua perguntas comuns no texto
    * Adicione contexto suficiente em cada chunk

    **3. Teste diferentes perguntas:**

    * Pergunta formal: "Qual é o período de garantia?"
    * Pergunta casual: "Por quanto tempo o notebook tem garantia?"
    * Pergunta específica: "Notebook com defeito, garantia cobre?"

    **4. Ajuste chunks grandes:**

    * Se chunk é muito longo, divida em temas menores
    * Se muito pequeno, pode faltar contexto
    * Ideal: 200-500 palavras por chunk
  </Accordion>
</AccordionGroup>

## Usando Knowledge Base com Agentes LLM

### Configuração no Agente

<AccordionGroup>
  <Accordion icon="robot" title="Ativando Load Knowledge">
    **Como conectar Knowledge Base ao seu agente:**

    1. **Abra configurações** do seu agente LLM
    2. **Seção Agent Settings:** Encontre a opção **"Load Knowledge"**
    3. **✅ Ative Load Knowledge:** Marca a checkbox
    4. **Configure filtros de tags (opcional):** Selecione tags específicas
    5. **Salve as configurações**

    **O que acontece quando ativo:**

    * Agente recebe automaticamente uma ferramenta chamada `load_knowledge`
    * Pode buscar informações na Knowledge Base quando necessário
    * Usa tags para filtrar conteúdo relevante
    * Integra conhecimento específico nas respostas

    **Configuração de tags:**

    ```
    Agente de Vendas:
    Tags selecionadas: vendas, produtos, preços, garantia
    → Acessa apenas conteúdo relacionado a vendas

    Agente de Suporte:  
    Tags selecionadas: suporte, problemas, soluções, tutoriais
    → Acessa apenas conteúdo de suporte técnico

    Agente Geral:
    Sem tags especificadas
    → Acessa toda a Knowledge Base
    ```
  </Accordion>

  <Accordion icon="gear" title="Como funciona na prática">
    **Fluxo automático:**

    1. **Cliente faz pergunta:** "Qual garantia do notebook X?"
    2. **Agente analisa:** Identifica que precisa de informação específica
    3. **Busca automática:** Usa tool `load_knowledge` para encontrar resposta
    4. **Filtra por tags:** Se configurado, busca apenas em conteúdo relevante
    5. **Integra na resposta:** Combina conhecimento encontrado com raciocínio do LLM
    6. **Resposta final:** Cliente recebe informação precisa e atualizada

    **Exemplo prático:**

    ```
    Cliente: "Meu notebook quebrou, tenho garantia?"

    Agente:
    1. 🔍 Busca automática na Knowledge Base
    2. 📄 Encontra: "Garantia 12 meses para defeitos de fabricação"
    3. 🤖 Processa com LLM: Analisa situação + política
    4. 💬 Resposta: "Sim! Seus notebooks têm garantia de 12 meses para 
       defeitos de fabricação. Para usar a garantia, você precisará da 
       nota fiscal e preenchimento do cadastro. Que tipo de problema 
       está acontecendo?"
    ```

    **Vantagens:**

    * ✅ **Informações sempre atualizadas**
    * ✅ **Consistência entre agentes**
    * ✅ **Respostas baseadas em dados reais**
    * ✅ **Reduz "alucinações" do AI**
  </Accordion>

  <Accordion icon="filter" title="Estratégias de filtros por tags">
    **Por que usar filtros:**

    * Evita informação irrelevante nas respostas
    * Melhora velocidade de busca
    * Reduz confusão entre diferentes áreas
    * Permite especialização de agentes

    **Estratégias recomendadas:**

    **1. Por departamento:**

    ```
    Agente Vendas: vendas, produtos, preços, promoções
    Agente RH: rh, colaboradores, políticas, benefícios  
    Agente TI: ti, sistemas, senhas, problemas-técnicos
    ```

    **2. Por tipo de cliente:**

    ```
    Agente B2B: empresas, corporativo, volumes, contratos
    Agente B2C: consumidor, varejo, individual, simples
    ```

    **3. Por produto:**

    ```
    Agente Notebooks: notebook, laptop, computador, hardware
    Agente Smartphones: celular, smartphone, móvel, apps
    ```

    **4. Sem filtro (agente geral):**

    ```
    Agente Supervisor: Sem tags - acesso completo
    Agente Triagem: Sem tags - pode direcionar para especialistas
    ```
  </Accordion>
</AccordionGroup>

## Organizando sua Knowledge Base

### Boas Práticas

<AccordionGroup>
  <Accordion icon="sitemap" title="Estrutura organizacional">
    **Como organizar múltiplas knowledge bases:**

    **Por área de negócio:**

    ```
    📚 KB Vendas
    - Catálogo de produtos
    - Políticas de preço
    - Scripts de vendas
    - Objeções comuns

    📚 KB Suporte  
    - Manuais técnicos
    - Troubleshooting
    - FAQs
    - Procedimentos

    📚 KB RH
    - Políticas internas
    - Benefícios
    - Procedimentos
    - Cultura empresa
    ```

    **Por tipo de conteúdo:**

    ```
    📚 KB Documentos Oficiais
    - Contratos padrão
    - Políticas corporativas
    - Procedimentos legais

    📚 KB Conhecimento Prático
    - Tutoriais
    - Cases de sucesso
    - Dicas e truques
    ```

    **Agentes especializados acessam KBs específicas para máxima eficiência.**
  </Accordion>

  <Accordion icon="arrows-rotate" title="Mantendo conteúdo atualizado">
    **Estratégias de manutenção:**

    **1. Revisão periódica:**

    * Defina cronograma (mensal/trimestral)
    * Verifique informações desatualizadas
    * Atualize preços, políticas, produtos
    * Remova conteúdo obsoleto

    **2. Controle de versão:**

    * Use nomes descritivos com datas
    * "Catálogo\_Produtos\_2024\_Q1"
    * "Política\_Garantia\_v2\_Janeiro2024"

    **3. URLs automáticas:**

    * Para sites que mudam frequentemente
    * Configure reprocessamento automático
    * Monitore se URLs ainda estão ativas

    **4. Responsáveis por área:**

    * Vendas: Atualiza produtos e preços
    * RH: Atualiza políticas internas
    * Suporte: Atualiza procedimentos técnicos
  </Accordion>

  <Accordion icon="tags" title="Sistema de tags eficaz">
    **Padronização de tags:**

    **Use categorias consistentes:**

    ```
    Por área: vendas, suporte, rh, financeiro, marketing
    Por produto: notebook, smartphone, tablet, acessório
    Por tipo: política, manual, tutorial, faq, procedimento
    Por urgência: crítico, importante, normal, informativo
    ```

    **Convenções recomendadas:**

    * **Minúsculas:** vendas, não Vendas
    * **Hífen para compostas:** problema-técnico, não problema técnico
    * **Consistência:** sempre "smartphone", nunca misturar com "celular"
    * **Hierarquia:** produto > produto-notebook > produto-notebook-gaming

    **Exemplos práticos:**

    ```
    Documento: "Como trocar tela do iPhone"
    Tags: suporte, smartphone, iphone, reparo, tela, tutorial

    Documento: "Tabela de preços notebooks gaming"  
    Tags: vendas, notebook, gaming, preços, tabela, 2024
    ```
  </Accordion>
</AccordionGroup>

## Casos de Uso Comuns

<CardGroup cols={2}>
  <Card title="E-commerce" icon="cart-shopping">
    **Knowledge Base para loja online:**

    * Catálogo completo de produtos
    * Políticas de troca/devolução
    * Guias de tamanho
    * FAQs de entrega

    **Agentes beneficiados:**

    * Vendas: Recomendações precisas
    * Suporte: Resolução rápida
    * Pós-venda: Políticas atualizadas
  </Card>

  <Card title="SaaS/Software" icon="code">
    **Knowledge Base para software:**

    * Documentação técnica
    * Tutoriais de uso
    * Troubleshooting comum
    * Changelog e atualizações

    **Agentes beneficiados:**

    * Suporte: Soluções técnicas
    * Onboarding: Guias de setup
    * Vendas: Features e benefícios
  </Card>

  <Card title="Serviços" icon="handshake">
    **Knowledge Base para consultoria:**

    * Metodologias proprietárias
    * Cases de sucesso
    * Propostas padrão
    * Perfis de especialistas

    **Agentes beneficiados:**

    * Vendas: Propostas personalizadas
    * Delivery: Execução consistente
    * Relacionamento: Histórico completo
  </Card>

  <Card title="Suporte Interno" icon="building">
    **Knowledge Base corporativa:**

    * Políticas de RH
    * Procedimentos internos
    * Sistemas e senhas
    * Cultura e valores

    **Agentes beneficiados:**

    * RH: Respostas padronizadas
    * TI: Suporte automatizado
    * Gestão: Informações consistentes
  </Card>
</CardGroup>

## Resolução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **1. Agente não encontra informações:**

    * ✅ Verifique se Load Knowledge está ativo
    * ✅ Confirme se tags estão configuradas corretamente
    * ✅ Teste busca manual na aba Search
    * ✅ Adicione sinônimos nas tags

    **2. Respostas muito genéricas:**

    * ✅ Melhore qualidade do conteúdo na KB
    * ✅ Adicione mais contexto nos documentos
    * ✅ Use chunks menores e mais específicos
    * ✅ Refine tags para maior precisão

    **3. Upload falhou:**

    * ✅ Verifique tamanho do arquivo (máx 50MB)
    * ✅ Confirme formato suportado
    * ✅ Teste arquivo menor primeiro
    * ✅ Converta para PDF se necessário

    **4. URL não processa:**

    * ✅ Verifique se URL está acessível publicamente
    * ✅ Teste URL em navegador primeiro
    * ✅ Reduza número de sub-páginas
    * ✅ Aguarde mais tempo para sites grandes

    **5. Busca retorna resultados irrelevantes:**

    * ✅ Refine tags para serem mais específicas
    * ✅ Divida documentos longos em chunks menores
    * ✅ Use linguagem mais clara no conteúdo
    * ✅ Teste diferentes formas de fazer a pergunta
  </Accordion>
</AccordionGroup>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Configurar Agente LLM" icon="robot" href="/agents/llm">
    Aprenda a configurar agentes para usar sua Knowledge Base
  </Card>

  <Card title="Agent Settings" icon="gear" href="/agents/llm#configurações-avançadas">
    Entenda todas as opções do Load Knowledge
  </Card>

  <Card title="Agentes Especializados" icon="users" href="/agents/llm#sistemas-multi-agente-sub-agents">
    Crie agentes especializados por área de conhecimento
  </Card>

  <Card title="Melhores Práticas" icon="lightbulb" href="/best-practices">
    Otimize performance e qualidade das respostas
  </Card>
</CardGroup>

***

🎓 **Parabéns!** Agora você sabe criar e gerenciar bases de conhecimento para tornar seus agentes mais inteligentes e precisos com informações específicas da sua organização!