长期记忆快速开始

三步为 Convai 角色启用长期记忆，并验证在 Unity Editor 中跨独立会话的回忆仍然有效。

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

前提条件

开始之前，请确认：

• 某个 ConvaiCharacter 位于场景中，并在 Inspector 中设置了其 Character ID
• 你的角色的长期记忆已在 Convai 仪表板

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

---

为角色启用记忆

1

在仪表板上启用记忆

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

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

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

2

在 Play Mode 中开始一次对话

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

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

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

3

重新进入 Play Mode 并验证回忆

再次进入 Play Mode，并让角色引用它学到的内容：

"你还记得我是谁吗？"

角色应该能认出你的名字和角色，而无需你重复说明。

如果角色引用了上一会话中的细节，说明长期记忆工作正常。

---

编辑器中的身份工作方式

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

只要 PlayerPrefs 未被清除，GUID 就会一直保留。清除 PlayerPrefs 或重新安装应用会生成新的 GUID，服务器会将其视为新用户——不会保留任何记忆。参见 最终用户身份 了解可在重新安装后仍然保留的策略。

---

玩家构建中的身份

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

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

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

---

下一步

终端用户身份为角色配置记忆长期记忆的工作原理