管理上下文

保存与召回 Memory

Memory 保存持久的决策、约束和事实。每条新记忆使用独立的 atomic-memory Artifact;完整接口、四态与旧 API 兼容见 使用 Atomic Memory。PreparedContext 为单次请求筛选相关历史,属于临时结果,不会再创建一条 Memory。

保存、召回与纠正

  1. 完成 Quick Start,让不同会话解析到相同 Scope。
  2. 显式请 Agent 保存信息。直接调用 remember_memory 不需要模型。
  3. 使用 search_memory 搜索,或在宿主提供对应工具时用 list_memory_entries 和 get_memory_entry 检查条目。 引用结果时保留返回的精确 ArtifactRef;精确历史按 Atomic Memory revision 读取。
  4. 使用通用 Artifact Replace 修订正文,或通过 Atomic lifecycle 将记忆设为 forgotten;正文和历史保留, 可使用恢复接口重新在役。修订正文需要当前正文 ETag,遗忘需要精确引用和 state_version。

各宿主工具名称不同,见接入 Agent。完整请求结构和并发要求见 HTTP API。

FTS 的候选检索和准入使用相同的查询词。查询归一化会排除较长查询中的常见英语虚词,并识别问题前后独立的执行指令, 例如“Use only supplied context”、“Do not call tools, read files, inspect old sessions, or delegate”,以及 “Answer briefly and cite the artifact reference from the provided context. If no reliable context is present, say so.”。 这些指令不能为无关事实提供匹配依据。显式加引号的词始终参与检索,包括 "AND" "OR" precedence 中作为标识符的虚词。 包含领域信息的指令和未识别的措辞仍参与检索;这是一项保守的词项规则, 并非通用意图分类器。默认准入要求匹配剩余全部不同查询词的 25%,至少两个;只有一两个词的查询要求匹配一个词。 直接搜索和上下文准备使用相同规则,可选的 recall gate 放宽门槛时也如此。存储文本和向量查询保持不变, 词语重合本身不能证明语义相关。 如果整个查询只有执行指令,仍保留其查询词,以便搜索这条策略本身。

自动上下文与提取

召回 Hook 向 Server 请求有大小上限的 PreparedContext。没有相关信息时返回 empty 是正常结果。 历史内容不能覆盖当前指令或项目现状。

按输出标准上下文文本选择 Memory、Experience、Profile 和 Topic Memory, 设置输出顺序、各类别条数及总条数上限。

采集 Prompt 会创建 Source 证据,不保证提取出 Memory。按模型配置 启用生成模型与 Source 处理;只有需要向量或混合搜索时才配置 Embedding。 记录项目信息前,检查宿主的 Prompt 采集开关。

Topic Memory 有独立的处理与检索入口,包括 MCP 的 search_topic_memory 和 get_topic_memory。 基本的显式 Memory 写入不会启用 Topic Memory;相关设置和运行时能力见配置。

交接当前任务边界使用 Handoff,保留原始证据使用 Sources。

On this page