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

# Base de conhecimento

> Reúna documentos para que a IA os utilize como referência, tornando as respostas mais precisas e contextualizadas.

## O que é

A **Base de Conhecimento** permite reunir documentos (manuais, políticas, planilhas, textos etc.) para que a IA os utilize como **referência**. Ao conectar uma base a um agente ou anexá‑la a uma conversa, as respostas ficam mais **precisas e alinhadas** ao seu contexto.

## Como acessar

* Barra lateral → **Conhecimento**
* Para criar: botão **Novo → Conhecimento** ou o botão de criação na própria página.

<Note>
  A página só aparece se o módulo **Workspace** e a permissão de **Conhecimento** estiverem habilitados para você.
</Note>

## Criar uma base de conhecimento

<Steps>
  <Step title="Clique em Criar uma base de conhecimento" />

  <Step title="Preencha os campos">
    * **Nome** *(obrigatório)* — entre **3 e 60 caracteres**.
    * **Descrição** *(opcional)* — resumo do objetivo da base.
  </Step>

  <Step title="Salve">
    Clique em **Salvar**. Uma mensagem confirma a criação e você é levado à página da base para **adicionar arquivos**.
  </Step>
</Steps>

## Adicionar arquivos

Na página da base, você pode:

* **Arrastar e soltar** arquivos na área indicada, ou
* Usar o botão de **adicionar arquivo** para selecionar do computador, ou
* **Adicionar conteúdo em texto** diretamente (colar/escrever um texto que vira um documento da base).

**Formatos suportados** incluem (entre outros):

```
pdf, txt, doc, docx, xls, xlsx, ppt, pptx, csv, tsv, json, xml, html, md, rtf,
odt, ods, odp, arquivos compactados (zip, tar, gz, rar, 7z) e diversos formatos
de código (js, ts, py, java, sql, yaml etc.)
```

<Note>
  Cada arquivo passa por um processamento (extração de texto/indexação) antes de ficar disponível para uso.
</Note>

## Gerenciar a base

Na página da base você também pode:

* **Editar** nome e descrição.
* **Atualizar/reprocessar (sincronizar)** o conteúdo.
* **Remover** arquivos individualmente.
* **Compartilhar** a base com usuários e grupos (controle de acesso).

## Usar a base de conhecimento

* **Em um agente:** no bloco **Conhecimento** do agente, conecte a base (veja [Agentes](/guia/agentes)).
* **No chat:** digite `#` na mensagem ou use **+ → Anexar conhecimento** e selecione a base.

## Boas práticas

* Dê **nomes descritivos** às bases (ex.: "Políticas de RH 2026") para localizá‑las facilmente.
* Mantenha os documentos **atualizados**; remova versões antigas para evitar respostas desatualizadas.
* Agrupe documentos por **tema** em bases separadas, em vez de uma base gigante e genérica.
* Prefira documentos com **texto selecionável** (PDFs "pesquisáveis") para melhor extração.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Qual o tamanho/limite de arquivos?">
    O limite de tamanho e os tipos aceitos seguem a configuração do administrador (definida em **Painel Administrativo → Documentos**). Os formatos listados acima são os suportados pela interface.
  </Accordion>

  <Accordion title="Por que meu arquivo aparece &#x22;processando&#x22;?">
    Após o upload, o sistema extrai e indexa o conteúdo. Aguarde a conclusão; só então a base poderá ser usada pela IA.
  </Accordion>

  <Accordion title="Posso usar a mesma base em vários agentes?">
    Sim. Uma base pode ser conectada a quantos agentes você quiser.
  </Accordion>
</AccordionGroup>

## Limitações conhecidas

* O nome da base deve ter entre **3 e 60 caracteres**.
* Tipos de arquivo fora da lista suportada não são aceitos.
* Limites de tamanho e parâmetros de processamento dependem das configurações definidas pelo administrador.
* A criação/edição de bases depende da permissão de **Conhecimento** no Workspace.