Conteúdo do curso Lição 126 de 250 · Engenharia de prompts para engenheiros de IA
Engenharia de prompts para engenheiros de IA

Saída JSON estruturada + validação

No momento em que um LLM alimenta um sistema seguinte, texto livre vira um risco. Você pede JSON ao modelo e, depois, nunca deve confiar nele às cegas. Modelos emitem JSON malformado, esquecem campos e põem o tipo errado em um espaço. Um parser de produção supõe que tudo isso vai acontecer e verifica cada campo.

Você vai construir o validador que protege a fronteira. validate_record(text) recebe a string bruta que o modelo retornou e:

  • Tenta fazer json.loads dela dentro de um try/except, para que um JSON malformado retorne uma falha limpa em vez de derrubar o seu serviço.
  • Verifica o schema obrigatório {"name": str, "age": int, "email": str}: todo campo presente, todo valor do tipo certo.
  • Retorna {"ok": bool, "errors": [...]}, em que errors diz o que deu errado.

Há uma armadilha que pega quase todo mundo. Em Python, bool é uma subclasse de int, então isinstance(True, int) é True. O JSON true vira o Python True, e uma verificação de tipo ingênua aceitaria "age": true como um inteiro válido. Rejeite booleanos onde você exige um int.

>>> isinstance(True, int)
True            # the trap: True sneaks past an int check
>>> type(True) is int
False           # one way to be strict

Um modelo poderia preencher este JSON ao vivo para você, mas a avaliação só olha o seu validador determinístico: ele aceita um registro limpo e rejeita todo tipo de registro quebrado? Clique em Run para avaliar.

Sua vez

Escreva validate_record(text), que faz json.loads do texto dentro de um try/except e o valida com {"name": str, "age": int, "email": str}. Retorne {"ok": bool, "errors": [...]}: ok True com errors vazio para um registro completo e com os tipos certos; senão False com uma lista que nomeia cada problema. JSON malformado retorna ok False (sem exceção). Um booleano precisa ser rejeitado onde um int é exigido.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.