Tópico dedicado a explicar o conceito de **Prompt ID** no Playground…
INEMA
O Prompt ID é criado e gerenciado através da interface web da OpenAI, especificamente no Playground, e não diretamente via chamadas da API. Abaixo, explico passo a passo como você faz isso:
Onde você cadastra um Prompt ID na OpenAI?⌗
1. Acesse o Playground da OpenAI⌗
- Vá ao site da OpenAI e entre na seção Playground (também pode ser chamado de “Chat Playground”).
- No menu lateral, clique em Prompts e depois em Create New para começar a escrever seu prompt.
2. Crie e refine seu prompt⌗
- Escreva seu prompt, incluindo placeholders, exemplos, instruções, etc.
- Use a função Optimize (quando disponível) para melhorar o prompt — ela sugere ajustes de clareza, formato de saída, correções, e você pode aplicar com um clique. ([OpenAI Help Center][1])
3. Publique para gerar o Prompt ID⌗
- Quando estiver satisfeito com o prompt, clique em Publish.
- Isso “tranca” o texto e gera um Prompt ID. Você pode usar esse ID nas chamadas à API, em vez de enviar o texto completo. ([OpenAI Help Center][1])
4. Versionamento e edição futura⌗
- Após publicar, você pode continuar editando em um novo draft.
- Sempre que quiser que uma nova versão seja usada, clique em Update — isso gera uma nova versão com novo Prompt ID (ou atualiza a versão associada). ([OpenAI Platform][2])
- Você pode voltar a versões anteriores facilmente, bem como comparar saídas side-by-side.
5. Usando o Prompt ID na API⌗
Depois de publicar, você usa o Prompt ID assim:
POST /v1/responses
{
"model": "gpt-5",
"prompt_id": "seu_prompt_id_aqui",
"input": "Alguma pergunta..."
}
A API vai buscar o conteúdo do prompt salvo e aplicá-lo junto com o seu input.
Resumo visual⌗
| Etapa | Ação no Playground |
|---|---|
| Criar prompt | Prompts → Create New |
| Refinar prompt | Escrever, testá-lo, usar Optimize |
| Publicar prompt | Clicar em Publish → gera o Prompt ID |
| Atualizar prompt | Fazer edição → clicerar Update |
| Usar na API | Usar prompt_id no lugar do texto completo |
1. O que é o Prompt ID⌗
O Prompt ID é como se fosse um “rótulo/versão oficial” de um prompt que você publicou na OpenAI (ou outro sistema de hospedagem de prompts).
- Em vez de colar o texto inteiro do seu prompt toda vez, você pode salvar esse prompt e dar a ele um ID.
- Depois, quando precisar usá-lo, você só chama o ID, e a API puxa o texto completo que você cadastrou.
- Se você atualizar o prompt no servidor, o ID continua o mesmo, mas a versão do conteúdo muda.
2. Por que isso existe?⌗
Imagine que você tem um app que depende de prompts longos e complicados.
- Se você mudar o prompt, teria que atualizar o código do app.
- Com Prompt ID, você só altera o prompt no servidor, e todos os apps que usam esse ID passam a rodar com a versão nova automaticamente.
É um controle de versão para prompts, parecido com como usamos IDs de modelos (“gpt-5”, “gpt-4o”, etc.).
3. Como funciona na prática⌗
Exemplo (hipotético em JSON):
Criando/registrando um prompt⌗
{
"prompt_id": "protein-checker-v1",
"content": "Você é um agente especializado em análise de rótulos de proteína..."
}
Usando esse prompt no app⌗
POST /v1/responses
{
"model": "gpt-5",
"prompt_id": "protein-checker-v1",
"input": "Analise este rótulo (imagem anexa)."
}
→ A API vai buscar o conteúdo do prompt “protein-checker-v1” automaticamente e aplicá-lo.
4. Vantagens⌗
- Centralização: você atualiza o prompt em um só lugar.
- Escalabilidade: apps diferentes usam o mesmo prompt sem copiar/colar.
- Versionamento: você pode manter “v1”, “v2”, etc., e trocar qual é a versão default.
- Segurança: evita expor prompts muito grandes ou sensíveis no código.
5. Exemplo prático real (do caso do vídeo que você estudou)⌗
- O criador testou um prompt gigante para análise de proteínas (PDCAAS).
- Publicou como um Prompt ID (ex.:
"prompt_id": "protein-analysis-v2"). - No app, em vez de mandar aquele texto enorme, só chama o Prompt ID.
- Se amanhã ele quiser ajustar o critério de QA, basta alterar o prompt no servidor → o app já usa a versão nova.
Resumindo: O Prompt ID é como um “atalho” oficial para prompts complexos, permitindo versionar e atualizar sem mexer no código ou redeploy do app.
Prompt ID - Playground OPENAI
1