HarmonyOS 7 Agent构建三层韧性机制应对三类失败场景

在HarmonyOS 7 Agent开发中，调用大语言模型服务时暴露三大真实失败场景：瞬时网络抖动、持续性服务异常（如网关维护或配额耗尽）、以及彻底不可用状态。仅依赖基础RetryPolicy无法有效应对，易导致无效重试、资源浪费甚至级联故障。为此，开发者构建了严格串联的三层韧性机制：首先由熔断器判断服务健康状态（三态机：CLOSED/OPEN/HALF_OPEN），连续3次失败触发OPEN并冷却5秒；通过后进入带随机抖动的指数退避重试——退避时长按base × factor^(n−1) × [0.5,1.5]计算，避免多设备同步重试引发“惊群效应”，且支持测试注入确定性随机源；所有重试耗尽后，直接返回预设兜底文案（如“当前服务繁忙，请稍后再试”），保障界面始终有响应。该方案强调分而治之：瞬时失败交由退避处理，持续故障由熔断拦截，彻底不可用则走兜底路径。实践中需规避四类陷阱：退避无抖动、熔断阈值过低、兜底泄露错误信息、单次请求无超时限制。整套逻辑封装为ResilientLlmClient，嵌入Agent调用链路，实现可观测、可配置、可测试的高可用能力，成为端侧智能体依赖云侧大模型时的关键基础设施。