# Saída estruturada

> Fazer o modelo responder em um formato fixo e legível por máquina — JSON, uma tabela, campos identificados — em vez de prosa livre.

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

## O que significa

- Definição: saída estruturada significa que a resposta segue um formato predefinido, no qual um programa (ou um leitor com pressa) pode confiar. O JSON é o mais comum, mas uma lista fixa de títulos ou uma tabela também contam.
- Por que importa: texto livre é difícil de processar e varia de uma execução para outra. Uma estrutura fixa simplifica o código que vem depois e torna os resultados comparáveis.
- Como aplicar: descreva o formato exato (chaves e tipos, ou os nomes das colunas), diga o que fazer com valores ausentes e diga 'retorne apenas este formato'. Onde o modelo ou a API tiver um modo nativo de saída estruturada, use-o — é mais forte do que pedir em prosa.
- Sempre valide. Uma resposta pode estar bem formada e ainda assim errada, então confira tipos, intervalos e campos obrigatórios antes de usá-la.

## Exemplo

```text
Classifique cada chamado de suporte. Retorne SOMENTE um array JSON; um objeto por chamado:
{"id":"string","category":"billing|bug|feature_request|other","urgency":"low|medium|high","summary":"máx. 15 palavras"}
Se um chamado não estiver claro, use category "other" e urgency "low". Sem markdown, sem comentários.

Chamados:
"""[cole aqui]"""
```

[Abrir no Promptea](https://www.promptea.me/pt/analyzer?prompt=Classifique+cada+chamado+de+suporte.+Retorne+SOMENTE+um+array+JSON%3B+um+objeto+por+chamado%3A%0A%7B%22id%22%3A%22string%22%2C%22category%22%3A%22billing%7Cbug%7Cfeature_request%7Cother%22%2C%22urgency%22%3A%22low%7Cmedium%7Chigh%22%2C%22summary%22%3A%22m%C3%A1x.+15+palavras%22%7D%0ASe+um+chamado+n%C3%A3o+estiver+claro%2C+use+category+%22other%22+e+urgency+%22low%22.+Sem+markdown%2C+sem+coment%C3%A1rios.%0A%0AChamados%3A%0A%22%22%22%5Bcole+aqui%5D%22%22%22&purpose=data&target=gemini)

## Perguntas frequentes

### Todos os modelos atuais têm saída estruturada nativa?

Não. Depende do modelo e da API. As páginas de modelos do Promptea mostram, para cada modelo atual, se a documentação do provedor indica saída estruturada, com a data de verificação.

### E se o modelo colocar texto em volta do JSON?

Diga 'retorne apenas JSON, sem markdown, sem comentários', dê um exemplo e processe de forma defensiva (tente de novo ou repare em caso de falha) em vez de presumir uma saída perfeita.

## 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)
- [JSON schema](https://www.promptea.me/pt/glossary/json-schema)
- [Few-shot prompting](https://www.promptea.me/pt/glossary/few-shot)
