获取符合 JSON Schema 的 Agent 结果

目标

让 Agent 返回可由应用校验的结构化结果。

步骤

1. 在 ClaudeAgentOptions.output_format 设置 {"type":"json_schema","schema":{...}}，定义必需字段及类型。 [types]
2. 运行任务并等待终态 ResultMessage；不要把流式文本片段拼接后当作结构化对象。 [types]
3. 读取 ResultMessage.structured_output，再执行业务规则校验、未知字段策略和缺失值检查。 [types]

验证方式

用合法与不合法样例核对字段类型，并确认应用拒绝语义无效或缺字段的结果。

故障处理

若 structured_output 为空，检查 CLI 是否支持当前 schema 模式及最终消息是否为 ResultMessage；不回退为盲目解析自然语言。