文档教程AI Agent人工智能【免费下载链接】Agentic-Design-PatternsAgentic Design Patterns项目地址https://gitcode.com/gh_mirrors/agen/Agentic-Design-Patterns点击查看免费下载AI Agent 干到一半突然卡壳——工具调用失败、API 返回 500、输出前言不搭后语你该怎么办开源书籍 Agentic Design Patterns 给出了系统性答案异常处理与恢复Exception Handling and Recovery模式。它教你的 Agent 像人一样应对意外先检测错误再从容处置最后恢复稳定运行甚至优雅降级、求助人类而不是一崩了之。 Agent 为什么会卡壳三大故障源头看上面这张图Agent 解决问题的过程是领任务 → 扫环境 → 思考 → 行动 → 变强。问题出在**行动**这一步——Agent 一旦开始调用工具外部世界的不确定性就进来了故障源头典型表现️ 工具调用失败工具入参错误、依赖的外部服务挂了 API / 网络异常404、500 错误码、超时、响应慢得反常 数据不合法工具返回畸形输出、乱码、格式完全对不上工具是 Agent 的双手也是它最脆弱的环节。工具调用失败是异常的头号来源更多细节见 Chapter 5: Tool UseFunction Calling-1bE4iMljhppqGY1p48gQWtZvk6MfRuJRCiba1yRykGNE.md) 异常处理与恢复模式一套检测—处置—恢复三层防线Chapter 12: Exception Handling and Recovery 把这个模式拆解为三个阶段核心思想是主动预防 被动响应双管齐下。第一步错误检测——在问题爆发前抓住它错误检测是防线的第一道闸门信号包括工具输出无效或格式畸形API 返回 404 / 500 等错误码服务响应时间异常变长超时也是错误的一种输出胡言乱语、偏离预期格式。更高级的做法是主动监控由其他 Agent 或专门的监控系统持续观测 Agent 的指标发现异常立即拉响警报把事后救火变成事前预警第二步错误处理——五种标准应对手段错误一旦被抓到就进入处置环节。书中给出的五件套可以直接抄作业手段什么时候用效果 日志记录Logging任何错误记下错误细节方便事后调试与复盘 重试Retries瞬时错误网络抖动、超时稍微调整参数再来一次常常直接解决 兜底切换Fallbacks主路径不可用换备用工具或备用方案保住基本功能 优雅降级Graceful Degradation无法立即完全恢复保留部分功能至少先提供一点价值 通知Notification需要人类介入时及时告警给操作员或其他 Agent第三步恢复——把 Agent 拉回稳定状态恢复阶段的目标是止血 根因治理四招组合状态回滚State Rollback撤销出错前后的变更或事务退回干净状态根因诊断Diagnosis查清楚错误到底怎么来的防止复发自我修正Self-correction调整计划、逻辑或参数换一种打法重试——这一步常与 Chapter 4: Reflection反思 配合使用第一次尝试失败抛出异常后反思流程分析失败原因用改进的提示词再战一次升级上报Escalation问题太严重或太复杂交给更高级别的系统或干脆请人类出面参见 Chapter 13: Human in the Loop。在多 Agent 架构中升级天然有去处子 Agent 搞不定时请求会上升给 Supervisor Agent 统筹决策 场景体检这六类 Agent 最需要异常处理场景卡壳现场正确的恢复姿势 客服聊天机器人客户数据库临时宕机检测到 API 错误 → 告知用户稍后再试或转人工 自动金融交易资金不足、市场已收盘记录日志绝不对无效交易反复重试必要时调整策略 智能家居网络问题导致灯开不了重试一次仍失败就通知用户手动处理 文档批处理遇到损坏文件跳过坏文件、记录日志继续处理其余文件最后汇总报告️ 网页爬虫验证码、404 / 503、页面改版暂停、换代理或精确报告失败的 URL 机器人制造机械臂抓件对位失败传感器反馈 → 重新校准 → 重试持续失败则告警换件⚡ 落地套路一条主力—备胎—作答三层链书中用 Google ADK 给了一个可直接借鉴的最小架构Chapter 12 实战代码思路很干净不需要看代码也能抄主力 Agentprimary_handler专心用第一工具精确位置查询干活备胎 Agentfallback_handler检查状态标记主力是否失败失败了就退一步用粗粒度工具按城市查兜底作答 Agentresponse_agent只负责把最终结果讲给用户听拿不到结果就坦诚致歉而不是硬编。三者用 SequentialAgent 按固定顺序串联任何一环失败链路都能软着陆。✅ 要点速查清单异常处理与恢复是构建可靠 Agent 的必备模式不是可选项三大阶段缺一不可检测 → 处置 → 恢复检测靠验证工具输出 检查错误码 超时 监控告警处置靠日志、重试、兜底、降级、通知五件套恢复靠回滚、诊断、自我修正、升级上报四步走经验法则只要 Agent 部署在动态真实环境就要上这个模式。 延伸阅读Chapter 12: Exception Handling and Recovery本章原文出处Chapter 4: Reflection与异常恢复配合的反思模式Chapter 13: Human in the Loop升级上报的人类介入模式Chapter 5: Tool Use工具调用异常的第一现场-1bE4iMljhppqGY1p48gQWtZvk6MfRuJRCiba1yRykGNE.md)赞分享文档教程AI Agent人工智能【免费下载链接】Agentic-Design-PatternsAgentic Design Patterns项目地址https://gitcode.com/gh_mirrors/agen/Agentic-Design-Patterns点击查看免费下载相关推荐BullshitGenerator错误处理机制当生成器也“卡壳”时怎么办BullshitGenerator错误处理机制当生成器也“卡壳”时怎么办 你是否曾遇到过文章生成到一半突然中断或者输入主题后程序毫无反应作为一款用于测试G开发工具测试免费解锁macOS隐藏技能让Finder支持所有视频格式的终极指南免费解锁macOS隐藏技能让Finder支持所有视频格式的终极指南 还在为Mac上无法预览MKV、AVI、WebM等视频文件而烦恼吗每次都要打开笨重的播放器音视频桌面应用Lazydocker 升级后容器排序方式变了怎么恢复旧排序Lazydocker 升级后容器排序方式变了怎么恢复旧排序 升级 lazydocker 后Containers 面板里容器的排列顺序可能和你之前用习惯了的不开发工具CLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考