langchain-structured-output

npx skills add majiayu000/claude-skill-registry --skill langchain-structured-output --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# langchain-structured-output (JavaScript/TypeScript) ## 概述 结构化输出将非结构化的模型响应转换为经过验证的、类型化的数据。不是解析自由文本，而是获得符合您模式的 JSON 对象——非常适合数据提取、构建表单或与下游系统集成。 **核心概念：** - **responseFormat**：定义预期的输出模式 - **Zod 验证**：具有自动验证的类型安全模式 - **withStructuredOutput()**：用于直接结构化输出的模型方法 - **工具策略**：对于不支持原生功能的模型，底层使用工具调用 ## 决策表 ### 何时使用结构化输出 | 使用场景 | 使用结构化输出？ | 原因 | |----------|------------------|------| | 提取联系信息、日期等 | ✅ 是 | 可靠的数据提取 | | 表单填写 | ✅ 是 | 验证所有必填字段 | | API 集成 | ✅ 是 | 类型安全的响应 | | 分类任务 | ✅ 是 | 枚举验证 | | 开放式问答 | ❌ 否 | 自由文本即可 | | 创意写作 | ❌ 否 | 不要限制创造力 | ### 模式选项 | 模式类型 | 使用时机 | 示例 | |---------|---------|------| | Zod 模式 | TypeScript 项目（推荐） | `z.object({...})` | | JSON 模式 | 互操作性 | `{ type: "object", properties: {...} }` | | 联合类型 | 多种可能的格式 | `z.union([schema1, schema2])` | ## 代码示例 ### 使用代理的基本结构化输出 ```typescript import { createAgent } from "langchain"; import { z } from "zod"; const ContactInfo = z.object({ name: z.string(), email: z.string().email(), phone: z.string(), }); const agent = createAgent({ model: "gpt-4.1", responseFormat: ContactInfo, }); const result = await agent.invoke({ messages: [{ role: "user", content: "提取：John Doe, john@example.com, (555) 123-4567" }], }); console.log(result.structuredResponse)