TenseMem icon

TenseMem

TenseMem 是面向 AI 智能体的嵌入式 Python 记忆系统,基于 SQLite 保存当前与历史类型化事实,支持确定性解析、关注新鲜度的读取和持久化更正。

TenseMem

面向 AI 智能体的嵌入式时间感知记忆

TenseMem 是面向 AI 智能体的嵌入式 Python 记忆系统,适用于需要超越基于相似度召回能力的场景。它会存储片段并从中推导类型化事实,在维护历史值的同时保留当前状态,使智能体能够区分当前为真的内容与早先为真的内容。

默认存储是应用进程内使用的单个 SQLite 文件,核心工作流无需单独的服务器。提取器会根据用户消息提出操作,而确定性规则负责解析并应用这些操作。`state()`、`history()`、`context()` 和 `search()` 等读取接口会公开新鲜度信息,使应用能够判断返回的记忆是否反映了最新输入。

主要功能

片段日志与可重建事实

片段会作为仅追加日志保留,而事实则提供可重建的投影。调用 `rebuild()` 可以通过更新后的提取流程重新处理相同的片段。

时间基数

ONE 谓词最多维护一个活动值,在不删除历史记录的情况下取代较旧的值。MANY 谓词支持多个活动值,直到这些值被替换或移除。

关注新鲜度的读取

状态、历史记录、上下文和搜索读取会报告片段水位线、待处理工作以及失败状态。`context()` 可以在返回前等待指定序列。

污染控制

召回的 `context()` 文本会被加围栏处理,并在提取前移除加围栏的文本片段。提议的操作还要求引用剩余用户文本中的逐字内容,有助于防止自我回显。

持久化更正

`correct(fact_id)` 会将事实标记为从未为真,恢复其取代的值,并在重建过程中保留该更正,同时允许之后发生真实变更。

实际使用场景

  • 用户档案状态

    跟踪用户当前所在城市等事实,同时保留已被取代的值,以便回答有关先前所在地的问题。该状态模型避免迫使智能体在相似度搜索返回的当前匹配和历史匹配之间进行选择。

  • 新鲜的对话上下文

    当智能体需要了解响应是否基于用户的最新消息时,使用新鲜度水位线和待处理消息信息。调用方可以在读取上下文前等待达到最小片段序列。

  • 可靠的更正工作流

    使用 `correct(fact_id)` 表示对已记忆事实的更正,恢复被取代的值,并在之后的重建过程中保留该更正。这支持智能体从错误提取的声明中恢复的工作流。

  • 本地智能体开发

    通过 Python API、CLI、REST 服务、MCP 接口或本地 Studio 检查器在本地运行记忆引擎。开发者可以先在单个 SQLite 数据库上测试智能体记忆,再连接真实提取器。

Pros and Cons

Pros

  • 嵌入式运行使用单个 SQLite 文件,无需单独的记忆服务。
  • 确定性解析将模型提出的操作与状态变更分离。
  • 当前值、历史事实、新鲜度状态和更正均有明确表示。
  • 核心测试工作流无需 API 密钥或托管模型调用即可运行。

Cons

  • 该项目标识为 0.1.0 alpha,因此 API 和行为仍可能发生变化。
  • 文档记录的默认存储是 SQLite;第二种 SQL 方言和托管式多租户 Studio 尚未随仓库提供。
  • 真实模型提取需要配置受支持的提供商及其凭据;无需密钥的 FakeExtractor 基于规则运行。

FAQ

如何开始使用 TenseMem?

TenseMem 是一个 Python 软件包。最小设置包括使用提取器创建 Memory 实例、注册类似 `lives_in` 的谓词、添加用户消息,然后读取生成的上下文。无需 API 密钥即可使用 `FakeExtractor`;此外还提供适用于 OpenAI、Anthropic、Ollama、LiteLLM 和 Gemini 工作流的提供商扩展。

语言模型会直接控制记忆变更吗?

提取器会从各个片段中提出类型化操作,但确定性解析器规则会决定允许哪些变更,并将其应用于基于 SQLite 的状态。模型不会直接决定最终状态。

TenseMem 如何处理变化的值或多个值?

可以。谓词可以采用 ONE 或 MANY 基数。对于 ONE 谓词,较新的值会取代之前的活动值,而较早的事实仍可通过历史记录访问。MANY 谓词可以保留多个活动值,直到这些值被替换或移除。

提取仍在处理时会发生什么?

读取操作会公开新鲜度信息,包括所反映的片段序列、待处理消息以及处理是否失败。`context()` 可以等待达到指定的最小序列,同时在提取尚未完成时,仍会说明返回的状态是否为最新状态。

Quick Facts

类别
开发者工具
主要用户
AI 智能体开发者
平台
Python 软件包
默认存储
SQLite 文件
状态
0.1.0 alpha
接口
Python API、CLI、REST、MCP 和本地 Studio