#AI Agent
共 44 篇文章
MCP 旧会话收到 404，Python 客户端报 Session terminated
Python mcp 1.22.0 在旧会话请求收到 404 后报 Session terminated。区分路由错误与会话失效，结束旧连接后重新初始化，并限制工具动作重放。
工具缺少 context 参数
ChatPromptTemplate 追加 context 后，as_tool 参数仍只有 q。核对消息、输入变量和工具 schema，完整重建模板与注册签名，保留 partial 和可选历史契约。
Mustache 参数报错
Mustache 聊天模板能渲染 user 字典，as_tool 却报 string_type。显式声明嵌套参数，在工具校验后转回普通字典，验收真实姓名没有变空。
MCP 拒绝请求后会话仍在增长
Python MCP 返回拒绝响应，会话记录却继续增长。区分旧有状态路径与正常长连接，选择兼容的清理修复版本，并保留 Host 和认证检查。
LangGraph 分支串数据
LangGraph 编辑历史 checkpoint 后，旧分支也出现编辑值。核对 DeltaChannel 祖先写入与 1.2.15 分支快照隔离，保留已污染历史。
ChatOpenAI 流里缺少 ID
ChatOpenAI 普通流式聚合缺少 response_metadata id，非流式却有。核对 1.7.1 的顶层 chunk ID 转换，在正确响应层保留真实标识。
图片 URL 报 Malformed
ChatAnthropic 的 data URL 报 Malformed url parameter，检查 Base64 内部 MIME 换行；从真实图片字节生成连续编码，并分开验收本地转换与模型接收。
HTML 正文被改写
HTMLSemanticPreservingSplitter 把正文 PRESERVED_0 换成表格内容。避开固定占位符，明确取消整块保留的代价，按原文核对受影响检索分块。
MCP 大结果报 SSE stream ended
MCP 小结果正常、大工具列表或结果报 SSE stream ended，核对单事件 1 MiB 限制，在支持的 Python SDK 中设置有限上限，并保留重试与版本边界。
Markdown 标题未分块
MarkdownTextSplitter 把标题粘到上一块，检查语言正则是否被转义。1.1.3 显式开启 is_separator_regex，保留 chunk 预算与索引边界。
MCP initialize 被空 _meta 拒绝
Python MCP 初始化被严格服务端拒绝，检查旧 2.x 是否发送空 _meta。核对 2.3.0 省略空元数据的修复，保留进度、追踪与协议所需字段。
KeyError 也被重试
ToolRetryMiddleware 只想重试 TimeoutError，KeyError 却也调用多次。核对单异常类的 callable 分支，用尾逗号元组保留真实过滤与失败策略。
LangGraph 迁移后读慢
普通聚合列表迁到 DeltaChannel 后，PostgresSaver 每次重放整条历史。检查 blob 中的 plain seed 与正式 saver 3.1.2 修复，保留已有状态。
MCP 登录后选成旧协议
MCP 首次浏览器登录后选成旧协议，缓存令牌又正常。核对 Python SDK 的 discovery 计时与 2.3.0 对人机等待的修复，保留自定义认证边界。
MCP Context 丢失请求状态
MCP 工具正常，prompt 或动态资源模板却报 Context is not available outside of a request，核对旧版泛型 Context 重建与 2.3.0 修复。
LangGraph 恢复 interrupt 后，日志和前置操作又执行了一遍
人审恢复会重跑被中断节点的前置代码。拆分准备与人审节点，核对持久化、业务幂等和权限，避免只看最终状态就漏掉重复操作。
AutoGen 重载终止条件后，用户消息也触发了 TERMINATE
AutoGen 0.7.5 保存再加载 TextMentionTermination 时，sources 过滤可能丢失。对照配置往返，显式构造来源规则，并区分 reset 与会话状态。
LangGraph Agent 反复调用 save_memory，最后报 GraphRecursionError
检索已有结果，Agent 却反复调用 save_memory。按工具请求、结果与图路由判断循环，再设置业务上限和真正的结束路径。
MCP 关闭连接时，Shutting 日志触发 JSON 解析错误
stdio 工具的退出日志进入 stdout，会被当成 MCP 消息解析。区分服务器日志与宿主输出，核对 SDK 1.29.0 的关闭路径、正确等待连接和错误处理。
AutoGen 工具已执行，反思阶段却报 no valid text response
AutoGen 0.6.4 工具反思返回 FunctionCall 列表时，区分执行结果、tool_choice 兼容性与有限工具迭代，并核对最终消息类型和重复操作风险。