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

# Como criar uma base eficiente

> Boas práticas para uma base de conhecimento de qualidade

## Princípios de uma boa base

Uma base de conhecimento eficiente segue três princípios:

1. **Completa** - Contém todas as informações que clientes perguntam
2. **Atualizada** - Reflete a realidade atual do negócio
3. **Clara** - Escrita de forma que a IA entenda e reproduza bem

## Estrutura recomendada

### Organize por temas

```
📁 Base de Conhecimento
├── 📄 Sobre a empresa
├── 📄 Produtos e serviços
├── 📄 Preços e condições
├── 📄 Políticas
├── 📄 FAQ
└── 📄 Tom de voz
```

### Use hierarquia clara

<Tabs>
  <Tab title="❌ Ruim">
    ```
    Hotel tem piscina spa restaurante academia
    wifi grátis estacionamento ar condicionado
    ```
  </Tab>

  <Tab title="✅ Bom">
    ```
    ## Comodidades

    ### Lazer
    - Piscina: 200m², aquecida, 7h às 22h
    - Spa: massagens e tratamentos, mediante agendamento
    - Academia: equipamentos Technogym, 24h

    ### Serviços
    - Wi-Fi: gratuito em todas as áreas
    - Estacionamento: coberto, R$30/dia
    - Restaurante: café, almoço e jantar
    ```
  </Tab>
</Tabs>

## Escrevendo para a IA

### 1. Seja explícito

A IA não "adivinha". Escreva tudo que ela precisa saber.

| ❌ Implícito             | ✅ Explícito                                                                          |
| ----------------------- | ------------------------------------------------------------------------------------ |
| "Café da manhã incluso" | "Café da manhã incluso na diária, servido das 6h às 10h no restaurante térreo"       |
| "Aceitamos cartões"     | "Aceitamos cartões Visa, Mastercard, Elo, American Express (crédito e débito) e Pix" |

### 2. Antecipe variações

Clientes perguntam de formas diferentes:

```markdown theme={null}
## Sobre estacionamento

**Pergunta:** Tem estacionamento?
**Variações:**
- Vocês têm vaga?
- Onde posso estacionar?
- O estacionamento é gratuito?
- Quanto custa o estacionamento?

**Resposta:**
Temos estacionamento próprio, coberto e com segurança 24h.
O valor é R$30 por diária. Você pode entrar e sair quantas
vezes precisar durante sua estadia.
```

### 3. Inclua contexto

```markdown theme={null}
## Check-in

**Horário padrão:** A partir das 14h

**Early check-in:**
Disponível mediante consulta prévia. Se o apartamento
estiver liberado antes, não há custo adicional. Caso
contrário, pode haver taxa de R$50.

**Check-in após 22h:**
Possível com aviso prévio. Informar horário estimado
de chegada para garantir recepção disponível.
```

### 4. Use linguagem natural

Escreva como você explicaria para um cliente, não como um manual técnico.

<Tabs>
  <Tab title="❌ Técnico">
    ```
    POLÍTICA DE CANCELAMENTO: Cancelamentos realizados
    com antecedência inferior a 48 (quarenta e oito) horas
    da data de check-in estão sujeitos à cobrança integral
    do valor da primeira diária, conforme regulamento interno.
    ```
  </Tab>

  <Tab title="✅ Natural">
    ```
    ## Cancelamento

    Você pode cancelar sua reserva sem custo até 48h antes
    do check-in. Cancelamentos feitos com menos de 48h de
    antecedência têm cobrança da primeira diária.

    Precisou cancelar de última hora? Entre em contato que
    avaliamos cada caso individualmente.
    ```
  </Tab>
</Tabs>

## O que incluir obrigatoriamente

### Informações essenciais

<Check>Nome e descrição da empresa</Check>
<Check>Produtos/serviços com descrições completas</Check>
<Check>Preços atualizados (se divulgados)</Check>
<Check>Formas de pagamento</Check>
<Check>Horários de funcionamento</Check>
<Check>Localização e como chegar</Check>
<Check>Canais de contato</Check>
<Check>Política de cancelamento</Check>

### Perguntas frequentes

<Check>As 10 perguntas mais comuns dos clientes</Check>
<Check>Variações de como cada pergunta é feita</Check>
<Check>Respostas completas e humanizadas</Check>

### Regras da IA

<Check>O que a IA NÃO deve fazer</Check>
<Check>Quando transbordar para humano</Check>
<Check>Tom de voz e estilo</Check>

## Erros comuns a evitar

<Warning>
  Estes erros prejudicam a qualidade das respostas da IA:
</Warning>

| Erro                         | Problema                         | Solução                  |
| ---------------------------- | -------------------------------- | ------------------------ |
| Informações desatualizadas   | IA dá respostas erradas          | Revisar mensalmente      |
| Conteúdo copiado do site     | Tom inconsistente, dados antigos | Escrever do zero         |
| Respostas incompletas        | Cliente fica com dúvidas         | Detalhar cada resposta   |
| Falta de variações           | IA não entende perguntas         | Incluir múltiplas formas |
| Tom de voz não definido      | Respostas inconsistentes         | Criar seção específica   |
| Muita informação irrelevante | IA se confunde                   | Focar no essencial       |

## Próximo passo

<Card title="Manter documentos atualizados" icon="arrow-right" href="/base-conhecimento/manter-atualizado">
  Como criar um processo de atualização contínua.
</Card>