# JSON schema

> Uma descrição formal do formato de um documento JSON — chaves, tipos, campos obrigatórios, valores permitidos — usada para restringir e validar a saída do modelo.

Fonte: Promptea — https://www.promptea.me/pt/glossary/json-schema · Idioma: Português · Última atualização: 2026-11-09

## O que significa

- Definição: o JSON Schema é um vocabulário padrão para descrever JSON: quais chaves existem, seus tipos, quais são obrigatórias, enumerações, mínimos e padrões.
- Por que importa: é o contrato entre o modelo e o seu código. Até um esquema simplificado colado no prompt (chaves mais tipos) deixa a saída muito mais consistente.
- Como aplicar: no prompt, forneça o esquema, diga 'retorne SOMENTE JSON' e diga o que fazer com valores ausentes (null, não um palpite). Onde o provedor oferece saída estruturada, passe o esquema por ali, para que o formato seja imposto no momento da geração.
- Em produção, sempre valide o resultado contra o esquema e tente de novo ou rejeite em caso de falha; nunca presuma que um JSON válido significa conteúdo correto.

## Exemplo

```text
Extraia o pedido do texto. Retorne SOMENTE um JSON que siga este esquema:
{"orderId":"string","items":[{"sku":"string","qty":"number"}],"notes":"string|null"}
Se um campo não estiver no texto, use null. Não adivinhe.

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

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=Extraia+o+pedido+do+texto.+Retorne+SOMENTE+um+JSON+que+siga+este+esquema%3A%0A%7B%22orderId%22%3A%22string%22%2C%22items%22%3A%5B%7B%22sku%22%3A%22string%22%2C%22qty%22%3A%22number%22%7D%5D%2C%22notes%22%3A%22string%7Cnull%22%7D%0ASe+um+campo+n%C3%A3o+estiver+no+texto%2C+use+null.+N%C3%A3o+adivinhe.%0A%0ATexto%3A%0A%22%22%22%5Bcole+aqui%5D%22%22%22&purpose=data&target=gpt)

## Perguntas frequentes

### O esquema no prompt basta para garantir um JSON válido?

Ele torna o JSON válido provável, não garantido. Para ter garantias, use o recurso de saída estruturada do provedor, quando disponível, e valide o resultado no código.

### Devo pedir blocos de código markdown em volta do JSON?

Não, se um programa vai ler: diga 'retorne SOMENTE JSON, sem markdown' para que a saída possa ser processada diretamente.

## Relacionados

- [Como forçar uma saída em JSON válido (sem markdown)](https://www.promptea.me/pt/guides/json-output)
- [Prompts de saída estruturada: JSON, tabelas e listas confiáveis em qualquer IA](https://www.promptea.me/pt/guides/structured-output-prompting)
- [Few-shot prompting: mostre exemplos em vez de só explicar](https://www.promptea.me/pt/guides/few-shot-prompting)
- [Saída estruturada](https://www.promptea.me/pt/glossary/structured-output)
- [Few-shot prompting](https://www.promptea.me/pt/glossary/few-shot)
