Um prompt que você reescreve inteiro toda vez não é um prompt, é uma mensagem. O que transforma um comando em ferramenta é isolar a parte que muda e deixar o resto congelado.
Onde entra a variável
Variável entra no dado, nunca na instrução. O que muda de rodada para rodada é o público, o produto, o texto colado, o número. O que não muda é o papel, o formato e a restrição.
Papel: você é um redator de e-mail de retenção.
Contexto:
- Cliente: {{nome_do_cliente}}
- Plano: {{plano}}
- Motivo do cancelamento informado: {{motivo}}
- Tempo de casa: {{meses}} meses
Tarefa: escreva o e-mail de resposta ao pedido de cancelamento.
Formato: assunto com até 45 caracteres, corpo com no máximo 5 linhas, uma pergunta no fim.
Restrições:
- Não ofereça desconto se {{meses}} for menor que 3.
- Não use a palavra "infelizmente".Repare que a instrução ficou inteira fora das chaves. Se você começar a variabilizar o formato, o template vira formulário e perde a vantagem de ser confiável.
Como nomear
Nome de variável é rótulo de campo, não abreviação. {{motivo}} funciona, {{m}} não, {{motivo_do_cancelamento_informado_pelo_cliente}} também não, porque ninguém vai preencher isso duas vezes.
| regra | exemplo bom | exemplo ruim |
|---|---|---|
| substantivo curto | {{publico}} | {{quem_vai_ler_isso}} |
| sem acento e sem espaço | {{numero_de_linhas}} | {{número de linhas}} |
| unidade no nome quando houver | {{prazo_em_dias}} | {{prazo}} |
| um conceito por variável | {{cidade}} e {{estado}} | {{cidade_estado}} |
Quantas cabem
Até cinco ou seis, o template continua rápido de preencher. Acima disso, quem for usar vai desistir no meio ou preencher qualquer coisa nos últimos campos, o que é pior que não ter o campo.
Quando você passar de seis, tem duas saídas. A primeira é agrupar: em vez de quatro variáveis sobre o produto, uma variável {{ficha_do_produto}} em que a pessoa cola o texto inteiro. A segunda é quebrar em dois prompts encadeados.
Valor padrão
Toda variável opcional precisa de um padrão escrito no prompt, senão o modelo trata {{tom}} vazio como parte do texto e responde sobre chaves duplas.
Se {{tom}} vier vazio, use tom neutro e informativo.
Se {{idioma}} vier vazio, responda em português do Brasil.Como testar antes de confiar
Três rodadas, com três entradas de propósito diferentes:
- A entrada típica, aquela para a qual você escreveu o prompt.
- A entrada mínima, com só o obrigatório preenchido e todo campo opcional vazio.
- A entrada de canto: texto muito curto, número zero, nome com acento, campo com duas frases quando você esperava uma palavra.
Se a terceira rodada quebrar o formato, falta restrição. Se a segunda vier genérica, falta valor padrão.
O erro que mais aparece
Colocar a variável dentro de uma frase que só faz sentido se ela estiver preenchida. "Considerando que o cliente mencionou {{motivo}}, responda" vira uma frase quebrada quando o motivo não veio. Escreva assim:
Motivo informado: {{motivo}}
Se o motivo estiver vazio, pergunte o motivo antes de responder.A instrução condicional na linha de baixo custa uma linha e resolve o caso vazio sem quebrar a leitura do resto.
