Criar prompts é formular a entrada que você fornece a um modelo. A qualidade da resposta costuma depender de como você formula o prompt.
Visão geral
Criar prompts envolve tanto arte quanto ciência. A OpenAI oferece estratégias e projetou a API para ajudar você a criar prompts eficazes e obter bons resultados de forma consistente. Experimente diferentes abordagens.
Ferramentas e técnicas para criar prompts
- Cache de prompts — Reutilize prefixos de prompts que se mantêm estáveis para reduzir a latência e o custo dos tokens de entrada quando o prefixo estiver no cache.
- Engenharia de prompt — Conheça estratégias, técnicas e ferramentas para criar prompts.
Refine seu prompt
- Use a mensagem de sistema para definir o tom geral ou o papel do modelo. Inclua os detalhes e exemplos específicos de cada tarefa nas mensagens do usuário.
- Reúna os exemplos few-shot em um bloco conciso, no estilo YAML ou em tópicos, para que sua equipe possa consultá-los e atualizá-los com facilidade.
- Use nomes de pastas claros que reflitam a estrutura do projeto para que sua equipe encontre os prompts rapidamente.
- Execute os testes de prompts e os 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 parte do 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 implementam o comportamento correspondente no produto.
A OpenAI está descontinuando os objetos de prompt reutilizáveis na API. A partir de 3 de junho de 2026, a criação desses prompts passa a ter menos destaque. A desativação de v1/prompts está prevista para 30 de novembro de 2026. Consulte o cronograma atualizado na página de descontinuações.
Para novos trabalhos, não crie objetos de prompt reutilizáveis. Siga estas orientações.
- Mantenha cada prompt de produção em um módulo auxiliar versionado e gerenciado junto com o código, como
prompts/supportReply.ts. - Substitua as variáveis dos prompts por parâmetros de função tipados ou objetos de entrada validados.
- Envie as mensagens geradas diretamente à API Responses por meio de
inputeinstructions. - Cubra as alterações nos prompts com testes, dados de teste representativos e verificações de avaliação que sejam executadas durante a implantação.
- Use o histórico do Git, a revisão de pull requests, as tags de versão e os sinalizadores de funcionalidades para revisar, publicar, comparar e reverter alterações nos prompts.
Se você já usa IDs ou versões de prompts nas requisições à API, siga o guia de migração para transferir esses prompts para o código.
Próximos passos
Quando você estiver confiante nos seus prompts, explore os guias e recursos a seguir.
Aprenda a usar prompts para que um modelo gere texto.
Conheça as ferramentas e técnicas de engenharia de prompt da OpenAI.