长期记忆快速入门

为 Convai 角色启用长期记忆，并在 Unity 编辑器中通过三个步骤验证跨会话回忆。

长期记忆在满足两个条件后会自动工作：在 Convai 仪表板上为你的角色启用记忆，并且 SDK 正在发送稳定的用户标识符。本指南将逐步说明这两个条件，并展示如何确认它们正在工作。

先决条件

开始前，请确认：

• A ConvaiCharacter 已在场景中，并且其 Character ID 已在检视器中设置
• 你的角色的长期记忆已在 Convai 仪表板

对于默认的 LTM 体验，你无需编写任何代码。SDK 的 DeviceEndUserIdProvider 会自动生成一个稳定的标识符。参见 终端用户身份 如果你有身份验证系统，并且需要提供自己的用户 ID。

---

为角色启用记忆

1

在仪表板上启用记忆

1. 登录到 convai.com 并打开你想要使用的角色。
2. 选择 Memory 角色设置侧边栏中的选项卡。
3. 切换 长期记忆 到 在.
4. 保存角色。

此设置会全局应用于该角色。任何连接到此角色 ID 的应用程序、SDK 版本和部署都会发送并接收记忆。在为共享角色启用之前，请先与你的团队协调。

Convai 仪表板中的长期记忆开关已启用。

2

在 Play 模式中开始对话

在 Unity 编辑器中运行你的场景。与角色开始对话，并分享角色应记住的信息——例如：

"我叫 Jordan，我是夜班的安全主管。"

让对话自然结束，然后 停止 Play 模式。会话结束会触发 Convai 提取并存储你分享的事实。

3

重新进入 Play 模式并验证回忆

再次进入 Play 模式，并让角色提及它学到的内容：

"你还记得我是谁吗？"

角色应能识别你的姓名和角色，而无需你重复。

如果角色提到了上一会话中的细节，则长期记忆工作正常。

---

编辑器中的身份识别如何工作

SDK 的默认设置 DeviceEndUserIdProvider 会自动处理身份。在 Play 模式下，它会读取或创建一个持久化 GUID，存储在 PlayerPrefs 中的 GUID，键为 "convai.end_user_id"。同一台机器上的每个 Play 模式会话都使用相同的 GUID，因此记忆会像真实用户一样在会话之间累积。当你停止 Play 模式时，Convai 会处理对话并提取事实，作为 MemoryRecord 条目。下一次会话中，这些记录会在角色生成第一条回复之前被注入到其上下文中。

GUID 会一直保留，只要 PlayerPrefs 未被清除。清除 PlayerPrefs 或重新安装应用程序会生成一个新的 GUID，服务器会将其视为新用户——不会继承任何记忆。参见 终端用户身份 有关在重新安装后仍然有效的策略。

---

Player 构建中的身份识别

在 Player 构建中， DeviceEndUserIdProvider 首先尝试 SystemInfo.deviceUniqueIdentifier。如果该值不可用或无效，则回退到相同的 PlayerPrefs 在编辑器中使用的 GUID 方案。

上下文	身份来源
Unity 编辑器	PlayerPrefs GUID——每个项目稳定
Player 构建（设备 ID 可用）	SystemInfo.deviceUniqueIdentifier
Player 构建（设备 ID 不可用）	PlayerPrefs GUID——在重新安装前保持稳定

对于用户通过账户登录的应用，请将 DeviceEndUserIdProvider 替换为一个返回你的账户 ID 的自定义提供程序。基于设备的 ID 无法跟随更换设备的用户。参见 终端用户身份 了解实现细节。

---

下一步

最终用户身份为角色配置记忆长期记忆如何工作