Structured-output prompt schemas escape non-ASCII text as \uXXXX
维护者通常 1 天内回复
评估
调研方向
阅读 packages/data-designer-engine/src/data_designer/engine/models/recipes/response_recipes.py,尤其是 schema 属性和 generate_response_example。使用 issue 中的泰语 pydantic 和 dict schema 示例复现问题,然后检查 response recipe 测试的覆盖情况。完成标准是 schema 文本保留非 ASCII 字符,同时仅含 ASCII 的 schema 保持不变。
由索引模型根据 Issue 内容生成。
描述
Priority Level
Medium (Annoying but has workaround)
Describe the bug
StructuredResponseRecipe.schema and PydanticResponseRecipe.schema serialize the JSON schema with json.dumps(...) and its default ensure_ascii=True:
packages/data-designer-engine/src/data_designer/engine/models/recipes/response_recipes.pyL113:return json.dumps(self.json_schema)- same file L185:
return json.dumps(self.data_type.model_json_schema())
That string is placed inside <response_schema> in the user prompt (L101 and L193). Any non-ASCII text in the schema (field descriptions, enum values, LLM-judge score descriptions and option labels) therefore reaches the model as \uXXXX escapes rather than as readable text. This affects LLMJudgeColumnConfig (score rubrics are turned into a pydantic model) and LLMStructuredColumnConfig (output_format as a dict or a pydantic model) whenever the schema text is not ASCII, for example Thai, CJK, Cyrillic or accented Latin.
The same file already uses ensure_ascii=False in StructuredResponseRecipe.serialize_output (L116). Parsing a Thai response works today; only the prompt side is affected.
Steps/Code to reproduce bug
Against main at ba00b05, CPU only, no model needed:
import re
from data_designer.config.column_configs import LLMJudgeColumnConfig, LLMStructuredColumnConfig, Score
from data_designer.engine.column_generators.utils.prompt_renderer import create_response_recipe
judge = LLMJudgeColumnConfig(
name="j",
model_alias="m",
prompt="ให้คะแนน {{ x }}",
scores=[Score(name="accuracy", description="ประเมินความถูกต้อง", options={1: "ผิดทั้งหมด", 3: "ถูกต้องครบถ้วน"})],
)
p = create_response_recipe(judge).apply_recipe_to_user_prompt("ให้คะแนนคำตอบนี้")
print(p.rsplit("<response_schema>", 1)[1][:200])
print("escaped:", len(re.findall(r"\\u0e[0-9a-f]{2}", p)), "literal:", len(re.findall(r"[-]", p)))
st = LLMStructuredColumnConfig(
name="s",
model_alias="m",
prompt="x",
output_format={"type": "object", "properties": {"region": {"type": "string", "description": "ภาค", "enum": ["ภาคเหนือ", "ภาคใต้"]}}},
)
print(create_response_recipe(st).schema)
Output on main:
{"$defs": {"accuracy": {"description": "\u0e1b\u0e23\u0e30\u0e40\u0e21\u0e34\u0e19\u0e04\u0e27\u0e32\u0e21\u0e16\u0e39\u0e01\u0e15\u0e49\u0e2d\u0e07", ...
escaped: 42 literal: 16
{"type": "object", "properties": {"region": {"type": "string", "description": "\u0e20\u0e32\u0e04", "enum": ["\u0e20\u0e32\u0e04\u0e40\u0e2b\u0e19\u0e37\u0e2d", "\u0e20\u0e32\u0e04\u0e43\u0e15\u0e49"]}}}
The 16 literal Thai characters are the user's own instruction. Every Thai character from the rubric and the schema is escaped.
Expected behavior
The schema in <response_schema> keeps non-ASCII text as written, the way serialize_output already does:
{"$defs": {"accuracy": {"description": "ประเมินความถูกต้อง", ... "* 1: ผิดทั้งหมด\n* 3: ถูกต้องครบถ้วน"}}, ...
{"type": "object", "properties": {"region": {"type": "string", "description": "ภาค", "enum": ["ภาคเหนือ", "ภาคใต้"]}}}
ASCII-only schemas should stay byte-identical.
Agent Diagnostic / Prior Investigation
I investigated this with Claude Code (Anthropic) on a clone of main at ba00b05. I reviewed the findings and reran them myself.
- Root cause:
json.dumpsdefaults toensure_ascii=TrueinStructuredResponseRecipe.schema(L113) andPydanticResponseRecipe.schema(L185).StructuredResponseRecipe.generate_response_example(L109) has the same default. It has no production callers, but it is the documented example format for that recipe. - The
schemaproperty is used in only one place, the<response_schema>block oftask_instructions. Nothing hashes or caches it, so changing its serialization changes only the prompt text. - Size: for a three-option Thai judge rubric, the full user prompt is 623 prompt tokens on main and 315 with
ensure_ascii=False, as reported by a local vLLM server (Qwen3.6-35B-A3B tokenizer). The difference comes entirely from the escapes. - Live check: one request each way (temperature 0, thinking disabled). Both replies were valid fenced JSON and parsed with the recipe. One sample does not show a difference in judge quality, and I am not claiming one. What changes is what the model reads:
\u0e1c\u0e34\u0e14...on main,ผิดทั้งหมดwith the fix. - Duplicate search (issues and PRs, open and closed: "ensure_ascii", "non-ASCII", "unicode", "Thai", "escape", "multilingual", "response_schema"): no match. #800 is the only other
ensure_asciihit, and it is about JSONL scheduler events. #971/#972 changed parsing in the same recipes, not schema serialization. #1125 (open feature request: opt-in native schema-enforcement mode forLLMStructuredColumnConfig) is a different feature. No open PR touchesresponse_recipes.py. - Proposed fix: pass
ensure_ascii=Falsein the twoschemaproperties and ingenerate_response_example, and add parametrized tests (Thai pydantic model and Thai dict schema) that fail on main and pass with the change. That is +30/-3 lines. I have it ready and can open a PR once this issue is triaged.
Additional context
- Workaround: write rubrics, descriptions and enum values in English. That does not help when the enum values themselves have to be in the target language.
- Possible follow-up, not part of this fix:
engine/mcp/io.pyL502 and L531 alsojson.dumpsMCP tool results into text blocks with the defaultensure_ascii=True. I have not checked how those blocks reach the model, so I am leaving them out of this issue's scope. - Environment: Linux aarch64 (DGX Spark), Python 3.14.6 (
uv sync --all-packages --group dev), CPU-only reproduction.
Checklist
- I reproduced this issue or provided a minimal example
- I searched the docs/issues myself, or had my agent do so
- If I used an agent, I included its diagnostics above
- 主要语言
- Python
- 星标
- 2.4k
- 派生
- 243
- 平均合并
- 1 天 2 小时
- 30 天内合并 PR
- 86
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
NVIDIA-NeMo/DataDesigner 的其他 Issue
-
Default OpenAI reasoning/vision model `gpt-5` is retired on 2026-12-11可能已有人在做 @pcbeingused333 于 1 天前认领。 未关闭needs-discussion triaged
难度 2/5 1-3 小时 新手友好度 85/100
NVIDIA-NeMo/DataDesigner#1129 · 3 条评论 ·
维护者通常 1 天内回复
-
Allow huggingface-hub 2.x (widen cap from <2 to <3)可能已有人在做 @davanstrien 于 9 天前认领。 未关闭enhancement triaged
难度 2/5 1-3 小时 新手友好度 72/100
NVIDIA-NeMo/DataDesigner#1110 · 1 条评论 ·
维护者通常 1 天内回复
-
Local seed path containing a single quote breaks the DuckDB query可能重新可做 关联的 PR 已关闭且未合并。 未关闭bug triaged
难度 2/5 1-3 小时 新手友好度 67/100
NVIDIA-NeMo/DataDesigner#1102 · 3 条评论 ·
维护者通常 1 天内回复
-
enforce \from future import annotations` via ruff FA102 rule`可能已有人在做 @chethanuk 于 59 天前认领。 未关闭task
难度 2/5 1-3 小时 新手友好度 82/100
NVIDIA-NeMo/DataDesigner#760 ·
维护者通常 1 天内回复
-
Annotated Parquet reads can corrupt nested Arrow arrays with null children可能已有人在做 @lipikaramaswamy 今天认领。 未关闭bug
难度 4/5 3-5 天 新手友好度 56/100
NVIDIA-NeMo/DataDesigner#1143 ·
维护者通常 1 天内回复
查看 NVIDIA-NeMo/DataDesigner 的全部 Issue
相似的 Issue
-
area:models enhancement
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
SACGF/variantgrid#2737 · 1 条评论 ·
维护者通常 1 天内回复
-
RedisStorage writes can persist a key without its sliding TTL可能已有人在做 @lianbie 今天认领。 未关闭triage/confirmed
难度 2/5 1-3 小时 新手友好度 78/100
agentscope-ai/agentscope#3878 · 1 条评论 ·
维护者通常 2 天内回复
-
core
难度 2/5 1-3 小时 新手友好度 86/100
vectorize-io/hindsight#6458 ·
维护者通常 1 天内回复