跳转到主要内容
在结构化输出请求中添加 response-healing 插件,Phaseo 就会在 JSON 到达你的解析器之前修复几乎有效的 JSON,例如包在 Markdown 代码块中或带有尾随逗号的 JSON。完成后,你会得到一个请求:它要求 JSON Schema,在需要时修复回答,并在响应中告诉你是否进行了修复。 该请求可直接用于生产环境。修复只处理语法,所以你的代码仍需验证结果,做法参见验证结果。

发送带修复的请求

在 Chat Completions 中,请把同样的 schema 放在 response_format 而不是 text.format 中发送。只有当请求要求 json_object 或 json_schema 时才会运行修复,并且流式请求永远不会运行修复:流式请求会以 streaming_unsupported 跳过它。

检查它是否运行

使用 meta: true 时,插件运行后会出现在 meta.plugin_executions 中:
同样的记录也会出现在设置 → 用量 → 日志中的该请求上。如果插件始终没有出现,请检查请求、其预设或工作区是否真的开启了它;设置插件默认值说明了在哪里设置。

选择模式

使用 JSON Schema 时,修复后的结果在替换回答之前会先经过检查:必需键、类型、enum 和 const、数组边界和 uniqueItems、字符串长度、pattern 以及 email、uri、uuid 和 date-time 格式、数值边界和 multipleOf、属性数量,以及 additionalProperties: false。

了解它何时帮不上忙

修复绝不会编造缺失的字段、猜测值,或把散文转换为数据。在使用它之前,先分清以下几种失败: 修复最适合这样的情况:单个对象、明确的必需键、较低的 temperature,并且不要求 JSON 之外的文本。先为一个预设开启它,在日志中观察 plugin_executions,等修复后的数据符合你的 schema 后再扩大范围。
最后修改于 2026年11月5日