跳到主要内容

批量新增 LTM 记忆

POST 

/ltm/spaces/:space_id/memories:batchCreate

不经过提炼,直接写入整理好的记忆,一次最多 100 条。每条是一条事实(某个用户的,或 Space 共享的),或者某个用户一个 Profile 字段的值,适合在控制台里补录、导入已有的用户档案、初始化共享规则。Summary 和 Reflection 不能写入。

每条的 topic 必须是所属策略的 Facts 主题或 Profile 字段,metadata 只能用 Space 声明过的键。平台只做这些格式校验,"只记明确说过的、不存敏感信息"这类提炼规则不适用,内容由调用方负责。写入 Facts 时会生成向量,费用记在 Space 所属主体,和 Search 相同。

timestamp 是这条信息成立或被说出的时间,会成为记录的时间:比它旧的对话提炼结果改不动这条记录,之后的新对话照常更新它。可以传过去的时间来导入历史记忆,但不能比服务器时间晚 5 分钟以上。

Profile 字段已经有别的值时,这一条失败(code 1746),并返回已有记录的 record_id,请改用 批量修改 LTM 记忆;写入和现有值相同的内容算作成功。

逐条独立处理,一条失败不影响其他条。返回时写入已经生效,List、Search、Context 和托管 Chat 召回都能读到,读取时这些记录的 source_type 为 api。传 client_token 时,用同一个 token 重试同一个请求不会重复写入:第一次写过的记录直接返回原来的 record_id,之后即使被删除也不会写回来。

Request​

Responses​

每条记录的处理结果。

自助排查