《失败重试挂在气泡上:原参数重发,别让用户重打一遍》
AI 对话最让人恼火的失败,不是模型答错了,而是生成到一半断了——网络抖一下、服务端抽风一下,页面上只剩一句“生成失败”。这时候用户最不想做的事,就是把刚才那段话再打一遍:可能是一段很长的需求,还带了几张图。我们的处理方式是:失败的气泡自己带一个“重试”,点一下就用原来的参数原样再跑一轮。
先想清楚:重试要带回什么
点“重试”的时候,页面要能立刻拿出三样东西:用户刚才发的那段文字、附带的素材、以及当时选的思考强度(reasoningEffort)。这三样合起来,才是“原参数重发”的全部内容。
我们的做法是在每次提交时顺手记一笔:submitRound 里把 { text, media, reasoningEffort } 存到 _lastSubmit。它不是存在页面 data 里——不需要渲染,只是给重试留的底稿。每次新提交都会覆盖它,所以它永远是“最近一轮”的参数。
失败发生时,收尾函数 finishAiBubble 会把这份底稿挂到失败的 AI 气泡上:messages[idx].retry = this._lastSubmit。气泡本身带两个标记——failed: true 和这段 errorMsg,再加上 retry,重试的入口和材料就都齐了。
模板里的判断也照这个来:只有 item.failed && item.retry && !streaming 时才显示“重试”。三个条件各有道理:必须是失败的气泡;必须带了可重发的参数;生成进行中时不给入口——一轮还没跑完,点重试只会添乱。
重发时别把用户消息再画一遍
重试和正常发送的区别,在 submitRound 的第四个参数 appendUser 上。正常发送是 true:先把用户消息画到列表里,再发请求。重试是 false:用户的消息本来就已经在历史里了,再画一次会变成两条一模一样的消息。
所以重试的处理函数 resendMessage 很短:先过三道守卫——生成中直接返回、不是失败气泡返回、没有 retry 返回;然后调 submitRound(m.retry.text, m.retry.media.slice(), m.retry.reasoningEffort, false)。注意 media.slice() 是复制一份数组再传,避免重发过程里改动到底稿。
还有一个细节:重发会生成一个新的 clientRunId。服务端把这一轮当成新的一轮来跑——注释里写得很实在:上一轮失败后额度已经退回,素材地址也仍然可以访问,所以原样重发不会多扣费,也不会因为图片链接失效而失败。
两种失败不给重试:上下文满了,和找不回原文
不是所有失败都值得重试,有两种情况我们主动把入口收起来。
第一种是上下文满了(CONTEXT_LIMIT)。这种失败不是偶然抖动,而是会话已经触到模型上下文上限,原样重发只会再失败一次。处理分两步:run.failed 事件里收到这个错误码,就把当前气泡的 retry 置空;同时弹一个提示,告诉用户这条会话已到上限,请新开一条会话,旧会话还能在历史里查看。重试解决不了的问题,就别给用户一个注定失败的按钮。
第二种是打开历史会话时找回的失败轮次。loadThread 会把服务端返回的 runs 里状态为 FAILED 的轮次在列表末尾补一条失败说明。能不能重试,要看能不能找到这一轮的用户原文:按 runId 去匹配最后一条同 run 的用户消息,找得到就把 { text, media, reasoningEffort } 挂上去;找不到(或者错误码就是 CONTEXT_LIMIT),retry 就是 null,气泡只显示失败说明,不给重试入口。
小结
失败重试这件事,写起来只有三处改动,但每处都在回答一个具体问题:
- 重试带什么:提交时把
{ text, media, reasoningEffort }记到_lastSubmit,失败时挂到气泡的retry上; - 重发怎么做:
resendMessage用原参数调submitRound,appendUser传false,不重复画用户消息,新clientRunId当新的一轮跑; - 什么时候不给重试:上下文满了重发也没用,直接置空并提示开新会话;历史里找不回原文的失败轮次,也不给入口。
回头看,这功能真正的价值不在代码量,而在位置:重试入口长在失败的气泡上,用户视线本来就在那,点一下就能继续,不用翻上去复制、不用重新上传图片。失败已经够烦了,别再让用户为失败多做一次操作。
- 点赞
- 收藏
- 关注作者
评论(0)