31 lines (19 loc) · 863 Bytes

03. Structured Output

运行：

pnpm lesson:03

本课目标

学习如何让 agent 输出可被程序继续消费的对象，而不是只能人工阅读的文本。

观察代码

文件：src/lessons/03-structured-output.ts

重点看：

LearningCard：用 Zod 定义最终输出结构。
outputType: LearningCard：告诉 agent 最终输出必须符合这个结构。
result.finalOutput：此时是结构化对象。

什么时候用

生成任务列表、表单草稿、配置建议。
后续程序要读取字段，例如 concepts 或 exercises。
想减少“模型说得像 JSON 但不是合法 JSON”的问题。

兼容服务提醒

一些 OpenAI-compatible 服务对结构化输出支持不完整。如果本课失败，先确认服务是否支持 tool/function calling 或 JSON schema 类能力。