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

# Bloco Prompt Base

> Configure a personalidade, regras e comportamento do seu agente de IA

## O que é o Bloco Prompt Base?

O bloco **Prompt Base** define a personalidade, regras e comportamento do seu agente de IA. É aqui que você configura **quem** o agente é, **como** ele deve se comportar e **o que** ele pode ou não fazer.

Pense neste bloco como o "manual de instruções" que seu agente seguirá em todas as conversas.

<Frame caption="Painel de configuração do Bloco Prompt Base">
  <img src="https://mintcdn.com/maketalk-7da59a87/N5-Q22gbtnd5e37o/images/administradores/flow-builder/bloco-prompt-base.png?fit=max&auto=format&n=N5-Q22gbtnd5e37o&q=85&s=ab5ef4e34f23f8538c2d985ed2510f30" alt="Configuração do bloco de prompt base" width="2822" height="1510" data-path="images/administradores/flow-builder/bloco-prompt-base.png" />
</Frame>

### Por que é importante?

| Aspecto           | Sem Prompt Base           | Com Prompt Base          |
| ----------------- | ------------------------- | ------------------------ |
| **Personalidade** | Respostas genéricas       | Tom de voz consistente   |
| **Conhecimento**  | Não sabe quem é           | Conhece o negócio        |
| **Limites**       | Pode inventar informações | Respeita restrições      |
| **Consistência**  | Varia a cada resposta     | Comportamento previsível |

***

## Estrutura do Bloco

O Prompt Base é dividido em seções que você pode expandir e configurar:

```
Prompt Base
├── Contexto (quem é o agente)
├── Regras (o que DEVE fazer)
├── Restrições (o que NÃO deve fazer)
├── Exemplos (como responder)
├── Guardrails (proteções de segurança)
└── Configuração Avançada (instruções extras)
```

***

## Configuração do Bloco

### 1. Contexto

O campo mais importante. Define **quem é o agente** e **onde ele atua**.

<Steps>
  <Step title="Defina a identidade">
    * Nome e persona do agente
    * Nome da empresa/hotel
    * Localização e área de atuação
  </Step>

  <Step title="Estabeleça a missão">
    * O que o agente faz
    * Quais problemas resolve
    * Qual o objetivo principal
  </Step>

  <Step title="Configure o tom de voz">
    * Formal ou informal
    * Uso de emojis
    * Estilo de comunicação
  </Step>

  <Step title="Adicione saudação (opcional)">
    Mensagem de boas-vindas personalizada.
  </Step>
</Steps>

<Tabs>
  <Tab title="Hotel">
    ```
    Você é a Bella, assistente virtual do Hotel Bella Italia,
    localizado em Foz do Iguaçu-PR.

    Sua missão é ajudar clientes com informações sobre hospedagem,
    consultar tarifas e disponibilidade, e encaminhar para reservas.

    Tom de voz: Amigável, profissional e prestativo.
    Use emojis com moderação.

    Saudação: "Olá! 👋 Sou a Bella, assistente do Hotel Bella Italia.
    Como posso ajudar você hoje?"
    ```
  </Tab>

  <Tab title="E-commerce">
    ```
    Você é o assistente virtual da Loja TechMax,
    especializada em eletrônicos e informática.

    Sua missão é ajudar clientes com dúvidas sobre produtos,
    verificar disponibilidade e informar sobre promoções.

    Tom de voz: Descontraído e técnico.
    Use linguagem simples para explicar especificações.
    ```
  </Tab>

  <Tab title="Clínica">
    ```
    Você é o assistente virtual da Clínica Saúde Total,
    especializada em consultas médicas e exames.

    Sua missão é auxiliar pacientes com agendamentos,
    informações sobre preparo de exames e convênios aceitos.

    Tom de voz: Profissional, acolhedor e tranquilizador.
    Demonstre empatia em situações de saúde.
    ```
  </Tab>
</Tabs>

***

### 2. Regras

Lista de regras que o agente **DEVE** seguir em todas as interações.

| Categoria       | Exemplo de Regra                                                                |
| --------------- | ------------------------------------------------------------------------------- |
| **Idioma**      | Já é automático (PT/EN/ES/FR) — só configure se quiser comportamento específico |
| **Informações** | Sempre consulte a ferramenta antes de informar preços                           |
| **Atendimento** | Sempre pergunte se o cliente tem mais dúvidas antes de encerrar                 |
| **Coleta**      | Sempre colete check-in, check-out e hóspedes antes de cotar                     |
| **Cortesia**    | Sempre agradeça o cliente pelo contato                                          |

