Engenharia de prompts — falar com as IA como um profissional — 1. Anatomia de um prompt que funciona

17 min read min de lecture
Capítulo 01

Anatomia de um prompt que funciona

Capítulo 1 de 10 · 10%

Objetivos deste capítulo

  • Identificar os 3 ingredientes de um prompt eficaz
  • Evitar a armadilha do prompt vago
  • Estruturar um pedido claro e reutilizável

Porque é que os teus prompts dececionam (e porque a culpa não é do modelo)

Segunda de manhã, a Sofia escreve: «Escreve um post de LinkedIn sobre o nosso novo produto». O resultado é uma papa de entusiasmo genérico, com fórmulas ocas que ela podia copiar e colar em qualquer empresa. Conclui que «a IA escreve mal». O diagnóstico está errado: o modelo fez exatamente o que lhe foi pedido — ou seja, quase nada de preciso.

Um modelo de linguagem não lê os teus pensamentos. Ele completa o teu texto com a continuação mais provável, tendo em conta o que lhe deste. Se lhe dás um pedido vago, a continuação mais provável é uma resposta vaga, mediana, consensual — a média estatística de tudo o que se parece com o teu pedido na Internet. A precisão do teu pedido é, portanto, a alavanca número um da qualidade, muito antes da escolha do modelo.

Esta é a boa notícia deste curso: não precisas de uma ferramenta melhor, precisas de uma melhor forma de pedir. E essa forma de pedir aprende-se, estrutura-se e reutiliza-se. Comecemos pela anatomia de base.

Contexto + Tarefa + Formato: os três ingredientes

Um prompt forte responde a três perguntas: quem és e em que situação (contexto/papel), o que deves fazer exatamente (tarefa precisa), em que forma entregar o resultado (formato de saída). Retira um dos três e a qualidade cai de forma visível.

O contexto enquadra o universo da resposta: o setor, a audiência, a situação, o tom da empresa. A tarefa define a ação esperada com um verbo preciso: redigir, resumir, comparar, classificar, reformular. O formato fixa a entrega: comprimento, estrutura, tom, o que incluir e excluir. Em conjunto, transformam uma lotaria numa encomenda precisa.

PROMPT
És um especialista em SEO. (papel)
Redige 5 títulos para um artigo sobre café de especialidade. (tarefa)
Formato: lista numerada, cada título < 60 caracteres, tom curioso. (formato)
flowchart LR
  C["Contexto / papel"] --> PR["Prompt estruturado"]
  T["Tarefa precisa"] --> PR
  F["Formato de saída"] --> PR
  PR --> Q["Saída de qualidade"]
  PR -.->|"Falta um ingrediente"| G["Saída genérica"]
A anatomia de um prompt: retira um dos três ingredientes e a qualidade cai.

O contexto: dar ao modelo o que ele não consegue adivinhar

O modelo conhece o mundo em geral, mas ignora tudo sobre a tua situação: a tua empresa, a tua audiência, a tua restrição da semana, o que já foi tentado. Tudo o que não dizes, ele inventa — e inventa de forma mediana. O contexto é a parte do prompt onde preenches essa lacuna.

Para a Sofia, um bom contexto parece-se com: «Somos uma PME de 40 pessoas que vende um software de gestão de horários a donos de restaurantes. A nossa audiência no LinkedIn: gerentes de restaurante sobrecarregados, pouco tecnológicos, sensíveis ao tempo poupado. Tom de marca: direto, concreto, nunca corporativo.» Três frases, e o modelo já não consegue produzir a mesma papa genérica de antes.

Regra prática: pergunta-te o que um novo colega brilhante, mas que chegou esta manhã, precisaria de saber para fazer a tarefa. É exatamente isso que o modelo também precisa de saber. Nem mais (não vale a pena contar a tua vida), nem menos.

A tarefa: um verbo de ação e um objetivo mensurável

