Skip to main content

Resposta curta

Trate a saída do modelo como texto não confiável. Peça JSON, preserve a resposta original, faça o parse local e valide o objeto com Pydantic. Se falhar, retorne um erro explícito ou faça uma única tentativa limitada de reparo. Essa abordagem não exige um parâmetro de saída estruturada específico do provedor. Ela também não garante JSON válido na primeira resposta.

Exemplo em Python

Instale OpenAI SDK e Pydantic e use a API OpenAI-compatible Chat Completions:
Copie o Model ID completo na praça de modelos. Guarde a BetterToken API Key em uma variável de ambiente, não no código-fonte.

Fluxo de validação

  1. Defina o menor schema necessário para a aplicação.
  2. Peça JSON sem adicionar campos fora do schema.
  3. Preserve a resposta original em local protegido se a política de dados permitir.
  4. Faça o parse com json.loads.
  5. Valide com model_validate.
  6. Retorne falha explícita ou faça uma tentativa limitada de reparo.
Não preencha valores ausentes silenciosamente, não invente defaults nem tente indefinidamente. O objeto reparado deve passar pelo mesmo schema.

O que verificar quando falhar

Pydantic valida o objeto no cliente. Ele não prova que valores factuais estão corretos. Adicione verificações de negócio para IDs, permissões, totais e regras do domínio.

Limite de capacidade

O contrato publicado de BetterToken Chat Completions documenta a solicitação OpenAI-compatible e a resposta em texto. Campos específicos de saída estruturada variam por modelo e rota. Não envie campo não documentado sem suporte explícito na referência atual.

Documentos relacionados