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

# Documento de treinamento

> Estrutura do documento e como preenchê-lo corretamente

## O que é o documento de treinamento?

O documento de treinamento é o conteúdo que compõe a **Base de Conhecimento** do seu agente de IA. Ele funciona como o "manual oficial" que ensina a IA sobre o seu negócio.

Você sobe esse conteúdo diretamente na seção **Base de Conhecimento** do Flow Builder, onde pode adicionar sites, PDFs, textos e perguntas e respostas.

<Note>
  Mesmo que a IA colete informações automaticamente do seu site, o conteúdo que você sobe na Base de Conhecimento **sempre tem prioridade**. Isso porque muitos sites possuem informações desatualizadas.
</Note>

## Por que a Base de Conhecimento é essencial?

| Fonte                | Problema comum                      |
| -------------------- | ----------------------------------- |
| Site                 | Promoções e preços desatualizados   |
| Site                 | Informações incompletas             |
| Site                 | Tom de voz diferente do atendimento |
| Base de Conhecimento | Você controla 100% do conteúdo      |

Apenas você e sua equipe conhecem:

* Detalhes operacionais do dia a dia
* Exceções e regras não documentadas
* Como realmente querem atender o cliente

## Como subir o conteúdo

No Flow Builder, acesse a seção **Base de Conhecimento** do seu agente. Você pode subir o conteúdo de diferentes formas:

* **Site** — a IA coleta automaticamente o conteúdo das páginas
* **PDF** — manuais, catálogos, documentos
* **Texto direto** — cole ou digite as informações
* **Perguntas e Respostas** — FAQs estruturadas

## Estrutura do conteúdo

Organize seu conteúdo em **seções** que funcionam como um esqueleto. Você pode:

* **Excluir** seções que não se aplicam
* **Editar** o conteúdo das seções existentes
* **Adicionar** novas seções conforme necessário

### Seções típicas

<AccordionGroup>
  <Accordion title="Informações gerais">
    * Nome do negócio
    * Endereço e localização
    * Horário de funcionamento
    * Canais de contato
  </Accordion>

  <Accordion title="Produtos/Serviços">
    * Lista de produtos ou serviços
    * Descrições detalhadas
    * Preços e condições
    * Diferenciais
  </Accordion>

  <Accordion title="Políticas">
    * Formas de pagamento
    * Política de cancelamento
    * Trocas e devoluções
    * Regras específicas
  </Accordion>

  <Accordion title="Perguntas frequentes">
    * Variações de perguntas
    * Respostas humanizadas
    * Cenários específicos
  </Accordion>

  <Accordion title="Tom de voz">
    * Nível de formalidade
    * Personalidade da marca
    * Frases que NÃO usar
    * Exemplos de respostas ideais
  </Accordion>
</AccordionGroup>

## Como preencher cada seção

### 1. Seja específico e completo

<Tabs>
  <Tab title="❌ Ruim">
    ```
    Quartos: temos vários tipos disponíveis.
    ```
  </Tab>

  <Tab title="✅ Bom">
    ```
    Quartos disponíveis:
    - Standard: 25m², cama de casal, ar-condicionado, TV 42"
    - Superior: 35m², cama king, varanda, ar-condicionado, TV 50"
    - Suíte Master: 50m², cama king, sala de estar, banheira, varanda com vista
    ```
  </Tab>
</Tabs>

### 2. Use linguagem natural

Escreva como se estivesse explicando para um cliente, não como um manual técnico.

<Tabs>
  <Tab title="❌ Ruim">
    ```
    Check-in: 14h. Check-out: 12h. Early check-in sujeito à disponibilidade.
    ```
  </Tab>

  <Tab title="✅ Bom">
    ```
    O check-in é a partir das 14h e o check-out até as 12h.
    Se precisar chegar mais cedo ou sair mais tarde, é só nos avisar
    que verificamos a disponibilidade com prazer!
    ```
  </Tab>
</Tabs>

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

Clientes perguntam a mesma coisa de formas diferentes:

```
Variações para "horário de funcionamento":
- Que horas vocês abrem?
- Qual o horário de atendimento?
- Vocês funcionam aos domingos?
- Estão abertos agora?
- Até que horas vocês ficam?
```

## Campos obrigatórios vs opcionais

| Campo               | Obrigatório? | Por quê?                                 |
| ------------------- | ------------ | ---------------------------------------- |
| Informações básicas | Sim          | A IA precisa saber o básico do negócio   |
| Produtos/Serviços   | Sim          | Perguntas mais frequentes são sobre isso |
| Preços              | Sim\*        | \*Se você divulga preços publicamente    |
| Políticas           | Sim          | Evita mal-entendidos                     |
| Tom de voz          | Recomendado  | Garante consistência nas respostas       |
| FAQs específicas    | Recomendado  | Melhora qualidade das respostas          |

## Dicas importantes

<Tip>
  **Atualize regularmente!** Sempre que mudar preços, promoções ou políticas, atualize a Base de Conhecimento no Flow Builder.
</Tip>

<Warning>
  **Não copie e cole do site sem revisar.** O site pode ter informações desatualizadas ou em um tom diferente do desejado.
</Warning>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Perguntas e respostas" icon="arrow-right" href="/treinamento-ia/perguntas-respostas">
    Aprenda a criar Q\&A humanizadas.
  </Card>

  <Card title="Base de Conhecimento no Flow Builder" icon="database" href="/administradores/flow-builder/base-conhecimento-agente">
    Veja como subir o conteúdo no seu agente.
  </Card>
</CardGroup>
