Como escrever um bom prompt: quais são os 4 pilares do prompt perfeito?

Passo a passo

1. Defina o papel

   Comece dizendo que função ou tom a IA deve assumir. Exemplo: "Você é um professor paciente que explica tecnologia para iniciantes."

   A documentação da OpenAI recomenda colocar essa orientação geral de tom ou papel na mensagem de sistema, quando você usa a API. No chat, basta escrever isso no início do pedido. (OpenAI Developers, Prompting)

2. Diga a tarefa com clareza

   Escreva o que precisa ser feito, com um verbo direto. Exemplo: "Explique o que é uma alucinação de IA, ou seja, uma resposta inventada com confiança."

   O guia da Microsoft sobre Azure OpenAI mostra a diferença na prática: um pedido simples gera um texto genérico. Um pedido com detalhes gera um texto bem mais próximo do que a pessoa queria. (Microsoft Learn)

3. Entregue o contexto

   O contexto são as informações de que a IA precisa: para quem é o texto, qual é a situação, quais dados usar. Exemplo: "O texto é para pessoas que nunca usaram um chat de IA e vão ler no celular."

   Se você tem um documento ou dados, cole ou anexe e diga que a resposta deve se basear neles. A OpenAI recomenda deixar o contexto explícito e separado da instrução. (OpenAI, Prompt engineering)

   Antes de colar qualquer material, pense no que você está entregando à ferramenta. Evite dados pessoais ou sigilosos.

4. Peça um formato

   Diga como a resposta deve vir: lista, tabela, parágrafos curtos, tom formal ou informal, tamanho aproximado. Exemplo: "Responda em uma lista curta, com linguagem simples, e termine com uma dica prática."

   A OpenAI recomenda explicitar o resultado desejado, a extensão, o formato e o estilo. (OpenAI Help Center)

5. Mostre um exemplo do que você quer

   Quando o formato importa, mostre um modelo de resposta além de descrevê-lo. A OpenAI chama isso de "mostrar e dizer": você combina a instrução explícita com um exemplo da saída esperada. (OpenAI Help Center)

6. Junte tudo e teste em mais de um modelo

   Um prompt completo com os quatro pilares fica assim:

   > Você é um professor paciente que explica tecnologia para iniciantes. Explique o que é uma alucinação de IA. O texto é para pessoas que nunca usaram um chat de IA e vão ler no celular. Responda em uma lista curta, com linguagem simples, e termine com uma dica prática.

   Rode o mesmo pedido em mais de uma ferramenta e compare as respostas. Cada modelo se comporta de forma diferente, e o que funciona em um pode não funcionar igual no outro. (Microsoft Learn)

7. Ajuste e confira

   Se a resposta não veio como você queria, mude um pilar de cada vez. Por exemplo, acrescente contexto ou deixe o formato mais preciso. Depois peça de novo.

   Em temas de saúde, dinheiro, lei ou fatos, confira a resposta em uma fonte confiável antes de usar. Nessas áreas, procure um profissional quando a decisão for sua.

Quais são os 4 pilares do prompt perfeito?

Em uma frase: papel, tarefa, contexto e formato.

• Papel: a função, o comportamento ou o tom que a IA deve adotar.
• Tarefa: o que deve ser feito, de forma específica.
• Contexto: as informações, os dados ou o material necessários para a tarefa.
• Formato: a estrutura, a extensão, o estilo ou o esquema da resposta.

A documentação atual da OpenAI não usa a palavra "pilares". Ela recomenda deixar explícitos o contexto, o resultado desejado, a extensão, o formato e o estilo, e separar a orientação de papel das instruções da tarefa. Isso corresponde aos quatro pilares. (OpenAI, Prompt engineering, OpenAI Developers, Prompting, verificado em nov/2026)

"Perfeito" é força de expressão. Os pilares aumentam a chance de uma boa resposta, mas não garantem o resultado. Você ainda precisa testar e conferir.

De onde vem esse método de prompt?

