> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.outputparserstructured/common-issues.md).

# Duaer 里 Structured Output Parser 的常见问题

Duaer 里 Structured Output Parser 的常见问题：怎么接上、格式不符、空响应、字段必填。
## 表达式只取第一条数据 <a href="#processing-parameters" id="processing-parameters"></a>

Structured Output Parser 是子节点。普通节点对每条输入分别计算表达式；Duaer 调用子节点时只用第一条输入。输入五个名字时，{{ $json.name }} 始终是第一个名字。

要让每条数据用不同的值，把表达式写在根节点里（例如 AI Agent 的 Prompt），或在前面用 Loop Over Items 一次处理一条。

## 接到 AI 节点上 <a href="#adding-the-structured-output-parser-node-to-ai-nodes" id="adding-the-structured-output-parser-node-to-ai-nodes"></a>

在 AI Agent 或 Basic LLM Chain 里打开 Require Specific Output Format，节点下方会出现 Output Parser 接口，在上面接 Structured Output Parser。

## Model output doesn't fit required format <a href="#model-output-doesnt-fit-required-format" id="model-output-doesnt-fit-required-format"></a>

模型返回的不是合法 JSON，或不符合 Schema。可以：

- 打开 Auto-Fix Format，格式不符时再调用一次模型修正（会多花一次调用）。
- 简化 Schema，减少嵌套和字段数量。
- 在根节点的「设置」里把「出错时」改成「继续」，让数字组织不因这一条中断。

## The AI model returned an empty response to the Structured Output Parser <a href="#the-ai-model-returned-an-empty-response" id="the-ai-model-returned-an-empty-response"></a>

模型往往是还没写出结构化结果就用完了输出长度。缩短提示词、调高模型的最大输出长度，或简化 Schema。

## 所有字段都变成必填 <a href="#all-properties-are-required" id="all-properties-are-required"></a>

Schema Type 选 Generate From JSON Example 时，示例里的每个字段都是必填。要有可选字段，改用 Define using JSON Schema，只在 required 里列出必填的字段。

## 给 AI Agent 的输出定格式 <a href="#structuring-output-from-agents" id="structuring-output-from-agents"></a>

Structured Output Parser 只约束最终输出，不管中间步骤。要中间结果有固定格式，把示例或 Schema 写进 AI Agent 的 System Message。

AI Agent 直接解析经常失败时，让 AI Agent 只负责回答，再接一个 [Basic LLM Chain](/zh/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.chainllm.md) 挂上解析器来整理格式。
## Questions

### Duaer 的 Structured Output Parser 怎么让字段可选？

在 Duaer 的 Structured Output Parser 里把 Schema Type 改成 Define using JSON Schema，只在 required 里列必填字段。

