Skip to main content
可以给 Agent 记忆,但请在它开始收集每一枚回形针前先给抽屉贴标签。

1. 动机

实用 Agent 需要有边界的数据表面、显式工具与持久笔记。 本工作坊用 HeavenBase 原语构建这些部件,不需要 API 密钥或独立编排运行时。

2. 重建工作区

创建一个带一个 Preset、三个请求扩展与一个用户 Entity 的版本 2 清单:
重放会注册兼容的持久工作区,并保持激活选择不变。 清单包含 schema 与构造,而不包含行数据。

3. 写入并查询数据

同一个工作区支持类型化 Python 表达式、Mongo 风格映射与 query_json。 当 Agent 或操作者需要路由证据时,请使用 explain()

4. 注册限定 Profile

Profile 选择 Tool 分组、Entity 可见性、Skill 可见性与序列化方式。
Profile 注册会通过 Context 拥有的 ModuleService 写入。 它不会创建第二套插件 Registry。

5. 构建 Agent Toolkit

在显式注册到应用工作区前,该 Toolkit 是一个内存对象。 它的 Profile 限制向 Agent 公开的 Entity 表面。

6. 添加扁平 Memory

Memory 条目是由可选 Memory 扩展拥有的普通 HeavenBase 行。 它们可通过同一个工作区边界检查与查询。

7. 添加版本化项目状态

扁平 Memory 适合可搜索笔记,Memstate 适合版本化项目 keypath。 两个表面都不会悄悄持久化 LLMSession;LLM Session 持久化仍是独立边界。

总结

  • 版本 2 清单重建不含行的工作区外壳。
  • MCP Profile 限定 Agent 的 Tool、Entity、Skill 与输出格式。
  • Memory 与 Memstate 通过普通工作区 Entity 持久化。
  • Toolkit 注册与 LLM Session 持久化仍是显式决定。

进一步探索

相关资源: