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
Theme

Criação de prompts

Aprenda a criar prompts.

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 input e instructions.
  • 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.

Geração de texto

Aprenda a usar prompts para que um modelo gere texto.

Crie prompts melhores

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