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

# Base de Conhecimento

> Dê aos seus agentes conhecimento especializado a partir dos seus documentos.

A Base de Conhecimento permite que você carregue documentos que seus agentes podem consultar durante as conversas. Usando busca vetorial e RAG (Geração Aumentada por Recuperação), os agentes encontram informações relevantes nos seus documentos para fornecer respostas precisas e fundamentadas.

## Como Funciona

1. **Upload** de documentos (PDF, TXT, MD, DOCX)
2. **Processamento** — Os documentos são fragmentados e convertidos em embeddings vetoriais
3. **Armazenamento** — Os embeddings são armazenados no PostgreSQL com pgvector
4. **Recuperação** — Quando relevante, os agentes pesquisam na base de conhecimento e incluem os resultados nas respostas

## Adicionando Documentos

<Steps>
  <Step title="Navegue até Conhecimento">
    Acesse as configurações do seu agente e selecione a aba **Conhecimento**.
  </Step>

  <Step title="Carregue os arquivos">
    Arraste e solte os arquivos ou clique para navegar. Formatos suportados:

    | Formato    | Extensões       |
    | ---------- | --------------- |
    | PDF        | `.pdf`          |
    | Texto      | `.txt`, `.md`   |
    | Documentos | `.docx`         |
    | Planilhas  | `.csv`, `.xlsx` |
  </Step>

  <Step title="Aguarde o processamento">
    Os documentos são fragmentados e incorporados automaticamente. Isso pode levar alguns instantes para arquivos grandes.
  </Step>

  <Step title="Verifique">
    Seus documentos aparecem na lista de conhecimento. Você pode visualizar os fragmentos e testar consultas de busca.
  </Step>
</Steps>

## Como os Agentes Usam o Conhecimento

Quando você faz uma pergunta, o agente:

1. Converte sua pergunta em um embedding vetorial
2. Pesquisa na base de conhecimento por fragmentos semanticamente semelhantes
3. Inclui os fragmentos mais relevantes como contexto
4. Gera uma resposta fundamentada nos seus documentos

<Tip>
  Para melhores resultados, carregue documentos bem estruturados com títulos e seções claros. O algoritmo de fragmentação preserva a estrutura do documento.
</Tip>

## Gerenciando o Conhecimento

* **Adicionar** novos documentos a qualquer momento
* **Remover** documentos desatualizados
* **Ressincronizar** para atualizar os embeddings após alterações nos documentos
* **Testar** consultas de busca para verificar a qualidade da recuperação
