Visão geral

Nossa atualização mais recente do Playground apresenta um fluxo de trabalho estruturado e fácil de reverter, para que você possa iterar com confiança, validar alterações e passar do experimento à produção em menos etapas. Abaixo está um tour rápido do que está sendo lançado e de como começar.

Novidades

Prompts no nível do projeto

Os prompts agora são de nível de projeto, não mais de usuário.

Histórico de versões com reversão em um clique

Publique qualquer rascunho para criar uma nova versão e, depois, restaure uma versão anterior instantaneamente. Nos bastidores, um único Prompt ID sempre aponta para a versão publicada mais recente, e você também pode especificar uma versão específica se quiser uma referência fixada.

Variáveis de prompt

Adicione placeholders como {user_goal} para ajudar a separar o prompt estático das informações específicas da instância (entradas).

Prompt ID

A publicação bloqueia o rascunho atual em um ID que ferramentas downstream podem chamar de forma confiável enquanto você continua iterando em novos rascunhos.

Comparação lado a lado

Compare visualmente as saídas de duas versões para decidir qual tem melhor desempenho antes de lançar.

Variáveis reconhecidas na API e no SDK

A Responses API e o Agents SDK agora aceitam as mesmas {variables} que você define no Playground, então o prompt que você testa é o que invoca programaticamente — por enquanto, basta passar o texto renderizado.

Integração integrada com Evals (execuções manuais)

Vincule uma Eval para pré-preencher variáveis e ver resultados de aprovação/reprovação diretamente na página de detalhes do prompt. O link é salvo com o Prompt ID para testes repetíveis.

Otimizar

O Otimizar é uma nova ferramenta disponível nas páginas Playground e Logs que melhora prompts automaticamente ao detectar e corrigir contradições, instruções pouco claras e formatos de saída ausentes.

Ao ser executado, ele retorna uma versão aprimorada do seu prompt ou sugestões úteis, junto com um resumo das alterações feitas. Você pode pré-visualizar as revisões e aplicá-las diretamente no Playground com um único clique.

---

Guia de início rápido

Crie um prompt

Acesse Playground → Prompts → Criar novo, rascunhe seu texto e adicione {variables} se necessário.

Você pode usar o recurso gerar para que o ChatGPT sugira um prompt, uma definição de função ou um schema de saída com base na descrição da sua tarefa.

Use o recurso otimizar para revisar e sugerir melhorias.

Adicione uma função (opcional)

A chamada de função permite conectar seu prompt a ações ou dados do mundo real sem sair do Playground.

Para instruções adicionais sobre o uso de funções, consulte nosso artigo: Chamada de função no Chat Playground

Anexe uma Eval (opcional)

Escolha Vincular Eval para gerar dados de teste, executar avaliadores e revisar resultados de aprovação/reprovação. Execute a Eval novamente após cada publicação para detectar regressões até que as execuções automáticas cheguem.

Publicar

Clique em Publicar para criar um Prompt ID. Continue experimentando em um novo rascunho e restaure qualquer versão publicada em Histórico com um clique.

Iterar

Teste seu novo prompt, revise os resultados e itere conforme necessário.

Dicas para criar ótimos prompts

Coloque orientações gerais de tom ou função na mensagem System; mantenha detalhes e exemplos específicos da tarefa nas mensagens User.

Combine exemplos few-shot em um bloco conciso no estilo YAML ou com marcadores para facilitar a leitura e a atualização.

Espelhe a estrutura do seu projeto com nomes de pastas claros para que colegas de equipe encontrem prompts rapidamente.

Execute novamente sua Eval vinculada sempre que publicar — detectar problemas cedo é muito mais barato do que corrigi-los em produção.

---

Perguntas frequentes

Minhas predefinições existentes vão parar de funcionar?

Prompts são uma forma mais poderosa de gerenciar configurações com suporte a versionamento e variáveis de modelo. Todas as suas predefinições existentes podem ser importadas para Prompts usando a opção "Importar predefinição" no menu suspenso de prompts do Playground.

Preciso especificar uma versão no código?

Somente se você quiser fixar uma versão mais antiga. Chamar o Prompt ID sozinho sempre usa a versão mais recente.

Posso automatizar execuções de Eval?

Atualmente, só há reexecuções manuais disponíveis.