.NET+AI | Agent | 结构化输出（10）
💡
原文中文，约2200字，阅读约需6分钟。
📝
内容提要
MAF 通过 Microsoft.Extensions.AI 提供结构化输出，确保 Agent 返回强类型业务对象，支持流程驱动与企业系统对接。其核心功能包括自动生成 Schema、流式与嵌套对象适配，简化数据处理，避免字符串解析。MAF 负责状态管理，MEAI 负责轻量调用。
🎯
关键要点
- MAF 依托 Microsoft.Extensions.AI 提供结构化输出，确保 Agent 返回强类型业务对象。
- 结构化输出能直接映射业务对象，避免脆弱的字符串解析。
- RunAsync<T>() 是默认首选，自动生成 Schema 并返回强类型结果。
- 流式、嵌套对象、国产模型都能通过少量配置完成适配。
- MAF 负责状态管理，MEAI 负责轻量调用。
- 客服工单分类、审批助手、数据分析等场景均可利用结构化输出。
- 两种提取路径：非泛型方式和泛型方式，推荐使用泛型方式。
- 流式获取和复杂对象处理需注意最佳实践，避免模型漂移。
- 国产模型适配时需设置 useJsonSchemaResponseFormat: false，并提供完整 JSON 示例。
- MAF 与 MEAI 分工明确，前者管状态，后者管轻量调用。
- 总结强调 MAF 的结构化输出让 Agent 与业务系统直接对接，提供强类型体验。
❓
延伸问答
MAF 的结构化输出有什么优势？
MAF 的结构化输出确保 Agent 返回强类型业务对象，避免脆弱的字符串解析，能够直接与企业系统对接。
如何使用 RunAsync<T>() 方法？
使用 RunAsync<T>() 方法时，无需预先配置，直接调用即可自动生成 JSON Schema 并返回强类型结果。
MAF 和 MEAI 的主要分工是什么？
MAF 负责状态管理和复用，而 MEAI 负责轻量调用，二者分工明确。
在什么场景下可以利用结构化输出？
结构化输出可用于客服工单分类、审批助手和数据分析等场景。
如何适配国产模型？
适配国产模型时需设置 useJsonSchemaResponseFormat: false，并提供完整的 JSON 示例。
流式获取和复杂对象处理有哪些最佳实践？
流式获取时应完成流后再反序列化，避免边流边反序列化，以防模型漂移。
➡️
