问题与边界
一个工单 Agent 在外部系统超时时不能继续猜测。案例用内存事件列表模拟运行,验证暂停、证据摘要和人工接管,不调用外部服务。
方案
每个事件只保存工具名、状态、耗时和脱敏参数摘要。达到重试预算或出现权限错误时写入 handoff 事件,界面展示下一步而不是伪造完成。
最小实现
events = []
events.append({'type': 'tool', 'name': 'lookup_ticket', 'status': 'timeout', 'attempt': 2})
events.append({'type': 'handoff', 'reason': 'dependency_timeout', 'next': 'verify manually'})
assert events[-1]['type'] == 'handoff'
assert all('secret' not in event for event in events)
复现步骤
- 创建固定工单输入和模拟超时工具,限制最多两次重试。
- 记录工具事件和错误码,确认不保存完整用户正文或凭证。
- 写入 handoff 事件并在人工界面显示工单 id、失败原因和建议动作。
- 人工完成后追加 resolution 事件,保留原始失败轨迹用于回归测试。
验证清单
验证重试上限、权限错误直接接管、证据脱敏、重复提交不会创建第二条工单。
常见问题
人工接管是否等于失败? 它是受控的安全状态,应和系统错误分开统计。
能自动把 handoff 重新交给模型吗? 只能在人工授权和新预算下重新启动。
延伸阅读
官方参考
OpenAI Agents 指南;OWASP LLM Top 10。
最后核对日期:2026-11-17。涉及版本、接口、模型行为和价格的结论以链接中的官方资料为准;本文不把一次本地运行结果表述为通用性能结论。