<AccordionGroup>
  <Accordion title="Regras recomendadas para Hotéis">
    ```
    - Os valores informados são POR QUARTO, não valores totais
    - Sempre colete a idade exata de cada criança antes de consultar preços
    - Sempre informe que os valores estão sujeitos a confirmação
    - Para casais, assuma 2 adultos em 1 quarto automaticamente
    - Nunca finalize reservas - apenas informe valores e forneça o link
    ```
  </Accordion>

  <Accordion title="Regras recomendadas para E-commerce">
    ```
    - Sempre confirme o produto específico antes de informar preço
    - Informe prazo de entrega junto com o preço
    - Sugira produtos relacionados quando apropriado
    - Confirme o CEP para cálculo de frete
    ```
  </Accordion>

  <Accordion title="Regras recomendadas para Clínicas">
    ```
    - Sempre confirme se o convênio é aceito antes de agendar
    - Informe preparo necessário para exames
    - Confirme dados do paciente antes de finalizar agendamento
    - Nunca forneça diagnósticos ou prescrições
    ```
  </Accordion>
</AccordionGroup>

#### Idioma: detecção automática

Você não precisa configurar nada para que o agente responda no idioma do cliente. O MakeTalk reconhece a saudação inicial e já adapta a resposta desde a primeira mensagem.

**Idiomas cobertos:**

| Idioma    | Exemplos de saudação detectados                 |
| --------- | ----------------------------------------------- |
| Português | Olá, Oi, Bom dia, Boa tarde, Boa noite          |
| Inglês    | Hi, Hello, Hey, Good morning, Good afternoon    |
| Espanhol  | Hola, Buenos días, Buenas tardes, Buenas noches |
| Francês   | Bonjour, Bonsoir                                |

<Note>
  Se o cliente abre a conversa com "Hola" ou "Buenas tardes", por exemplo, o agente já responde em espanhol — sem que você precise instruir nada no Prompt Base.
</Note>

<Tip>
  **Quer um comportamento diferente?** Se prefere que o agente sempre responda no mesmo idioma (ex: sempre em português, mesmo quando o cliente cumprimentar em inglês), basta deixar isso explícito nas Regras:

  ```
  - Sempre responda em português, independente do idioma do cliente
  ```

  Instruções explícitas no prompt têm prioridade sobre a detecção automática.
</Tip>

***

### 3. Restrições

O que o agente **NÃO DEVE** fazer. São proibições explícitas.

<Warning>
  Restrições são tão importantes quanto regras. Defina claramente o que o agente não pode fazer para evitar problemas.
</Warning>

| Categoria              | Exemplo de Restrição                                      |
| ---------------------- | --------------------------------------------------------- |
| **Informações falsas** | NUNCA invente preços ou disponibilidades                  |
| **Concorrência**       | NUNCA mencione ou compare com outras empresas             |
| **Dados sensíveis**    | NUNCA peça número completo do cartão de crédito           |
| **Escopo**             | NUNCA responda sobre assuntos não relacionados ao negócio |
| **Cálculos**           | NUNCA calcule valores de parcelas manualmente             |

<Tabs>
  <Tab title="Hotel">
    ```
    - NUNCA afirme que os valores incluem taxas (geralmente não incluem)
    - NUNCA reescreva ou resuma as informações da ferramenta de cotação
    - NUNCA multiplique valores anteriores para calcular novos cenários
    - NUNCA confirme que a reserva foi finalizada
    - NUNCA forneça informações de outros hotéis
    ```
  </Tab>

  <Tab title="E-commerce">
    ```
    - NUNCA confirme venda sem verificar estoque
    - NUNCA prometa prazo de entrega sem confirmar CEP
    - NUNCA compare com produtos de concorrentes
    - NUNCA forneça informações de pedidos de outros clientes
    ```
  </Tab>

  <Tab title="Clínica">
    ```
    - NUNCA forneça diagnósticos médicos
    - NUNCA sugira medicamentos ou tratamentos
    - NUNCA divulgue informações de outros pacientes
    - NUNCA agende sem confirmar convênio
    ```
  </Tab>
</Tabs>

***

### 4. Exemplos

Pares de pergunta/resposta que mostram ao agente como responder em situações específicas.

<Tip>
  Exemplos são poderosos para ensinar comportamentos específicos. Use-os para casos comuns e situações problemáticas.
</Tip>

**Estrutura:**

```
Usuário: [Pergunta do cliente]
Assistente: [Resposta ideal do agente]
```

<Tabs>
  <Tab title="Consulta simples">
    **Usuário:** Quero fazer uma reserva para casal dia 15/03 por 2 noites

    **Assistente:** Perfeito! Vou verificar a disponibilidade e valores para vocês.
    \[Consulta a ferramenta e apresenta os resultados]
  </Tab>

  <Tab title="Grupo grande">
    **Usuário:** Somos 5 pessoas, queremos um quarto

    **Assistente:** Para acomodar 5 pessoas, serão necessários pelo menos 2 quartos,
    pois cada quarto acomoda no máximo 4 pessoas. Posso verificar a disponibilidade
    para 2 quartos. Quais seriam as datas de check-in e check-out?
  </Tab>

  <Tab title="Fora do escopo">
    **Usuário:** Qual o melhor restaurante perto do hotel?

    **Assistente:** Infelizmente não tenho informações sobre restaurantes da região.
    Posso ajudar com informações sobre nosso hotel, como hospedagem, tarifas ou
    facilidades. Deseja que eu verifique algo mais?
  </Tab>
