> ## 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.

# Erros comuns de base

> Problemas frequentes e como evitá-los

## Erros que prejudicam a IA

Uma base de conhecimento mal construída resulta em respostas ruins. Conheça os erros mais comuns e como evitá-los.

***

## 1. Informações desatualizadas

### O problema

A IA responde com preços antigos, promoções expiradas ou serviços descontinuados.

### Consequência

Cliente recebe informação errada → Frustração → Reclamação → Retrabalho

### Como evitar

<Tabs>
  <Tab title="❌ Errado">
    ```
    Promoção de verão: 30% de desconto!
    ```

    *(Promoção acabou há 2 meses)*
  </Tab>

  <Tab title="✅ Correto">
    ```
    ## Promoções vigentes
    Atualizado em: 15/01/2025

    Atualmente não temos promoções ativas.
    Para ofertas exclusivas, siga nosso Instagram.
    ```
  </Tab>
</Tabs>

<Tip>
  Inclua data de atualização em seções que mudam frequentemente.
</Tip>

***

## 2. Respostas incompletas

### O problema

Respostas curtas demais que não esclarecem a dúvida.

### Consequência

Cliente pergunta de novo → Mais mensagens → Possível transbordo desnecessário

### Como evitar

<Tabs>
  <Tab title="❌ Errado">
    ```
    Pergunta: Tem estacionamento?
    Resposta: Sim.
    ```
  </Tab>

  <Tab title="✅ Correto">
    ```
    Pergunta: Tem estacionamento?
    Resposta: Sim, temos estacionamento próprio, coberto e
    com segurança 24h. O valor é R$30 por diária e você
    pode entrar e sair quantas vezes precisar.
    ```
  </Tab>
</Tabs>

***

## 3. Falta de variações de perguntas

### O problema

A base só tem uma forma de pergunta, mas clientes perguntam de várias formas.

### Consequência

IA não entende a pergunta → Resposta errada ou transbordo

### Como evitar

<Tabs>
  <Tab title="❌ Errado">
    ```
    Pergunta: Qual o horário do café da manhã?
    Resposta: Das 6h às 10h.
    ```
  </Tab>

  <Tab title="✅ Correto">
    ```
    ## Café da manhã

    Variações de pergunta:
    - Qual o horário do café da manhã?
    - A que horas serve o café?
    - Até que horas posso tomar café?
    - O café da manhã está incluso?
    - O que tem no café da manhã?
    - Onde é servido o café?

    Resposta completa:
    Nosso café da manhã é servido das 6h às 10h no
    restaurante do térreo. É um buffet completo com
    pães, frutas, frios, sucos e pratos quentes.
    Está incluso na diária!
    ```
  </Tab>
</Tabs>

***

## 4. Conteúdo copiado do site

### O problema

Copiar e colar do site traz formatação problemática, informações desatualizadas e tom inconsistente.

### Consequência

IA responde com tom "de site" ao invés de "de atendimento"

### Como evitar

* Escreva a base do zero, pensando em conversação
* Se usar conteúdo do site, reescreva em tom de atendimento
* Revise cada informação antes de incluir

<Warning>
  Sites frequentemente têm informações desatualizadas. Nunca confie 100% no conteúdo do site.
</Warning>

***

## 5. Tom de voz não definido

### O problema

Cada resposta tem um tom diferente. Algumas formais, outras informais.

### Consequência

Experiência inconsistente → Cliente não reconhece a marca

### Como evitar

Crie uma seção específica de tom de voz:

```markdown theme={null}
## Tom de Voz

**Somos:** Acolhedores, profissionais, prestativos
**Formalidade:** Neutro (nem formal demais, nem informal)

**Usamos:**
- "Bom dia/tarde/noite!"
- "Posso ajudar com mais alguma coisa?"
- "Fico feliz em ajudar!"

**Não usamos:**
- "Prezado senhor/senhora"
- Gírias excessivas
- Respostas secas
```