Existem vários "frameworks" de prompt com nomes próprios, como RICCE, RACE, RISEN, COSTAR e RICECO. Um preprint publicado no arXiv, ou seja, um artigo ainda sem revisão por pares, comparou esses frameworks e encontrou elementos que se repetem entre eles. A síntese do autor se chama PICCO: persona, instruções, contexto, restrições e saída. (arXiv, preprint)

O mesmo estudo observa que vários desses frameworks não têm origem acadêmica clara. Eles surgiram entre entusiastas de IA e foram adotados pela comunidade. Os quatro pilares são uma versão enxuta dessa convergência: os elementos que quase todos os métodos têm em comum.

O guia da Microsoft lembra que montar um prompt é "mais uma arte do que uma ciência" e pede experiência e testes. (Microsoft Learn)

Muda conforme o modelo?

Sim. O que o material oficial disponível mostra, verificado em nov/2026:

• OpenAI: modelos de raciocínio x modelos GPT. A documentação da OpenAI diz que esses dois tipos podem responder melhor a estilos de prompt diferentes. Por isso ela recomenda adaptar a estratégia ao tipo de modelo. O gpt-6-astra, descrito como modelo de raciocínio, se beneficia de orientações explícitas sobre papel, fluxo de trabalho, uso estruturado de ferramentas e testes de correção. (OpenAI, Prompt engineering)
• ChatGPT x API da OpenAI. No ChatGPT, você escreve os quatro pilares no próprio pedido. Na API, a OpenAI recomenda separar as partes por papéis de mensagem. As instruções de desenvolvedor têm prioridade sobre as mensagens do usuário. O tom ou papel vai na mensagem de sistema, e os detalhes da tarefa e os exemplos vão na mensagem do usuário. (OpenAI Developers, Prompting)
• Azure OpenAI no Microsoft Foundry. O guia de técnicas da Microsoft organiza o prompt em componentes como instruções e contexto, enviados com as funções sistema, usuário e assistente. O próprio guia avisa que essas técnicas não são recomendadas para modelos de raciocínio. Ou seja, o mesmo pedido pode precisar de outra forma conforme o tipo de modelo. (Microsoft Learn)

O que muda: principalmente a forma do pedido e onde cada pilar entra. Os pilares em si continuam os mesmos.

O que ainda não sabemos: as fontes usadas aqui não trazem diferenças de preço ou de privacidade ligadas ao prompt. Também não trazem testes públicos com método que mostrem uma estrutura de prompt superando outra em modelos específicos. Este guia também não traz a orientação atual de outros laboratórios, como Anthropic e Google, nem de opções abertas ou locais. Quando houver fonte oficial conferida, ela entra aqui.

Como usar os 4 pilares em produção, pela API?

🚀 Para quem já é mais avançado, a documentação da OpenAI (atualizada entre 11 de outubro de 2026 e 13 de novembro de 2026) recomenda:

• Dados dinâmicos com estrutura. Use argumentos tipados ou esquemas, em vez de inserir valores variáveis soltos no texto do prompt.
• Prompts versionados no código. Rode testes e casos de avaliação toda vez que publicar um prompt.
• Avaliações ao trocar de modelo. Use avaliações para monitorar mudanças de comportamento quando mudar a versão do modelo.

Atenção a uma mudança de plataforma: segundo a documentação, a criação de prompts foi despriorizada a partir de 3 de junho de 2026, e a API `v1/prompts` tem encerramento programado para 30 de novembro de 2026. (OpenAI, Prompt engineering, OpenAI Developers, Prompting)

Erros comuns

• Escrever só a tarefa, sem contexto nem formato, e esperar uma resposta sob medida.
• Misturar instrução, dados e exemplo num bloco só, sem deixar claro o que é cada parte.
• Achar que um prompt funciona igual em todos os modelos: modelos de raciocínio e modelos GPT podem responder melhor a estilos diferentes.
• Descrever o formato desejado sem mostrar nenhum exemplo dele.
• Colar dados pessoais ou sigilosos no contexto sem pensar no que a ferramenta recebe.
• Confiar em "frameworks de prompt" sugeridos pela própria IA sem conferir: um estudo encontrou frameworks inventados, isto é, alucinações.
• Usar uma resposta sobre saúde, dinheiro ou lei sem conferir em fonte confiável.