AgentHarness 课程

第四十九课:性能调优与故障排除

796字·2分钟·
上下文优化常见错误排查doctor命令

学习目标

  • 掌握性能调优技巧
  • 学会排查常见错误
  • 了解 doctor 命令的使用

一、性能调优

1.1 上下文优化

使用 /compact 压缩上下文:

  • 保留最近的消息
  • 合并旧消息为摘要
  • 释放 token 空间

1.2 模型选择

根据任务选择合适的模型:

  • 简单任务:codex-mini(快速)
  • 复杂任务:GPT-5 Codex(强大)

1.3 AGENTS.md 优化

  • 保持简洁
  • 只包含必要信息
  • 定期更新

二、常见错误排查

2.1 认证失败

检查 API Key 和登录状态。

2.2 沙盒限制

检查沙盒策略是否合适。

2.3 网络问题

检查网络连接和代理配置。

2.4 模型错误

检查模型名称和可用性。

三、doctor 命令

3.1 生成诊断

codex doctor

3.2 诊断内容

  • 系统信息
  • 配置状态
  • 网络连接
  • 认证状态
  • 沙盒状态

3.3 使用诊断

根据诊断结果排查问题。

四、最佳实践

4.1 性能优化

  • 定期压缩上下文
  • 选择合适的模型
  • 优化 AGENTS.md

4.2 故障排查

  • 使用 doctor 命令
  • 查看日志
  • 检查配置

五、本课小结

要点说明
性能调优压缩上下文、选择模型、优化配置
常见错误认证、沙盒、网络、模型
doctor 命令生成诊断报告
最佳实践定期优化、使用诊断

下一步

最后一课我们将展望 Codex 生态。