***

## 6. Informações conflitantes

### O problema

Mesma informação aparece diferente em partes distintas do documento.

### Consequência

IA pode usar qualquer uma → Resposta inconsistente

### Como evitar

<Tabs>
  <Tab title="❌ Errado">
    ```
    [Seção 1]
    Check-in: 14h

    [Seção 5]
    Check-in a partir das 15h
    ```
  </Tab>

  <Tab title="✅ Correto">
    ```
    ## Check-in

    Horário padrão: 14h
    (Centralizado em um único lugar,
    outras seções referenciam esta)
    ```
  </Tab>
</Tabs>

***

## 7. Excesso de informação irrelevante

### O problema

Base com muita informação desnecessária, histórico da empresa, detalhes técnicos que cliente não pergunta.

### Consequência

IA pode trazer informações irrelevantes nas respostas

### Como evitar

Inclua apenas o que cliente realmente pergunta:

| ✅ Incluir     | ❌ Não incluir                      |
| ------------- | ---------------------------------- |
| Preços        | História da fundação               |
| Horários      | Missão e valores corporativos      |
| O que inclui  | Especificações técnicas detalhadas |
| Como funciona | Organograma da empresa             |

***

## 8. FAQs muito técnicos

### O problema

FAQ escrito em linguagem técnica ou jurídica.

### Consequência

Respostas parecem robóticas e distantes

### Como evitar

<Tabs>
  <Tab title="❌ Errado">
    ```
    POLÍTICA DE CANCELAMENTO: O cancelamento da reserva
    deverá ser comunicado com antecedência mínima de 48
    (quarenta e oito) horas do horário previsto para
    check-in, sob pena de cobrança integral do valor
    correspondente à primeira diária.
    ```
  </Tab>

  <Tab title="✅ Correto">
    ```
    ## Preciso cancelar minha reserva, como funciona?

    Você pode cancelar sem custo até 48h antes do check-in.
    Cancelamentos de última hora têm cobrança da primeira
    diária, mas entre em contato que avaliamos cada caso!
    ```
  </Tab>
</Tabs>

***

## 9. Limites da IA não definidos

### O problema

IA tenta responder tudo, inclusive o que não deveria.

### Consequência

Respostas inventadas ou promessas que não pode cumprir

### Como evitar

Defina claramente:

```markdown theme={null}
## A IA NÃO deve:

- Confirmar reservas definitivamente
- Informar disponibilidade em tempo real
- Dar descontos ou negociar preços
- Acessar dados de clientes anteriores
- Opinar sobre concorrentes
- Inventar informações não documentadas
```

***

## 10. Não ter regras de transbordo

### O problema

IA não sabe quando deve transferir para humano.

### Consequência

Tenta resolver tudo → Erros → Cliente frustrado

### Como evitar

```markdown theme={null}
## Quando transbordar

SEMPRE transbordar se:
- Cliente pedir para falar com humano
- Pergunta sobre parcelamento acima de 6x
- Menção a reclamação ou problema
- Solicitação de desconto
- Pergunta fora do escopo documentado
- Dúvida sobre disponibilidade específica
```

***

## Resumo: Checklist de qualidade

| Verificação                       | Status |
| --------------------------------- | ------ |
| Informações estão atualizadas?    | ⬜      |
| Respostas são completas?          | ⬜      |
| Variações de perguntas incluídas? | ⬜      |
| Conteúdo original (não copiado)?  | ⬜      |
| Tom de voz definido?              | ⬜      |
| Sem informações conflitantes?     | ⬜      |
| Sem excesso de informação?        | ⬜      |
| Linguagem acessível?              | ⬜      |
| Limites da IA definidos?          | ⬜      |
| Regras de transbordo claras?      | ⬜      |

## Próximo passo

<Card title="Conversas e abas" icon="arrow-right" href="/operacao/conversas-abas">
  Aprenda a gerenciar conversas no painel.
</Card>
