For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal

Criação de prompts

Aprenda a criar prompts.

A criação de prompts é o processo de fornecer informações de entrada a um modelo. A qualidade da resposta geralmente depende de como você formula o prompt para o modelo.

Visão geral

Criar prompts é tanto uma arte quanto uma ciência. A OpenAI oferece estratégias e adota decisões de design da API para ajudar você a criar prompts eficazes e obter bons resultados de um modelo de forma consistente. Incentivamos você a experimentar.

Ferramentas e técnicas para criar prompts

  • Cache de prompts: Reutilize prefixos estáveis de prompts para reduzir a latência e os custos de tokens de entrada quando houver correspondência no cache
  • Engenharia de prompt: Conheça estratégias, técnicas e ferramentas para criar prompts

Refine seu prompt

  • Coloque as orientações gerais de tom ou papel na mensagem do sistema; mantenha os detalhes e exemplos específicos da tarefa nas mensagens do usuário.
  • Reúna os exemplos few-shot em um bloco conciso no estilo YAML ou em uma lista com marcadores para facilitar a leitura e a atualização pela equipe.
  • Reproduza a estrutura do projeto com nomes claros de pastas para que as pessoas da equipe encontrem os prompts rapidamente.
  • Execute seus testes de prompts e casos de avaliação a cada publicação; detectar problemas cedo custa menos do que corrigi-los em produção.

Prompts no seu aplicativo

Trate os prompts como código do aplicativo. Armazene o conteúdo dos prompts em módulos nomeados, crie seções dinâmicas com argumentos de função tipados e revise as alterações nos prompts nos mesmos pull requests que alteram o comportamento do produto que eles sustentam.

A OpenAI está descontinuando os objetos de prompt reutilizáveis na API. A criação de prompts terá menos destaque a partir de 3 de junho de 2026, e a desativação de v1/prompts está prevista para 30 de novembro de 2026. Consulte a página de descontinuações para ver o cronograma atual.

Para novos trabalhos, não crie objetos de prompt reutilizáveis. Em vez disso:

  • Mantenha cada prompt de produção em um módulo auxiliar versionado e gerenciado no código, como prompts/supportReply.ts.
  • Substitua as variáveis de prompt por parâmetros de função tipados ou objetos de entrada validados.
  • Passe as mensagens geradas diretamente para a Responses API por meio de input e instructions.
  • Cubra as alterações nos prompts com testes, dados de teste representativos e verificações de avaliação executadas junto com o processo de implantação.
  • Use o histórico do git, a revisão de PRs, as tags de versão e os sinalizadores de recursos para revisar, disponibilizar, comparar e reverter alterações nos prompts.

Se você já usa IDs ou versões de prompts nas solicitações à API, siga o guia de migração para mover esses prompts para o código.

Próximos passos

Quando sentir confiança nos seus prompts, você pode consultar os guias e recursos a seguir.

Geração de texto

Aprenda a criar prompts para que um modelo gere texto.

Crie prompts melhores

Conheça as ferramentas e técnicas de engenharia de prompt da OpenAI.