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

# Base de Conhecimento

> Alimente seus agentes com informações relevantes através de documentos

A **Base de Conhecimento** permite que você adicione documentos e textos para alimentar seus agentes com informações específicas do seu negócio. Durante as conversas, o agente busca automaticamente os trechos mais relevantes para responder com precisão.

## Como Funciona?

<CardGroup cols={2}>
  <Card title="Adicione Conteúdo" icon="upload">
    Envie arquivos (PDF, Word, Excel, etc.) ou crie documentos de texto diretamente na plataforma.
  </Card>

  <Card title="Processamento Automático" icon="microchip">
    O sistema extrai e indexa o conteúdo automaticamente para busca inteligente.
  </Card>

  <Card title="Vincule a Agentes" icon="link">
    Conecte documentos aos agentes que devem acessar aquele conhecimento.
  </Card>

  <Card title="Respostas Contextualizadas" icon="magnifying-glass">
    Durante a conversa, o agente busca trechos relevantes e responde com base neles.
  </Card>
</CardGroup>

***

## Adicionando Documentos

Existem duas formas de adicionar conteúdo à Base de Conhecimento:

<Tabs>
  <Tab title="Upload de Arquivo">
    <Steps>
      <Step title="Clique em Novo Documento">
        Na página de Documentos, clique no botão **Novo Documento** no canto superior direito.
      </Step>

      <Step title="Selecione o Arquivo">
        Arraste e solte o arquivo na área indicada ou clique para abrir o seletor de arquivos.
      </Step>

      <Step title="Envie o Documento">
        Clique em **Enviar**. O sistema extrai o conteúdo e processa automaticamente.
      </Step>
    </Steps>

    <Warning>
      Tamanho máximo por arquivo: **10 MB**
    </Warning>
  </Tab>

  <Tab title="Documento de Texto">
    Você também pode criar documentos diretamente na plataforma, sem precisar fazer upload de arquivo.

    <Steps>
      <Step title="Clique em Novo Documento">
        Na página de Documentos, clique no botão **Novo Documento**.
      </Step>

      <Step title="Selecione a aba Texto">
        Alterne para a aba **Texto** no diálogo de criação.
      </Step>

      <Step title="Preencha Título e Conteúdo">
        Digite um título descritivo e cole ou escreva o conteúdo do documento.
      </Step>

      <Step title="Crie o Documento">
        Clique em **Criar**. O sistema processa o conteúdo automaticamente.
      </Step>
    </Steps>

    <Tip>
      Documentos de texto são úteis para adicionar FAQs, scripts de atendimento, tabelas de preços ou qualquer informação que você já tenha em formato de texto.
    </Tip>
  </Tab>
</Tabs>

### Formatos de Arquivo Suportados

| Categoria         | Formatos                                                                        |
| ----------------- | ------------------------------------------------------------------------------- |
| **Documentos**    | PDF (`.pdf`), Word (`.docx`, `.doc`), OpenDocument (`.odt`), Rich Text (`.rtf`) |
| **Planilhas**     | Excel (`.xlsx`, `.xls`), OpenDocument (`.ods`), CSV (`.csv`)                    |
| **Apresentações** | PowerPoint (`.pptx`, `.ppt`), OpenDocument (`.odp`)                             |
| **Web e Texto**   | HTML, Markdown (`.md`), Texto Puro (`.txt`), XML, JSON                          |
| **Outros**        | E-mail (`.eml`, `.msg`), E-book (`.epub`)                                       |

***

## Vinculando Documentos a Agentes

Após adicionar um documento, vincule-o aos agentes que devem acessá-lo:

<Steps>
  <Step title="Acesse o Agente">
    Vá para a página **Agentes** e clique no agente desejado.
  </Step>

  <Step title="Localize a Seção Base de Conhecimento">
    Role até encontrar a seção **Base de Conhecimento**.
  </Step>

  <Step title="Adicione o Documento">
    Clique em **Adicionar Documento**, busque o documento desejado e clique em **Vincular**.
  </Step>
</Steps>

<Tip>
  Um mesmo documento pode ser vinculado a **múltiplos agentes**, permitindo reutilização da base de conhecimento.
</Tip>

Para desvincular, clique no ícone de lixeira ao lado do documento na seção Base de Conhecimento do agente. Desvincular **não exclui** o documento -- ele continua disponível para outros agentes.

***

## Gerenciando Documentos

### Editar Conteúdo

Clique em um documento na listagem para acessar a página de detalhes. Nela você pode editar o conteúdo do documento. Ao salvar, o sistema reprocessa automaticamente o conteúdo para manter a busca atualizada.

### Tags

Use **tags** para organizar e categorizar seus documentos. Na página de detalhes do documento, adicione ou remova tags para facilitar a busca e filtragem.

### Excluir Documento

Na página de Documentos, clique no menu de ações (três pontos) do documento e selecione **Excluir**.

<Warning>
  Ao excluir um documento:

  * Ele será **desvinculado de todos os agentes**
  * Todo o conteúdo indexado será removido
  * Esta ação **não pode ser desfeita**
</Warning>

***

## Boas Práticas

<CardGroup cols={2}>
  <Card title="Organize por Tema" icon="folder">
    Nomeie seus arquivos de forma descritiva e use tags para facilitar a busca.
  </Card>

  <Card title="Mantenha Atualizado" icon="arrows-rotate">
    Edite ou substitua documentos desatualizados para manter a precisão das respostas.
  </Card>

  <Card title="Seja Específico" icon="crosshairs">
    Documentos focados em um tema geram respostas mais precisas do que documentos genéricos.
  </Card>

  <Card title="Vincule com Propósito" icon="link">
    Vincule apenas documentos relevantes a cada agente para evitar contextos confusos.
  </Card>
</CardGroup>

### Dicas para Melhor Performance

1. **Prefira PDFs bem formatados** -- Documentos com boa estrutura são extraídos com maior precisão
2. **Evite imagens como texto** -- O sistema não faz OCR em imagens dentro de PDFs
3. **Divida documentos muito grandes** -- Documentos com mais de 50 páginas podem ser divididos por capítulo ou seção
4. **Use títulos e subtítulos** -- Documentos bem estruturados geram respostas mais coerentes

***

## Resolução de Problemas

| Problema                          | Solução                                                                                |
| --------------------------------- | -------------------------------------------------------------------------------------- |
| Upload falha                      | Verifique se o arquivo tem menos de 10 MB e é um formato suportado                     |
| Agente não encontra informação    | Confirme que o documento está vinculado ao agente                                      |
| Resposta imprecisa                | Melhore o conteúdo do documento ou divida em documentos menores e mais focados         |
| Documento não aparece na listagem | Aguarde alguns segundos e atualize a página -- o processamento pode estar em andamento |

<Tip>
  Consulte os detalhes do seu plano na página de **Billing** para verificar os limites de armazenamento.
</Tip>

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Tools" icon="wrench" href="/tools">
    Adicione ferramentas para integrar com APIs externas
  </Card>

  <Card title="Playground" icon="play" href="/playground">
    Teste seus agentes com a base de conhecimento configurada
  </Card>
</CardGroup>