别再靠 Prompt 硬劝模型吐 JSON：Structured Outputs、Function Calling 与国产模型能力盘点

前言很多团队第一次做结构化输出，都会写出一句极其熟悉的咒语： 1请严格输出 JSON，不要解释 然后几轮之后，程序收到的内容往往是： 一坨长得像 JSON 但少了逗号的文本 一个合法 JSON，但字段缺了一半 一个字段结构没问题，但值一本正经地胡说八道 这不是模型跟你作对，这是你把三件不同的事混在了一起： Prompt 约束 Structured Outputs / JSON mode F
AI
#AI工作日志 #Qwen #Function Calling #Structured Outputs #JSON Schema #Prompt Engineering #Kimi #GLM #DeepSeek

AI Agent Security 实现实践：对话阶段防泄露、防工具暴露与审计

这次改的是一个 FastAPI + LangGraph + MCP 的 AI 控制平面。问题起点很朴素：用户问了一句“你有哪些工具”“你的执行流程是什么”，模型老老实实把内部工具和编排动作抖出来了。系统没崩，脸先丢了。 这篇记录只写本次已经提交的 security 补丁，不展开下一阶段的 ContextBuilder 重构。换句话说，这是一篇 pre-context-builder 版本的安全落地
AI
#LangGraph #AI工作日志 #Agent #Security #Prompt Injection #FastAPI

LangGraph 编排重构复盘：一次把“能跑”改成“可证据化运行”的实战

这次改造最有意思的地方，不是“把编排迁到 LangGraph”这件事本身，而是我们把一个常见工程陷阱踩出来又填平了： 到底是要“快速把 case 跑通”，还是要“把系统做成可长期治理”。 答案很明确：后者。 下面按真实时间线复盘，尽量给可复现证据，不讲玄学。 1. 讨论分歧：要不要用 fallback 快速过 case中途一度出现典型诱惑： 用户说“1号炉”，那就直接从 query 里正则提
AI
#LangGraph #AI工作日志 #重构复盘 #Tool Schema #联调实战

LangGraph 从字段拼接到 MessagesState：两次提交把编排链路收口

这篇记录复盘最近两次连续提交： 76539e9：refactor(langgraph): 全量收口到MessagesState单一状态源 2138513：refactor(langgraph): 删除未激活respond节点并清理导出 一句话总结：把编排状态从“字段搬运工模式”改成“消息主链模式”，再把没上班的节点请出工位。 先说改造前的问题在这次重构前，编排链路同时维护几套上下文来源： q
AI
#LangGraph #AI工作日志 #FastAPI #架构重构 #工程复盘

LangGraph Checkpoint、Event 和 Replay：别把状态快照当业务事件

调试 LangGraph 时，最容易踩的一个坑不是代码写错，而是脑子里把三件不同的东西混成了一件事： event checkpoint replay 表面看它们都能回答“这轮到底发生了什么”，于是很多项目自然会冒出一个问题： “既然 LangGraph 已经有 checkpoint 和 replay，我自己写的 event 机制是不是多余了？” 这个问题我最近在一套 AI 编排服务里来回掰扯了
AI
#LangGraph #AI工作日志 #Checkpoint #调试 #架构复盘

LangGraph Checkpoint 改造复盘：从内存快照到可恢复执行

这次改造的目标很朴素：让编排流程别再“断电失忆”。 项目原来已经有 LangGraph thread_id，也已经把澄清流程做成了 interrupt/resume 语义。但 checkpoint 用的是进程内内存 saver，服务重启后现场直接蒸发。于是用户问一句“继续”，系统看着你，内心是“我是谁我在哪”。 下面按 STAR 记录这次改造，顺便把关键 QA 和踩坑细节摊开讲清楚。 S
AI
#LangGraph #AI工作日志 #复盘 #Checkpoint #STAR

LangGraph HITL 重构复盘：从一次性澄清到可恢复编排

这周把一条很“能跑但不优雅”的链路，改成了真正可恢复的人在回路（HITL）语义。 一句话版本： 以前：clarification_needed -> final，一轮结束，下一轮靠外部再喂输入，图内语义断开。 现在：clarify 节点内 interrupt(payload) 挂起，用户补充后 Command(resume=...) 继续执行，图内闭环。 下面按工程复盘写清楚：问题是什么
AI
#LangGraph #AI工作日志 #复盘 #编排 #LangChain #HITL

LangGraph 编排重构实录：拆编排不拆对外契约（STAR）

这篇复盘写给已经在做 Agent/LLM 编排、并且被“历史包袱 + 线上契约 + 多系统联动”三连击过的工程师。 一句话版结论：这次不是“把代码搬到新目录”，而是把编排从“单文件扛全场”升级为“LangGraph 节点化 + 对外契约不动”的可演进内核。过程不炫技，核心是稳。 如果要用一句带点黑色幽默的话描述这次重构： 我们终于把 orchestrator.py 从“全栈菩萨”劝退成
AI
#LangGraph #AI工作日志 #重构复盘 #架构治理

P1解析失败恢复：从误报模型不可用到可恢复澄清链路

这篇记录一次真实联调中的 P1 修复：同一个用户问题，本应触发澄清，却被错误归因为“模型不可用”。 STAR 复盘S（Situation）背景在 2026-03-05 的真实联调中，知识库工具链路已经打通，但出现了错误路由： 用户输入：帮我查知识库 实际事件：llm_request -> react_plan(parseStatus=schema_validation_failed) -&
AI
#LangGraph #AI工作日志 #联调复盘 #故障恢复