«Fala-me de marketing» não é uma tarefa, é um tema. «Redige 3 acroches de LinkedIn para vender uma formação de marketing a freelancers sobrecarregados» é uma tarefa: um verbo (redige), uma quantidade (3), um entregável (acroches), um alvo (freelancers sobrecarregados) e um objetivo (vender).

Desconfia também das tarefas múltiplas escondidas numa única frase. «Resume este relatório e propõe ações e redige um email para a equipa» mistura três entregáveis: o modelo vai despachar pelo menos um deles. Separa em três pedidos, ou anuncia explicitamente as três partes esperadas com o respetivo formato.

O formato: o ingrediente mais esquecido

É o esquecimento mais frequente, e o mais caro. Sem formato, o modelo escolhe por ti: muitas vezes demasiado longo, estruturado em parágrafos onde querias uma lista, com um tom de assistente educado onde querias algo incisivo. Precisar o formato é evitar 80 % das idas e voltas de correção.

  • Comprimento: «máximo 120 palavras», «em 5 pontos», «uma única frase».
  • Estrutura: «lista numerada», «tabela de 3 colunas», «título + 2 parágrafos + chamada à ação».
  • Tom: «direto e concreto», «caloroso sem ser familiar», «neutro e factual».
  • Inclusões/exclusões: «sem jargão técnico», «sem pontos de exclamação», «inclui um número em cada ponto».
Quando um resultado dececiona, pergunta-te qual dos 3 ingredientes falta. É quase sempre um deles — e, na maioria das vezes, o formato.

A armadilha do prompt vago: um antes/depois

Vejamos a diferença no caso real da Sofia. Versão vaga:

PROMPT
Escreve um post de LinkedIn sobre o nosso novo produto.

Resultado: «Temos o prazer de anunciar o lançamento do nosso novo produto revolucionário...» — enchimento intercambiável, zero informação, tom corporativo que ninguém lê. Agora a versão estruturada:

PROMPT
Contexto: somos uma PME que vende um software de gestão de horários a donos de restaurantes. Audiência no LinkedIn: gerentes de restaurante sobrecarregados, pouco tecnológicos. Tom de marca: direto, concreto, nunca corporativo.

Tarefa: redige um post de LinkedIn a anunciar a nossa nova funcionalidade «substituição num clique» (encontrar um substituto quando um empregado de mesa está doente, num clique em vez de 12 telefonemas).

Formato: 80-120 palavras, gancho na primeira linha sob a forma de pergunta, 1 benefício quantificado, chamada à ação final, nenhum ponto de exclamação, sem hashtags.

Mesmo modelo, mesmo dia, mesma funcionalidade. A segunda versão produz um post publicável quase tal e qual. A diferença não vem da ferramenta: vem das informações e das salvaguardas que o prompt fornece. A precisão não é opcional, é a alavanca principal.

Prompt de sistema vs prompt de utilizador

Na maioria das ferramentas (ChatGPT, Claude, as API), existem dois níveis de instrução. O prompt de sistema (ou «instruções personalizadas») define o comportamento permanente: quem é o assistente, o seu tom, as suas regras. O prompt de utilizador é o teu pedido do momento. O de sistema pesa mais e persiste durante toda a conversa.

Concretamente: se a Sofia repete em cada mensagem «tom direto, nunca corporativo, sem pontos de exclamação», está a desperdiçar tempo. Essas regras permanentes têm o seu lugar nas instruções de sistema ou personalizadas da ferramenta. O prompt de utilizador passa a conter apenas o que muda: a tarefa do dia e o seu formato. É também a base dos «GPTs» personalizados e dos assistentes configurados em empresa.

Se usas o mesmo enquadramento em todos os teus prompts, move-o para as instruções personalizadas da tua ferramenta. Vais escrever prompts duas vezes mais curtos para o mesmo resultado.

Estruturar para clarificar (e preparar o que vem a seguir)

Separa visualmente as partes do teu prompt: um bloco de contexto, um bloco de tarefa, um bloco de restrições. Usa intertítulos («Contexto:», «Tarefa:», «Formato:») ou delimitadores como --- ou etiquetas para isolar um texto a tratar do resto das instruções. O modelo segue melhor, e tu relês melhor.

