从“自然语言”到“结构化数据”让程序真正读懂AI的回复01 引子经过前六篇的实战我们的AI已经能聊天、能记住上下文、能流式输出、能调用Java方法。但有一个问题始终存在AI返回的是自然语言文本程序无法直接使用。比如让AI“提取会议信息”它可能返回“明天下午3点有一个项目评审会在会议室A举行预计持续1小时。”这段文字对人类来说很好理解但对程序来说——怎么提取时间怎么拿到地点怎么知道时长——只能写正则表达式硬解析脆弱又麻烦。这一篇的目标让AI直接返回结构化的JSON数据程序拿来即用。02 什么是Output Parser一句话概括Output Parser是Spring AI提供的工具用于将AI的输出从“自然语言文本”转换为“结构化数据”如Java对象、Map、List等。Parser输出格式适用场景BeanOutputParserTJava对象最常用直接映射到业务对象MapOutputParserMapString, Object简单场景不需要预定义类ListOutputParserList?返回列表数据本篇重点BeanOutputParser最常用、功能最强大。03 原理AI怎么知道该输出什么格式你可能好奇AI怎么知道要输出JSON怎么知道该有哪些字段关键在于Spring AI 会自动生成 JSON Schema并附加到请求中。text用户问题 JSON Schema说明输出格式 → 大模型 → 按格式返回JSON → Spring AI 反序列化为Java对象这个Schema描述了目标类的所有字段、类型和描述AI根据它来生成符合格式的JSON。你只需要定义一个Java类创建BeanOutputConverterT调用.entity(converter)剩下的全部由Spring AI自动完成。04 代码实现第一步定义数据类在com.example.myai.model包下创建MeetingInfo.java关键要求必须有无参构造和Getter/Setter否则JSON无法反序列化为Java对象。第二步在Service中使用OutputParser修改AIService.java新增extractMeetingInfo方法关键点new BeanOutputConverter(MeetingInfo.class)创建转换器指定目标类型.entity(converter)告诉Spring AI将输出转换为MeetingInfo对象不要将BeanOutputConverter声明为Spring Bean踩坑记录会详细说明第三步暴露接口在AIController.java中新增接口05 测试验证启动项目在浏览器中访问更复杂的输入测试换个说法再测三个不同场景全部成功AI能准确提取信息并返回结构化JSON。✅06 踩坑记录坑BeanOutputConverter不能声明为Spring Bean一开始我这样写Configuration public class OutputParserConfig { Bean public BeanOutputConverterMeetingInfo meetingInfoConverter() { return new BeanOutputConverter(MeetingInfo.class); } }然后在Service中注入public AIService(..., BeanOutputConverterMeetingInfo meetingInfoConverter) { // ... }启动报错Unable to determine source type S and target type T for your Converter [org.springframework.ai.converter.BeanOutputConverter]; does the class parameterize those types?原因BeanOutputConverter虽然实现了ConverterS, T接口但它的泛型参数是在运行时通过构造函数传入的。Spring在启动时扫描所有Converter类型的Bean并注册到ConversionService由于泛型信息不完整导致类型推断失败。解决方法不在配置类中声明为Bean而是在Service方法内直接创建// ✅ 正确做法 public MeetingInfo extractMeetingInfo(...) { BeanOutputConverterMeetingInfo converter new BeanOutputConverter(MeetingInfo.class); return chatClient.prompt() ... .entity(converter); }这样避免了Spring自动配置机制的干扰。07 应用场景扩展场景用户输入OutputParser输出后续用途会议信息提取明天下午3点开会{topic, time, location, duration}自动创建日历事件订餐系统我要一份宫保鸡丁微辣{dish:宫保鸡丁, spice:微辣, quantity:1}生成订单智能表单用户任意描述需求{title, description, priority, assignee}自动创建工单数据查询帮我看看上个月销售额{total:1280000, month:7, growth:0.12}生成报表08 下期预告到此为止我们已经完成了 Spring AI 的核心功能闭环功能状态首次调用 API✅多轮对话✅流式输出✅Function Calling✅Output Parser✅接下来我们将进入企业级AI应用的核心领域——RAG检索增强生成。RAG让AI能够基于你的私有文档PDF、Word、TXT等回答问题解决大模型“知识陈旧”和“幻觉”问题。这也是目前企业AI应用落地最广泛的技术方案。下一篇我们开始搭建第一个RAG知识库。 我是超超不吵吵10年Java全栈正在转型AI应用开发。每周一篇实战笔记不贩卖焦虑只分享能落地的技术。全网同名欢迎关注。
