logo

Claude续聊报400?排查thinking块与Agent状态恢复

作者:谁偷走了我的奶酪2026.11.17 03:20浏览量:1

简介:多轮续聊突然报400,多数情况不是网络问题,而是历史消息结构被改动。本文说明为什么要保存原始内容块、如何保持system和tools稳定、怎样完整恢复Agent状态,并给出排查顺序与上线前回归清单,帮你快速定位问题。

一、先别反复重试

HTTP 400 表示请求的格式或参数不符合接口要求。它不是 429 限流,也不是 5xx 服务端故障。同一个请求反复发送,通常会得到同样的结果,所以应先检查请求内容本身。

在多轮对话、Agent 和工具调用场景中,续聊报 400 最常见的原因是:发给模型的历史消息结构和上一轮不一致。下面按排查顺序说明原因和处理方法。具体的校验规则以 Anthropic 官方 Messages API 文档和你所用 SDK 版本的说明为准。

二、续聊报 400 的常见原因

第一轮能正常回答,第二轮开始报错,多半和历史消息有关。下表列出几种常见情况。

现象 可能原因 处理方式
第二轮起报 400 只保存了 assistant 的文本,没有保存原始 content 块 保存完整 content 列表,按原顺序回放
手动编辑过历史 thinking 块的内容和签名需要原样回传,改动后可能校验失败 不编辑、不截断 thinking 块,整块保留
会话中途修改 system 或 tools 请求前缀变化,与历史记录不再一致 同一会话内保持 system 和 tools 稳定
工具调用后报错 tool_use 没有对应的 tool_result,或 tool_use_id 不一致 每个 tool_use 都回传一个 ID 对应的 tool_result
切换模型后报错 新模型不一定接受旧模型生成的内容块 新建会话,或对历史做摘要重建
Agent 恢复后接不上 只恢复了用户输入,工具结果和任务状态丢失 持久化完整的 Agent 状态快照

三、保存原始内容块,不要只存文本

很多框架保存历史时,会把 assistant 的回复简化成一段字符串。普通聊天中这样做可能还能运行。但一旦开启 thinking 或调用工具,内容块的结构就不完整了,后续请求很容易被拒绝。

推荐做法是:保存模型返回的全部 content 块,下一轮请求原样回放。

  1. import anthropic
  2. client = anthropic.Anthropic() # API Key 从环境变量 ANTHROPIC_API_KEY 读取
  3. MODEL = "<你的模型ID,以官方模型列表为准>"
  4. response = client.messages.create(
  5. model=MODEL,
  6. max_tokens=1024,
  7. system=system_prompt,
  8. tools=tools,
  9. messages=history,
  10. )
  11. # 不要只保存文本:history.append({"role": "assistant", "content": response.text})
  12. # 保存完整的 content 块列表
  13. history.append({"role": "assistant", "content": response.content})

开启 extended thinking 时,需要额外传入 thinking 参数,并且 max_tokens 必须大于 budget_tokens。参数名和取值范围请以你所用 SDK 版本的文档为准。

如果要把历史写入磁盘,可以用 model_dump() 把每个内容块转成字典保存,恢复时再还原为请求所需的结构。

下一轮请求时,只在历史末尾追加新消息,不重写前面的记录:

  1. history.append({"role": "user", "content": "请继续刚才的任务。"})
  2. next_response = client.messages.create(
  3. model=MODEL,
  4. max_tokens=1024,
  5. system=system_prompt, # 同一会话保持不变
  6. tools=tools, # 同一会话保持不变
  7. messages=history, # 只追加,不重写
  8. )

工具调用时,每个 tool_use 都要有对应的 tool_result,并使用相同的 ID:

  1. tool_results = []
  2. for block in response.content:
  3. if block.type == "tool_use":
  4. output = run_tool(block.name, block.input) # 你自己的工具执行函数
  5. tool_results.append({
  6. "type": "tool_result",
  7. "tool_use_id": block.id,
  8. "content": output,
  9. })
  10. history.append({"role": "user", "content": tool_results})

agent-">四、Agent 状态要完整保存

一个可恢复的 Agent 通常需要保存以下内容:

  1. 消息历史:用户消息、assistant 的原始 content 块、工具结果。
  2. 工具定义:tools 的 schema 和版本号。
  3. 工具调用状态:tool_use 的 ID、参数、返回结果和执行状态。
  4. 系统提示词:system prompt 及其版本。
  5. 模型信息:模型 ID 和供应商。
  6. 环境状态:Computer Use 场景下的页面、文件、终端或任务进度。
  7. 隐私策略:哪些内容可以保留,哪些必须脱敏。
  8. 任务状态:当前计划、已完成步骤和下一步动作。

只恢复最后一句用户输入,Agent 看起来接上了,实际上工具调用和任务进度已经断开。一份最小快照可以写成下面的结构:

  1. {
  2. "session_id": "sess_001",
  3. "model": "<模型ID>",
  4. "system_version": "v3",
  5. "tools_version": "2026-11-01",
  6. "messages": [],
  7. "pending_tool_uses": [
  8. {"id": "toolu_example", "name": "search", "status": "waiting"}
  9. ],
  10. "environment": {"working_dir": "/workspace"},
  11. "privacy": {"policy_version": "2026-10", "redact_fields": ["email"]},
  12. "task": {"plan": [], "completed_steps": [], "next_step": ""}
  13. }

快照文件应放在访问受控的存储中,不要明文保存 API Key 或用户敏感信息。

五、跨模型切换为什么容易报 400

不同模型对内容块类型、工具调用格式、system 长度、tools 结构和上下文长度的支持程度不同。旧模型生成的 thinking 块,新模型未必能接受。如果切换模型后仍把旧历史原样传入,就可能报 400。

处理跨模型切换时,可以选择以下三种方式之一。

方式一:新建会话,并做摘要重建。 这是模型差异较大时最稳妥的做法。把旧会话压缩成结构化摘要,包括目标、已完成步骤、关键结论和未完成事项,再放入新会话的开头。

方式二:清洗历史内容块。 切换前移除不兼容的内容块。清洗会改变历史前缀,因此清洗后仍要保证 tool_use 和 tool_result 成对出现,消息顺序合法。

方式三:不回放 thinking。 如果业务只关心最终答案,可以只保留用户消息、工具结果和最终回复,不再回放推理内容。

六、隐私改写前先备份

如果你的组织开启了数据脱敏、敏感信息过滤或数据保留限制,系统在发送请求前可能会删除或替换部分历史内容。这会改变消息前缀,也可能让后续的工具调用失去依据。

例如,原始回复中包含内部推理,策略要求不能发送给第三方模型,系统删掉了 thinking 块。但后续请求仍然引用了依赖该块的工具调用,这时请求就会失败。

处理方法如下:

  1. 删除或改写历史之前,先把原始会话完整备份到访问受控的存储中。
  2. 不要只删除中间的一段消息就直接发送,这样很可能破坏前后的对应关系。
  3. 按需重建合法上下文:保留必要摘要,重新生成 system,重新初始化工具状态,或者开新会话。
  4. 脱敏后重新检查消息结构是否合法。

七、续聊 400 的排查流程

遇到续聊报 400 时,可以按以下顺序检查:

  1. 查看错误体。关注 type 和 message 字段,判断问题与消息格式、内容块、工具调用、system 或 tools 有关。
  2. 检查历史中的 thinking 块是否被编辑、截断或删除。
  3. 确认 system 在会话中途是否被修改。
  4. 确认 tools 的

发表评论

活动