【Agent进阶专题】架构设计
系统架构只有两个核心概念:
1 | Kernel + Extensions |
Kernel 管”Extension 怎样连接和运行”,Extension 管”系统具体能做什么”。
架构优先级
这是个人、本地优先的 Agent 项目。优先级很明确:
1 | 简单易懂 > 容易修改 > 容易扩展 > 通用性 |
不提前建复杂分层、插件平台或通用框架。真实能力先跑起来,边界出现后再拆。
Kernel:只保留运行机制
Kernel 只做四件事:
- 按顺序装入 Extension,依次执行
setup→start,停止时倒序stop - 通过命名抓手注册和获取能力(
add/get/all) - 通过命名事件发布和监听事实(
on/emit)
Kernel 不认识 Workspace、Conversation、Run、Agent、模型或 Tool。业务概念不能因为多处使用就被塞进 Kernel。
能力抓手让 Extension 直接协作。Extension 可以通过抓手获取到别的 Extension 的能力,控制流走明确调用,不绕事件总线。
事件只表示已发生的事实,适合日志和派生处理等场景。不承担调用顺序、返回值、审批或回滚。
Extension:具体能力
每个 Extension 可以提供能力、调用其他公开能力、发布事件,管理自己的数据和资源。Extension 之间只依赖公开契约,不引用彼此实现。
Tool、页面、命令和事件监听器只是 Extension 内部组成,不升级为架构层。新增能力默认写进现有 Extension;需要独立启停、独立长期资源、可替换实现或明确产品边界时,才创建新 Extension。
产品:Extension 组合
Runtime 内只有一套 Kernel、Extension 实例和本地数据。CLI、Web、Desktop 不各自实现 Agent,而是选择不同的 Extension 组合:
1 | 共享 Extensions + 产品 Extensions → Runtime |
产品定义只负责列出要启用的 Extension,不含业务逻辑。三个入口共享同一套 Workspace、Conversation、Agent 和数据状态,各自保留不同的交互方式。
最后
这套架构的目标不是覆盖所有未来可能,而是让当前代码容易理解和修改。下一篇展开具体的目录布局和数据存放规则。