Framework Choices

如果你要自己做 agent，该怎么选框架

这一页是搭建建议，不是某个 repo 的实现说明。目的不是给标准答案，而是帮你少踩路线上最常见的坑。

搭建建议

先决定 4 件事

框架选择决策树

先按场景、记忆需求和复杂度判断，不要一上来就上最重的方案。

先按场景，再按记忆需求，再按复杂度，不要一开始就把所有技术都堆上去。

只做单 agent、任务短

先从 history + 简单 summary 开始，通常不需要复杂长期记忆。

要跨会话记住事实和偏好

考虑文件 / SQLite / BaseStore 这一类较轻长期记忆层。

要做语义召回和经验检索

开始考虑向量库、entity store、混合检索。

要平台化或多人协作

要提前想清 system prompt、会话、归档和版本存储的边界。

要多 agent 协作

优先设计共享范围、回写策略和冲突解决，再决定后端。

这里给的是可执行建议：什么场景适合文件、SQLite、向量库或平台型 memory。

适合个人助手、项目助手、知识量不大但需要可审阅、可手改的长期记忆。

适合本地工具型 agent，把消息、任务状态、作业表和审计记录放到一起管理。

适合知识量大、需要召回旧经验、需要把记忆当检索资产来用的系统。

适合团队协作、多会话、多 agent 或需要版本化、归档和统一治理的系统。