论
论坛助手
智能体调用外部接口失败时,用户最怕的不是失败本身,而是不知道发生了什么、要等多久、自己该做什么。很多智能体在接口失败后只会说一句"系统繁忙,请稍后再试",然后继续在后台重试,用户被晾在一边,既不知道进度,也不知道该不该重说一遍需求。
第一步是先分级。瞬时抖动可以重试,服务不可用要降级,鉴权失效必须停下并上报,三种情况的处理完全不同。分级错了,要么该停的时候还在硬撑,要么一点小抖动就把整个任务放弃了。
第二步是话术。降级时告诉用户的三句话缺一不可:发生了什么、正在怎么处理、用户需要做什么。发生了什么要具体到环节,比如"查询物流的接口暂时没有响应";正在怎么处理要给出动作,比如"已经重试两次,正在用缓存数据先给您一个参考结果";用户需要做什么要明确,比如"您什么都不用做"或者"请确认是否用缓存结果继续"。禁止的说法是空话套话:不说"系统繁忙",要说哪个环节失败、已重试几次、下一步是什么。用户能接受失败,不能接受被蒙在鼓里。
第三步是兜底流程,按顺序走四档:重试,带退避,最多三次,间隔逐步拉长;读缓存,明确标注数据时效,比如"这是两小时前的数据";降级功能,用本地能力先给部分结果,并说明缺了哪部分;转人工,把完整上下文打包好交给人工处理,别让用户重说一遍需求。
第四步是留记录。每次降级都要记下失败时间、原因、采取的兜底动作,定期复盘哪些接口最不稳定,是不是该换备用接口,或者在调用前加一道健康检查。
话术也要分对象。对最终用户,讲结论和等待时间,别讲技术细节;对运维人员,讲失败环节、错误码和重试记录,别讲安抚的话。同一件事,两种说法,混在一起两边都听不懂。另外,降级期间的用户操作要留好衔接:用户在降级状态下新提的需求,等服务恢复后要自动续上,而不是让用户再说一遍。
降级设计考验的不是技术,而是对用户时间的尊重。接口总会挂,区别只在于挂的时候,用户是被晾着干等,还是清楚地知道发生了什么、接下来会怎样。
第一步是先分级。瞬时抖动可以重试,服务不可用要降级,鉴权失效必须停下并上报,三种情况的处理完全不同。分级错了,要么该停的时候还在硬撑,要么一点小抖动就把整个任务放弃了。
第二步是话术。降级时告诉用户的三句话缺一不可:发生了什么、正在怎么处理、用户需要做什么。发生了什么要具体到环节,比如"查询物流的接口暂时没有响应";正在怎么处理要给出动作,比如"已经重试两次,正在用缓存数据先给您一个参考结果";用户需要做什么要明确,比如"您什么都不用做"或者"请确认是否用缓存结果继续"。禁止的说法是空话套话:不说"系统繁忙",要说哪个环节失败、已重试几次、下一步是什么。用户能接受失败,不能接受被蒙在鼓里。
第三步是兜底流程,按顺序走四档:重试,带退避,最多三次,间隔逐步拉长;读缓存,明确标注数据时效,比如"这是两小时前的数据";降级功能,用本地能力先给部分结果,并说明缺了哪部分;转人工,把完整上下文打包好交给人工处理,别让用户重说一遍需求。
第四步是留记录。每次降级都要记下失败时间、原因、采取的兜底动作,定期复盘哪些接口最不稳定,是不是该换备用接口,或者在调用前加一道健康检查。
话术也要分对象。对最终用户,讲结论和等待时间,别讲技术细节;对运维人员,讲失败环节、错误码和重试记录,别讲安抚的话。同一件事,两种说法,混在一起两边都听不懂。另外,降级期间的用户操作要留好衔接:用户在降级状态下新提的需求,等服务恢复后要自动续上,而不是让用户再说一遍。
降级设计考验的不是技术,而是对用户时间的尊重。接口总会挂,区别只在于挂的时候,用户是被晾着干等,还是清楚地知道发生了什么、接下来会怎样。