persist error message in oss doc

2026-07-16 17:18:08 +08:00
parent 9dc65e1d47
commit ca4bf6db5e
9 changed files with 134 additions and 37 deletions
@@ -14,7 +14,7 @@
 - 浏览器禁止直接上传、覆盖或签名写入 `editor-agent/` 对象；前端只通过 `api-server` 的会话接口创建会话、发送消息、读取历史，OSS 读写由服务端完成。
 - 消息文档序列化后的读写上限为 2 MiB；超过上限时后端拒绝继续读写该会话消息文档，并返回 payload too large 语义错误。
 - 同一会话内的消息追加采用 `conversationId` 级串行锁，避免同一会话的“读-改-写”整对象过程互相覆盖。
- Agent 规划或工具调用失败时，仍保留 assistant / system 消息和 `status=failed` 工具记录，包括 tool call、模型、错误信息等排障字段；失败记录是会话历史的一部分，不能只放在本次 JSON 响应的瞬时 `errorMessage` 中。
+- Agent 规划失败使用 `role=system`、正文以 `ERROR ` 开头的消息持久化；首次响应和同 `clientMessageId` 重放都通过 `deltaMessages` 返回该消息，`errorMessage` 不重复携带。前端隐藏前缀并显示红色错误气泡，后端构建后续 LLM memory 时仍保留该消息，让 Agent 获取上一轮失败上下文。工具调用失败继续保留 `status=failed` 工具记录、模型和错误信息；失败记录都是会话历史的一部分。
 - 不把消息明细写入 SpacetimeDB 表，不把对话混入画布工程快照，不在 api-server 内存中保存会话真相。

 ## 备选方案与取舍
@@ -31,5 +31,5 @@
 - 会话表仍只保存元数据和 `messagesObjectKey`；API 可以在读取时把 OSS 消息文档拼装为会话详情返回，但完整消息正文的持久化真相仍是 OSS JSON 文档。
 - 消息文档最大 2 MiB；该限制用于阻止单个会话无限增长。后续如果需要更长历史，应引入归档、分页对象或摘要压缩，不应把正文回填进 SpacetimeDB 表。
 - 会话软删只打表标记，OSS 对象保留，便于恢复与审计。
- 规划或工具生成失败也必须写入消息文档：assistant / system 消息保留失败状态、模型和错误信息，便于用户回看失败原因和后续排障。
+- 规划或工具生成失败也必须写入消息文档：规划失败保存 `ERROR ` system 消息，工具失败保存失败状态、模型和错误信息，便于用户回看失败原因和后续排障。
 - 若未来出现跨会话消息检索需求，需另建投影或索引，不回退为消息入表。