README
¶
错误处理示例
本示例演示了 GoAgent 中正确的错误处理模式，涵盖从基础到高级的各种场景。
运行示例
cd examples/error_handling
go run main.go
包含的示例
示例 1: 创建不同类型的错误
演示如何使用辅助函数创建各种类型的错误：
- LLM 请求错误
- 工具执行错误
- 文档未找到错误
- 计划执行错误
示例 2: 链式添加上下文
演示如何使用方法链为错误添加丰富的上下文信息。
示例 3: 错误包装
演示如何正确包装错误以保持错误链，以及如何遍历错误链和获取根因。
示例 4: 错误检查和分支处理
演示如何使用 errors.IsCode() 进行类型安全的错误检查，以及如何根据不同错误类型实现不同的处理逻辑。
示例 5: 重试逻辑
演示在实际场景中如何实现智能重试逻辑，特别是处理 LLM 速率限制错误。
示例 6: 降级处理
演示当主服务不可用时如何降级到备份服务，展示了基于错误类型的服务降级模式。
示例 7: 错误转换
演示如何将内部错误代码转换为 HTTP 状态码，适用于 API 层。
示例 8: 结构化日志
演示如何提取 AgentError 的所有字段用于结构化日志记录，包括堆栈跟踪。
示例 9: 批处理错误聚合
演示在批处理场景中如何收集和聚合多个错误，提供完整的批次处理报告。
示例 10: 错误链分析
演示如何分析和展示多层嵌套的错误链，对调试复杂错误场景很有帮助。
关键要点
- 使用辅助函数: 优先使用
errors.NewXxxError()辅助函数而非手动构造 - 类型检查: 使用
errors.IsCode()而非字符串比较 - 保持错误链: 使用
errors.Wrap()包装已有错误 - 添加上下文: 使用
WithContext()添加调试所需的关键信息 - 智能重试: 只对可重试的错误（如速率限制、超时）进行重试
- 降级策略: 基于错误类型实现服务降级
相关文档
Documentation
¶
There is no documentation for this package.
Source Files
Click to show internal directories.
Click to hide internal directories.