Como forçar uma saída em JSON válido (sem markdown)

Templates para extrair e transformar dados em JSON estrito, com regras de validação.

Última atualização: · Versão em Markdown

Regras que funcionam

  • Diga: 'Retorne SOMENTE JSON' e proíba texto extra.
  • Defina um esquema (chaves, tipos, valores permitidos).
  • Diga o que fazer com campos ausentes (null ou omitir).
  • Peça uma segunda passada: validar + corrigir o JSON.

Antes → depois: de 'me dê um JSON' a um contrato

  • Antes: "Me dê os dados de contato deste e-mail em JSON." Resultado típico: uma frase de introdução, um bloco de código markdown e chaves que mudam de uma execução para outra.
  • Depois: "Extraia os dados de contato. Retorne SOMENTE JSON válido, sem markdown. Esquema: {name: string, email: string|null, phone: string|null}. Use null para tudo o que faltar; não adivinhe."
  • O que mudou: a saída é um esquema definido, com uma regra para valores ausentes e a proibição de texto extra, então o mesmo prompt entrega sempre o mesmo formato.

Valide no código, não na esperança

  • Processe a resposta com um parser de JSON de verdade e confira com o esquema (chaves obrigatórias, tipos, valores permitidos) antes de usá-la.
  • Em caso de falha, tente mais uma vez anexando o erro: 'Sua saída anterior falhou na validação: [erro]. Retorne apenas o JSON corrigido.'
  • Onde o modelo ou a API oferecer um modo nativo de saída estruturada, use-o: o formato passa a ser imposto na geração, em vez de pedido em prosa. As páginas de modelos do Promptea mostram quais modelos atuais o oferecem.
  • JSON válido não é necessariamente conteúdo correto. Confira por amostragem os valores com o texto-fonte, principalmente números e datas.

Para conferir se um prompt de JSON nomeia os campos, os tipos e a regra do null antes de rodá-lo, use o analisador de prompts.

Templates

Extrair JSON estruturado

Extraia os dados do texto abaixo.
Retorne SOMENTE JSON válido (sem markdown, sem comentários).

Esquema:
{
  "people": [
    {
      "name": "string",
      "role": "string|null",
      "email": "string|null"
    }
  ],
  "dates": ["YYYY-MM-DD"]
}

Regras:
- Se faltar, use null (não invente).
- Se uma data for ambígua, omita.

Texto:
"""[cole aqui]"""

Antes de finalizar, valide se a saída é um JSON válido e segue o esquema.
Abre o analisador com o prompt já preenchido.

Transformar JSON para um novo esquema

Você vai receber um JSON de entrada. Converta-o para o esquema de saída.
Retorne SOMENTE JSON válido.

JSON de entrada:
"""[cole o JSON]"""

Esquema de saída:
{
  "items": [
    { "id": "string", "title": "string", "tags": ["string"] }
  ]
}

Regras:
- Preserve o sentido; não invente itens novos.
- Se um campo de entrada não tiver correspondência, ignore.
- Garanta que as tags fiquem em minúsculas.

Valide o JSON antes de retornar.
Abre o analisador com o prompt já preenchido.

Perguntas frequentes

Por que o modelo ainda coloca texto?
Porque você não deixou isso custoso. Repita a restrição, forneça um esquema e peça validação.
Devo usar JSON Schema?
Sim, em integrações estritas. Até um esquema simplificado (chaves + tipos) ajuda bastante.
O que o modelo deve retornar quando falta um valor?
Escolha uma regra e declare: null para o valor ausente ou omitir a chave. Misturar as duas obriga o seu código a tratar ambas. Diga também para não adivinhar.
Posso pedir JSON e uma explicação na mesma resposta?
Mantenha os dois separados: coloque a explicação em uma chave própria, como "notes", ou faça um segundo pedido. Texto fora do JSON quebra o parse.