# 记忆治理

对已同步的会话内容进行过滤，提取事件、事实和主体画像，并在去重与冲突处理后写入记忆。

## 开始前准备

确认工作区已经启用记忆治理，并准备可用于检查的已同步会话。先确定需要保留哪些信息，例如用户明确表达的偏好或已经发生的事件，再配置过滤与提取步骤。

本模板由会话触发，不填写文件来源、输出卷或普通文件模板的运行参数。会话及工作区上下文由系统提供。

## 使用模板

在创建工作流页面选择“从模板开始”，搜索“记忆治理”并载入画布。

启用记忆治理后，在创建入口填写名称，再配置过滤、提取和写入步骤。该流程由已同步会话触发，处理所需的会话信息由系统提供。

## 完整处理流程

过滤后并行处理记忆和画像，汇合后写入。

![记忆治理](../images/memory-governance-flow.svg)

## 理解过滤和提取

1. **会话输入**取得已同步会话内容。
2. **条件过滤**按照配置判断会话是否进入后续处理。
3. **语义过滤**进一步筛选需要处理的内容。
4. **事件提取和事实提取**并行执行，之后汇合到去重与冲突处理。
5. **主体画像提取**与上述记忆处理路径并行执行。
6. **记忆写入**在两条路径汇合后保存记忆及画像结果。

图中的两个并行分支分别表示事件/事实记忆处理和主体画像处理。不要把它们改成互斥条件分支。

## 配置时关注什么

| 步骤 | 配置与检查重点 |
| --- | --- |
| 条件过滤 | 明确哪些会话进入处理，避免把需要保留的会话提前排除 |
| 语义过滤 | 用具体内容说明保留范围，检查过滤后的结果 |
| 事件与事实提取 | 区分发生过的事件和可复用的事实，结果应有会话依据 |
| 主体画像提取 | 检查信息归属是否正确，不把他人的描述归到当前主体 |
| 去重与冲突处理 | 对照已有信息与新信息检查处理结果 |
| 记忆写入 | 保留在汇合后的末端，检查最终保存结果 |

创建步骤使用页面上出现的记忆治理入口和名称表单。编辑完成后，使用已同步会话检查实际触发结果，不以保存配置代替执行验证。

## 示例：整理客服会话中的偏好

选择一段包含明确偏好和一次服务事件的会话作为检查样本。配置保留范围后，检查偏好是否被提取为相应事实或画像信息，事件是否与原会话一致。再检查去重与写入，确认没有保存重复或归属错误的信息。

## 检查结果与排查

| 现象 | 检查与处理 |
| --- | --- |
| 看不到创建入口 | 确认记忆治理功能已启用 |
| 保存后没有执行记录 | 本流程等待已同步会话触发，检查是否有对应会话 |
| 应保留的内容未出现 | 从条件过滤、语义过滤依次检查，再看提取结果 |
| 记忆内容与原文不符 | 对照会话检查提取步骤和归属，修正配置后验证 |
| 提取有结果但没有记忆 | 检查去重、冲突处理及最终写入状态 |

这里的示例用于说明检查顺序。事件、事实和画像应分别核对，最终以实际保存结果确认处理完成。

## 继续阅读

- [工作流模板](index.md)
- [运行与调试](../run-debug.md)