OpenCopy Agent：把 Agent Demo 做成软件系统
从模型调用工具出发，继续补齐权限、持久化、可观测性和质量评测。
很多 Agent Demo 已经能让模型调用工具，但真正投入使用时，难点往往才刚刚出现：权限怎样限制，失败如何恢复，流式响应中断后留下什么，以及一次错误到底发生在哪个环节。
OpenCopy Agent 是我从零构建的个人 AI Agent Gateway。它不是对某个现有项目的复刻，而是一次面向真实运行环境的工程练习。
我重点解决的问题
- 在模型计划和工具执行之间建立明确的权限边界
- 处理流式输出、取消、慢客户端与半成品持久化
- 为有副作用的操作提供审批和幂等保护
- 让会话、记忆、审批与 Trace 在重启后恢复
- 用版本化任务集评估 Agent，而不只依赖人工试聊
系统由什么组成
项目以 Node.js、SQLite 和 Docker 为基础，提供 Web Chat、控制界面、命令行与 HTTP Gateway。运行时可以连接 Ark Responses、OpenAI-compatible 或本地模型，并通过统一的 Tool Registry 管理内置工具与 MCP 服务。
可观测性贯穿 model → tool → reply 链路，方便从一次请求回到具体的模型输出、工具调用和错误位置。
当前结果
项目已经建立自动化测试、真实模型任务基线，以及桌面和移动端浏览器回归流程。对我而言，更重要的结果是形成了一套判断标准：Agent 的价值不只在于“会调用工具”，也在于它能否在边界内稳定执行、留下证据，并在失败后继续工作。
代码目前保存在私有仓库。如果你对架构或实现细节感兴趣，可以通过邮件联系我。