Guia Completo de Prompt Engineering para Iniciantes

Este é o documento principal da biblioteca de Prompt Engineering — do prompt improvisado a um sistema fiável que outras pessoas conseguem usar sem te perguntarem nada. Se procuras só os padrões de estrutura, ou um plano semana a semana, os recursos Guia Rápido: Estruturas de Prompt que Funcionam e Plano de Estudo Semanal cobrem isso — aqui o foco é o percurso completo.

O que é prompt engineering, na prática

É a diferença entre escrever uma frase a um assistente de IA e desenhar uma instrução que produz o mesmo tipo de resultado sempre que é usada, mesmo com entradas diferentes. Não é sobre encontrar frases mágicas — é sobre estrutura, contexto e forma de avaliar se está a funcionar.

Passo 1 — Dar contexto suficiente

Um modelo não sabe o que não lhe disseres. Papel (quem deve o modelo "ser"), objetivo, público-alvo e restrições fazem mais diferença do que qualquer truque de formulação. Um prompt vago produz uma resposta vaga.

Passo 2 — Definir o formato de saída

Se precisas de uma tabela, pede uma tabela. Se precisas de JSON com campos específicos, descreve-os um a um. Deixar o formato ao critério do modelo é a causa mais comum de teres de reformular a resposta depois de a receberes.

Passo 3 — Usar exemplos quando a instrução não chega

Quando descrever o que queres em palavras não é suficiente, mostra um ou dois exemplos de entrada e saída desejada dentro do próprio prompt. Isto costuma resolver ambiguidades que nenhuma instrução extra resolve sozinha.

Passo 4 — Testar com casos-limite, não só com o caso ideal

Um prompt que funciona bem com a entrada perfeita pode falhar com uma entrada incompleta, ambígua ou fora do que esperavas. Testa sempre com entradas difíceis antes de confiares num prompt para uso repetido.

Passo 5 — Avaliar e iterar em vez de adivinhar

Muda uma coisa de cada vez e compara resultados com os mesmos casos de teste. Sem um registo de versões e resultados, acabas a decidir por impressão em vez de dados — e a repetir os mesmos erros sem perceber porquê.

Erros comuns de quem começa

• Escrever um prompt, testar uma vez com um caso fácil e assumir que está pronto
• Não definir o formato de saída e depois perder tempo a reformatar a resposta manualmente
• Mudar várias partes do prompt ao mesmo tempo, tornando impossível saber o que resolveu o problema
• Pedir ao modelo para inventar dados, factos ou fontes quando falta informação, em vez de o instruir a dizer que não sabe
• Não guardar versões anteriores do prompt, perdendo a capacidade de comparar o que melhorou e o que piorou

Um prompt não é uma frase sortuda — é uma peça de engenharia que se testa, se mede e se revê como qualquer outra. Quem trata prompts como magia nunca sai do improviso.

Já tens as bases: contexto, formato, exemplos, casos-limite e avaliação. Usa os recursos abaixo — Guia Rápido: Estruturas de Prompt que Funcionam, Plano de Estudo Semanal e os templates de instrução de sistema e registo de avaliação — para continuares a praticar.