为角色配置记忆

可通过 Convai 仪表板或 CharacterService 脚本 API 按角色开启或关闭长期记忆，并了解全局作用域的影响。

默认情况下，长期记忆处于禁用状态（MemorySettings.IsEnabled = false）。在您明确启用之前，不会提取或存储任何事实。您可以通过 Convai 仪表板启用或禁用记忆，或通过以下方式以编程方式操作： client.Characters.

记忆设置会全局应用于该角色。 为某个角色启用 LTM 会影响连接到该角色 ID 的每个应用、SDK 版本和部署。如果您在开发、预发布和生产环境之间共享同一个角色，那么在一个环境中启用记忆会使所有环境都启用。请在共享角色上启用之前与您的团队协调。

启用或禁用记忆

这是大多数团队推荐的方法。更改会立即生效，无需更新代码或重新部署。

在以下位置登录 convai.com.
打开您想配置的角色。
选择 Memory 角色设置侧边栏中的选项卡。
切换 长期记忆 到在.
单击保存.

要禁用，请重复相同步骤并切换 长期记忆 到关闭.

使用 client.Characters 当您需要程序化控制时——例如在自动化测试设置、构建流水线或运行时管理面板中。

检查当前状态

using Convai.RestAPI;
using UnityEngine;

public class MemoryAdmin : MonoBehaviour
{
    private async void Start()
    {
        using var client = new ConvaiRestClient(ConvaiSettings.Instance.ApiKey);

        bool isEnabled = await client.Characters.GetMemoryEnabledAsync("your-character-id");
        Debug.Log($"LTM enabled: {isEnabled}");
    }
}

启用记忆

using Convai.RestAPI;
using UnityEngine;

public class MemoryAdmin : MonoBehaviour
{
    private async void Start()
    {
        using var client = new ConvaiRestClient(ConvaiSettings.Instance.ApiKey);

        await client.Characters.SetMemoryEnabledAsync("your-character-id", true);
        Debug.Log("Long-term memory enabled.");
    }
}

禁用记忆

await client.Characters.SetMemoryEnabledAsync("your-character-id", false);

在不删除记录的情况下禁用记忆

禁用 LTM 会停止提取新的记忆，但 不会删除现有的记忆记录。已存储的事实仍保留在 Convai 上，如果您稍后重新启用 LTM，它们将被重新注入。

如果您想在禁用 LTM 并移除所有已存储记忆，请先删除记忆，然后再禁用。

如果要在禁用前清除某个用户–角色对的所有记忆，请使用 client.Memory.DeleteAllAsync 然后调用 SetMemoryEnabledAsync. DeleteAllAsync 会删除某个特定用户–角色对的记忆。若要改为删除跨所有角色的所有终端用户记录，请使用 client.EndUsers.DeleteAsync(endUserId)记录的警告。请参阅管理终端用户记录.

请参见长期记忆使用示例以实现完整重置模式。

下一步

最终用户身份管理最终用户记录

最后更新于 1个月前

这有帮助吗？