# Dicas para bons pedidos

> Como pedir para o agente acertar de primeira.

Source: https://docs.bohr.io/pt-br/agent/tips/

O agente escreve para quem não programa, e funciona melhor com pedidos que dizem **o que** você quer e **onde**, em palavras simples.

## Faça

- **Diga o lugar.** *"Na página de preços, abaixo dos três planos…"* é melhor que *"adicione um aviso em algum lugar"*.
- **Descreva o resultado, não o código.** *"Os visitantes devem conseguir mandar uma mensagem com nome e e-mail, e a gente recebe por e-mail"*.
- **Dê o texto exato** quando as palavras importam: *"Mude o título para: Pão fresquinho toda manhã"*.
- **Uma mudança por pedido**, e depois ajuste. Pedidos pequenos são mais rápidos, mais baratos e mais fáceis de revisar.
- **Diga o que manter.** *"Mantenha as cores atuais"*, *"Não mude o menu"*.
- **Use pedidos seguintes.** O agente lembra a conversa até você aprovar ou descartar: *"Agora deixe menor no celular"*.
- **Cite os segredos pelo nome, nunca pelo valor.** *"Use a variável RESEND_API_KEY para mandar o e-mail"*, e depois adicione a variável em [Variáveis de ambiente](https://docs.bohr.io/pt-br/projects/variables/).

## Evite

- Colar senhas, chaves de API ou tokens no chat. O chat fica guardado e é compartilhado com todos os membros.
- Pedidos enormes e vagos (*"refaça o site inteiro"*). Divida em etapas.
- Pedir ao agente para fazer deploy ou merge: aprovar já faz isso.
- Pedir para ele mudar workflows do GitHub: ele não consegue (veja [o que ele pode fazer](https://docs.bohr.io/pt-br/agent/capabilities/)).

## Exemplos

> Adicione uma seção de perguntas frequentes no fim da página inicial com estas três perguntas e respostas: …

> O formulário de contato mostra um erro no celular. Corrija e confira se funciona em uma tela pequena.

> Adicione uma página /equipe com foto, nome e cargo de cada pessoa desta lista: …

> Crie um formulário de lista de espera que salve nome e e-mail no banco de dados, e uma página /admin protegida pela variável ADMIN_PASSWORD para ver as inscrições.

## Revise bem

- Abra a homologação também no **Celular**.
- Leia o resumo: ele lista o que conferir.
- Na dúvida, use **Ver as mudanças no GitHub**: mostra exatamente o que a aprovação publica.