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
inputeinstructions. - 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.
Aprenda a criar prompts para que um modelo gere texto.
Conheça as ferramentas e técnicas de engenharia de prompt da OpenAI.