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

# Instruções (Prompt)

> Defina o comportamento do agente com instruções claras e estruturadas

O prompt é o conjunto de instruções que define como o agente se comporta. É a parte mais importante da configuração — um prompt bem escrito faz toda a diferença na qualidade das respostas.

## Escrevendo um bom prompt

No editor de **Prompt** do agente, descreva:

* **Papel** — Quem o agente é (ex: "Você é o assistente de suporte da empresa X")
* **Tom de voz** — Como deve se comunicar (formal, informal, técnico, amigável)
* **Regras** — O que pode e não pode fazer (ex: "Nunca invente informações", "Sempre responda em português")
* **Formato** — Como estruturar as respostas (ex: "Use listas quando listar opções")

### Exemplo de prompt

```
Você é o assistente virtual da Loja ABC. Seu papel é ajudar clientes 
com dúvidas sobre produtos, pedidos e trocas.

Regras:
- Responda sempre em português, de forma educada e objetiva
- Use apenas informações da base de conhecimento
- Se não souber a resposta, diga que vai encaminhar para um atendente
- Nunca invente preços ou prazos
- Quando o cliente pedir para falar com um humano, encaminhe imediatamente

Tom: Amigável mas profissional. Use "você" em vez de "senhor/senhora".
```

## Referenciando recursos com /

O editor de prompts suporta o comando **/** (slash) para referenciar recursos do agente diretamente no prompt. Ao digitar `/`, um menu aparece com as opções disponíveis:

* **Tools** — Referencie uma ferramenta para que o agente saiba quando usá-la
* **Skills** — Referencie uma skill para contextualizar instruções
* **Sub-agentes** — Referencie um sub-agente para indicar quando delegar
* **Knowledge** — Referencie uma base de conhecimento específica

As referências ficam visíveis como chips no editor, tornando o prompt mais claro e vinculado aos recursos configurados.

## Variável `{{now}}`

Use `{{now}}` no prompt para inserir a data e hora atual automaticamente. A variável é substituída em tempo real a cada mensagem, permitindo que o agente saiba o momento exato da conversa.

```
Hoje é {{now}}. Use essa informação para responder perguntas 
sobre prazos, agendamentos e datas.
```

## Boas práticas

<Columns cols={2}>
  <Card title="Seja específico" icon="bullseye">
    "Responda em no máximo 3 frases" é melhor que "Seja breve".
  </Card>

  <Card title="Defina limites claros" icon="ban">
    Diga explicitamente o que o agente NÃO deve fazer.
  </Card>

  <Card title="Teste iterativamente" icon="arrows-rotate">
    Ajuste o prompt aos poucos com base nos resultados da aba de Teste.
  </Card>

  <Card title="Organize por seções" icon="list">
    Use títulos e listas para estruturar prompts longos.
  </Card>
</Columns>