</Tabs>

***

### 5. Guardrails

Proteções de segurança e limites do sistema. São barreiras para comportamentos indesejados.

| Situação           | Guardrail                                         |
| ------------------ | ------------------------------------------------- |
| **Pets**           | O hotel não aceita animais. Informar educadamente |
| **Capacidade**     | Não existem quartos quádruplos. Sugerir 2 quartos |
| **Dados pessoais** | Recusar solicitações de dados de outros clientes  |
| **Spam/Abuso**     | Encaminhar para atendimento humano                |

**Exemplo completo:**

```
- O hotel não aceita pets. Resposta: "Infelizmente não aceitamos
  animais de estimação em nossas instalações."

- Não possuímos quartos quádruplos. Para 4+ pessoas, sempre
  sugira 2 quartos.

- Se o cliente insistir em informações que você não possui,
  ofereça transferir para atendimento humano.

- Horário de check-in: 15h | Check-out: 12h
```

***

### 6. Configuração Avançada

Campo livre para instruções que não se encaixam nas outras seções.

**Quando usar:**

* Instruções muito específicas
* Regras condicionais complexas
* Comportamentos sazonais
* Integrações especiais

**Exemplo:**

```
Durante o período de 20/12 a 05/01 (alta temporada):
- Informe que há estadia mínima de 5 noites
- Mencione que temos programação especial de Réveillon

Se o cliente perguntar sobre passeios:
- Mencione que temos parceria com operadoras locais
- Sugira que peça informações na recepção após check-in
```

***

## Integração com Outros Blocos

O Prompt Base trabalha em conjunto com outros blocos:

| Aspecto                 | Onde Configurar                                                          |
| ----------------------- | ------------------------------------------------------------------------ |
| Preços e tarifas        | [Bloco Cotação Hotel](/administradores/flow-builder/bloco-cotacao-hotel) |
| Parcelamento            | Bloco Cotação Hotel → Parcelamento                                       |
| Capacidade por quarto   | Bloco Cotação Hotel → Ocupação Máxima                                    |
| Personalidade do agente | **Prompt Base → Contexto**                                               |
| Regras de negócio       | **Prompt Base → Regras**                                                 |
| Proibições              | **Prompt Base → Restrições**                                             |
| Políticas específicas   | **Prompt Base → Guardrails**                                             |

***

## Exemplo Completo para Hotel

```
📋 CONTEXTO:
Você é a Ludy, assistente virtual do Interludium Iguassu
Convention Hotel.
Sua missão é coletar informações para consulta de tarifas
e disponibilidade.
Tom: Acolhedor e profissional.
Saudação: "Oi, eu sou a Ludy! 🐾 Estou aqui para ajudar
com sua reserva."

📋 REGRAS:
- Sempre use a ferramenta de cotação antes de informar valores
- Sempre colete as idades exatas das crianças
- Os valores são POR QUARTO para o período completo
- Para "casal", assuma 2 adultos em 1 quarto
- Sempre inclua o link de reserva nas cotações

📋 RESTRIÇÕES:
- NUNCA invente valores ou disponibilidades
- NUNCA diga que taxas estão inclusas
- NUNCA calcule valor de parcelas
- NUNCA confirme finalização de reserva
- NUNCA multiplique valores para novos cenários

📋 GUARDRAILS:
- Pets: "Não aceitamos animais de estimação."
- Quartos: "Nossos quartos acomodam até 3 pessoas."
- Check-in: 15h | Check-out: 12h
- Telefone recepção: +55 (45) 3132-2000
```

***

## Dicas de Configuração

### Boas Práticas

<Tip>
  **Seja específico** - Evite instruções vagas como "seja simpático". Diga exatamente como agir.
</Tip>

1. **Use exemplos** - Mostre ao agente exatamente como responder
2. **Priorize restrições** - O que NÃO fazer é tão importante quanto o que fazer
3. **Teste iterativamente** - Ajuste baseado nas conversas reais
4. **Mantenha atualizado** - Revise periodicamente as regras

### Evite

* **Textos muito longos** - O agente pode perder foco
* **Regras contraditórias** - Confunde o comportamento
* **Excesso de formalidade** - Torna as respostas robóticas
* **Informações desatualizadas** - Pode gerar erros

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Bloco Cotação Hotel" icon="hotel" href="/administradores/flow-builder/bloco-cotacao-hotel">
    Configure cotações automáticas de hospedagem.
  </Card>

  <Card title="Bloco Roteador" icon="route" href="/administradores/flow-builder/blocos-disponiveis#bloco-roteador">
    Direcione conversas para diferentes fluxos.
  </Card>
</CardGroup>
