#AI Agent
共 44 篇文章
ShellSession 退出后超时
ShellSession 顶层 exit 后，EOF 没结束收集，仍等待完成标记而超时。单任务按条件使用子 shell，保留退出码、会话状态与原有安全限制。
XML 根标签被删了
XMLOutputParser 把普通 encoding 属性误当声明，完整解析前删掉根标签。缩窄可配置规则，保留 defusedxml，分别验完整文档与流式片段。
LangGraph 恢复后重复
LangGraph exit 恢复后重复值，核对 DeltaChannel pending writes 与 1.2.15 修复，比较实时状态和 checkpoint 重放顺序。
MCP 把 null 当成缺失
MCP 返回显式 null，旧客户端却按缺失结果报错。区分字段不存在与 null，核对 Python SDK 2.3.0 的输出 schema 验证和发送端边界。
MCP 订阅占住云函数
静态 MCP 服务的 subscriptions/listen 长流占住云函数。核对 Python SDK 2.3.0 的 subscriptions=False，让公布能力与处理入口一致，并验收真实客户端。
MCP 空服务报 KeyError
MCP 空服务通过 ClientSessionGroup 连接报 KeyError，或单独断开未关闭 transport。区分外部 session 与组内连接，核对空目录记账和当前版本边界。
工具结果多出 None
ToolMessage 的 None 变成字面文本，检查构造前后。仅按业务空文本契约处理 None，保留零值、内容块、失败状态和 tool_call_id。
ToolNode 并发超限
LangGraph 设置 max_concurrency=1，ToolNode 异步工具仍同时执行。核对节点内部 gather，用共享 awrap_tool_call gate 约束实际操作。
LangChain 索引错了
TextSplitter 的 start_index 指向后面的重复文字，检查空格重组与 text.find。保留原文分隔符，验证整组顺序覆盖后分配位置，旧索引单独回查。
JSON 混入思考草稿
Perplexity 流式结构化输出把 think 内的 JSON 草稿当结果。拦住未闭合思考区块，保留字段验证，并在流结束后明确核验完整文本。
SQLite 漏读检查点
SQLite saver 读 DeltaChannel 历史为空，检查父检查点 ID 排序与 parent_checkpoint_id；核对 3.1.2 递归祖先读取修复。
MCP OAuth 授权地址多一个问号
MCP 授权地址已有 query，旧 Python 客户端又加问号，导致 response_type 丢失。保留租户或环境参数，核对 URL 合并、版本与回调清理。
Ollama 报 think 校验失败
ChatOllama 的 think 字符串在请求前校验失败，核对 Python ollama 0.6.2 与 0.6.3；适配器依赖满足不代表实际模型支持任意等级。
LangGraph 子图为空
LangGraph 根图消息正常，子图 DeltaChannel 却为空。检查继承的 saver、明确 namespace 与 1.2.15 修复，避免空读取覆盖旧快照。