AI代理系统结合大语言模型（LLM）与外部工具和API，其运行因LLM采样方差、外部API状态、CDN基础架构头部和执行环境噪声等非确定性因素而难以复现。arXiv近期发表的一篇论文提出了agrepl框架，旨在通过记录和重放机制解决这一问题。
agrepl是一个面向开发者的CLI框架，通过在传输层使用中间人（MITM）代理拦截所有外部交互，将其序列化为结构化执行轨迹，然后在严格隔离的环境中重放，不允许任何出站网络访问。该框架形式化了代理执行模型，定义了请求键匹配函数K(s)，并证明了确定性的不变性。
为了处理重放过程中HTTP头部的差异，agrepl引入了噪声感知的差异算法，将头部变化分为信号和噪声两类。实证评估在五个工作负载上进行，共250次重放实例，结果显示重放保真度F=1.0，中位每步延迟降低98.3%。agrepl通过Go实现，以单一静态二进制文件发布，并采用MIT许可证。
该工具为AI代理系统的调试和可重复性研究提供了有力支持，使得开发者能够精确复现先前运行，从而更高效地排查问题。此外，agrepl的设计考虑了实际部署场景，通过隔离环境避免对真实API的依赖，同时噪声感知算法确保重放时头部变化的合理处理。这一框架不仅提升了调试效率，还为代理系统的可靠性验证奠定了基础。