agentbase-docs

记忆

这是什么 / 何时用

Memory 为项目内的用户/Agent 提供长期记忆:把对话与事实写入项目隔离的记忆库,之后按语义检索、按 token 预算召回,或维护用户画像(profile)、技能(skill)、经验(experience)与蒸馏(distillation)。适合需要跨会话记住用户偏好、事实与历史行为的 Agent/助手应用。

资源分两层:数据面(记忆记录、检索、画像、蒸馏等)与控制面(项目级 Memory 配置:启用、命名空间配置、历史与回滚)。逻辑资源(Memory Resource)与项目绑定由部署/控制台配置管理(REST 管理接口),SDK 不直接暴露。

前置

使用骨架

关键参数与返回

错误与边界(2.6.0 一致性语义)

SDK 类别差异

各语言调用示例

控制面(启用 / 配置)示例保留在本页;写入、召回、管理等数据面示例见记忆管理。

控制面(启用 / 配置 / 历史回滚 / 审计)

控制面走 **Console SDK 或 REST(projects.write):绑定逻辑资源到项目、按 namespace 读写配置。配置更新必须单个 namespace + value**,首次创建 REST 显式 If-None-Match: *,更新带 expectedConfigVersion / If-Match;冲突 409 时重读 configVersion 再重试。

// consoleClient 为 Console SDK Client(Session / 短期 JWT),见 console-sdk/nodejs.md
const memory = new Memory(consoleClient);

// 资源与项目绑定(一次性初始化)
await memory.createResource({ /* 配额等资源参数 */ });
await memory.createProjectBinding({ projectId, resourceId /*, ...绑定参数 */ });

// 配置读改写(namespace ∈ runtime / prompt / policy / retention / provider / evolution)
const current = await memory.getProjectConfig({ projectId, namespace: 'policy' });
await memory.updateProjectConfig({
    projectId,
    namespace: 'policy',
    value: {
        ...current.editableValue,
        forgetting: { ...current.editableValue.forgetting, enabled: true }
    },
    expectedConfigVersion: current.configVersion,   // 冲突 409 → 重读后重试
    schemaVersion: current.schemaVersion,
    reason: 'Update Memory forgetting policy'
});

// 历史与回滚、审计
await memory.listProjectConfigHistory({ projectId, namespace: 'policy' });
await memory.createProjectConfigRollback({ projectId, namespace: 'policy' /*, 目标版本 */ });
await memory.listAudits({ projectId });

示例指引

事实源