Pular para o conteúdo principal
Adicione o plugin response-healing a uma solicitação com saída estruturada e o Phaseo repara o JSON quase válido, como JSON dentro de um bloco de código Markdown ou com uma vírgula sobrando no final, antes que ele chegue ao seu parser. No fim, você tem uma solicitação que pede um JSON Schema, repara a resposta quando necessário e informa na resposta se fez isso. A solicitação está pronta para produção. O reparo só corrige a sintaxe, então o seu código ainda valida o resultado, como em Valide o resultado.

Envie uma solicitação com reparo

No Chat Completions, envie o mesmo schema em response_format em vez de text.format. O reparo só é executado quando a solicitação pede json_object ou json_schema, e nunca em streams: uma solicitação com streaming o pula com streaming_unsupported.

Confira se foi executado

Com meta: true, meta.plugin_executions lista o plugin quando ele foi executado:
O mesmo registro aparece na solicitação em Configurações → Uso → Registros. Se o plugin nunca aparece, confira se a solicitação, a predefinição dela ou o espaço de trabalho realmente o ativaram; Defina padrões de plugins mostra onde.

Escolha um modo

Com um JSON Schema, o resultado reparado é verificado antes de substituir a resposta: chaves obrigatórias, tipos, enum e const, limites de arrays e uniqueItems, tamanho de strings, pattern e os formatos email, uri, uuid e date-time, limites numéricos e multipleOf, quantidade de propriedades e additionalProperties: false.

Saiba quando ele não ajuda

O reparo nunca inventa campos que faltam, não adivinha valores nem transforma prosa em dados. Distinga estas falhas antes de recorrer a ele: O reparo funciona melhor com um único objeto com chaves obrigatórias explícitas, temperatura baixa e sem pedido de texto fora do JSON. Ative-o primeiro em uma predefinição, acompanhe plugin_executions nos registros e amplie o uso quando os payloads reparados corresponderem ao seu schema.
Última modificação em 5 de novembro de 2026