Esta disciplina tem um segundo benefício, que exploraremos no capítulo 5: um prompt estruturado em blocos transforma-se num template reutilizável em dois minutos. Um prompt escrito de um só jato confuso terá de ser reescrito de cada vez. Estruturar hoje é capitalizar para amanhã.

Quando colas um texto longo a tratar (email, artigo, relatório), delimita-o claramente: «Eis o texto entre ---» … «--- Fim do texto». Sem delimitador, o modelo confunde por vezes as tuas instruções com o conteúdo a tratar.
🛠️ É a tua vez

Contexto

A Sofia tem de anunciar um webinar «gerir o horário em período de pico» destinado a donos de restaurantes. O seu primeiro prompt — «escreve um email para anunciar o nosso webinar» — produziu um texto chato, demasiado longo e sem nenhuma informação concreta. Ela tem os detalhes do evento (data, duração, orador, 3 pontos abordados) mas nunca os deu ao modelo. Cabe-te a ti reconstruir o pedido dela com os três ingredientes.

Instruções

  1. Pega num prompt vago que uses frequentemente (ou no da Sofia acima).
  2. Escreve o bloco Contexto: quem és, a tua audiência, a tua situação, o teu tom de marca (3-4 frases).
  3. Escreve o bloco Tarefa: um verbo de ação, um entregável preciso, um alvo, um objetivo.
  4. Escreve o bloco Formato: comprimento, estrutura, tom, inclusões e exclusões explícitas.
  5. Lança as duas versões (vaga e estruturada) e compara as saídas lado a lado.
  6. Anota qual ingrediente faltava mais na versão vaga e o que a sua presença mudou.
  7. Move as regras permanentes (tom, interdições) para as instruções personalizadas da tua ferramenta.
Dica — O formato de saída (comprimento, estrutura, tom) é o ingrediente mais frequentemente esquecido. Se hesitares, começa por ele: é o ganho mais rápido.

Em resumo

  • Um bom prompt = contexto + tarefa precisa + formato: retira um ingrediente e a qualidade cai.
  • O modelo não adivinha a tua situação: tudo o que não dizes, ele inventa — e inventa de forma mediana.
  • Uma tarefa = um verbo de ação + um entregável + um alvo; evita empilhar várias tarefas numa frase.
  • O formato (comprimento, estrutura, tom, interdições) é o esquecimento mais frequente e mais caro.
  • O prompt de sistema transporta as regras permanentes; o prompt de utilizador transporta o pedido do momento.
  • Delimita claramente os textos a tratar (---) para não os confundir com as tuas instruções.
  • Um prompt estruturado em blocos relê-se, corrige-se e transforma-se facilmente em template.

Quiz — verifica a tua compreensão

1. Quais são os 3 ingredientes de um bom prompt?

Quem és, o que fazer, em que forma: os três pilares de um pedido preciso.

2. Qual é o ingrediente mais frequentemente esquecido?

Esquecemo-nos muitas vezes de precisar comprimento, estrutura e tom esperados — e o modelo escolhe então por ti.

3. Porque é que um prompt vago produz uma resposta genérica?

Sem precisão, a resposta mais provável é a média de tudo o que se parece com o teu pedido: algo genérico.

4. Onde colocar uma regra permanente como «nunca tom corporativo»?

O prompt de sistema persiste durante toda a conversa: é o lugar das regras que não mudam.

5. Para que servem os delimitadores como --- à volta de um texto colado?

Sem delimitador, um texto longo colado pode ser interpretado como instruções. Delimitá-lo elimina a ambiguidade.

Auteur(s)

R

REHOUMA Haythem

Haythem Rehouma est un ingénieur et architecte IA et cloud, formateur et enseignant technique, avec un profil orienté IA médicale, AWS, MLOps, LLM/RAG et vision par ordinateur.