> ## Documentation Index
> Fetch the complete documentation index at: https://freshbase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Como gerenciar documentos

> Como criar, editar e organizar documentos na sua Base.

Ao final deste guia, você saberá como criar, editar e organizar documentos na sua Base.

## Acessando os documentos

Clique em **Conhecimento** no menu lateral esquerdo. Você verá três abas:

| Aba            | O que contém               |
| -------------- | -------------------------- |
| **Documentos** | Seus arquivos e pastas     |
| **Canvas**     | Editor visual colaborativo |
| **Insights**   | Análises geradas pela IA   |

## Criando documentos

### Pelo painel de Documentos

1. Vá em **Conhecimento > Documentos**
2. Clique em **Criar documento**
3. Dê um nome ao documento
4. Comece a escrever no editor

### Pelo Chat

Peça ao assistente para criar um documento:

> "Crie uma especificação para a funcionalidade de busca avançada"

O assistente vai gerar o conteúdo e pedir sua aprovação antes de salvar na Base.

### Via upload

1. Em **Conhecimento > Documentos**, clique em **Upload**
2. Selecione o arquivo do seu computador
3. O documento será adicionado à Base

## Editando documentos

O Freshbase usa um editor de Markdown. Você pode:

* Escrever texto formatado (títulos, listas, negrito, itálico)
* Navegar pela árvore de arquivos na lateral para trocar de documento
* Salvar alterações automaticamente

### Editando com ajuda da IA (Canvas)

O Canvas oferece edição assistida:

1. Vá em **Conhecimento > Canvas**
2. Selecione um documento ou crie um novo
3. Peça ajuda ao assistente para editar partes específicas
4. O assistente sugere alterações que você pode aprovar ou ajustar

## Organizando documentos

Os documentos ficam em uma estrutura de pastas dentro da Base:

* **Crie pastas** para agrupar documentos por tema (ex: "specs/", "decisions/", "meetings/")
* **Navegue** pela árvore de arquivos na lateral
* **Mova** documentos entre pastas conforme necessário

### Estrutura sugerida

```
Sua Base/
├── specs/          ← Especificações e requisitos
├── decisions/      ← Registros de decisões (ADRs)
├── meetings/       ← Resumos de reuniões
└── contexts/       ← Documentos de contexto
```

## Formato dos documentos

Todos os documentos no Freshbase são em **Markdown** (texto puro formatado). Vantagens:

* **Portáteis** — podem ser abertos em qualquer editor de texto
* **Versionados** — todas as alterações são rastreadas
* **Legíveis** — formato limpo e organizado
* **IA-friendly** — o assistente consegue ler e editar facilmente

### Frontmatter

Documentos gerados pelo Freshbase incluem um cabeçalho especial (`freshbase:`) com informações de linhagem — de onde o documento veio, quando foi criado, a partir de qual conversa ou reunião. Isso é automático e garante rastreabilidade.

## Usando Insights

A aba **Insights** mostra análises geradas pela IA sobre o conteúdo da sua Base:

* Padrões identificados nos documentos
* Conexões entre temas
* Pontos de atenção

Os Insights são gerados automaticamente conforme você adiciona conteúdo à Base.

## Problemas comuns

<AccordionGroup>
  <Accordion title="Não consigo encontrar um documento">
    Use a árvore de arquivos na lateral para navegar. Se o documento foi criado pelo Chat ou pelo Inbox, ele pode estar em uma pasta específica como `specs/` ou `meetings/`.
  </Accordion>

  <Accordion title="Quero reverter uma edição">
    O Freshbase versiona automaticamente seus documentos. Todas as alterações são rastreadas e podem ser revertidas.
  </Accordion>
</AccordionGroup>

<Card title="Próximo passo" icon="arrow-right" href="/how-to/invite-team">
  Como convidar membros da equipe
</Card>