创建 Record

最近更新时间:2025-09-12 21:41:52

我的收藏

接口定义

本接口append_record()用于创建新的长期记忆记录,用于存储用户自定义的个性化信息,如用户偏好、重要事实等。
def append_record(
session_id: str,
content: str,
strategy: str,
memory_id: str | None = None,
actor_id: str | None = None
) -> Dict[str, Any]


使用示例

import json
from tdaimemory import MemoryClient

record = client.append_record(
session_id="session-Y5oi****",
content="美食维度为地道风味优先",
strategy="旅游关注维度",
)
print(json.dumps(record, ensure_ascii=False))

请求参数

参数
是否必选
参数含义
配置方法及要求
memory_id
指定需创建长期记忆的 Memory ID。
登录 Memory 智能体控制台,可在 Memory 服务概览页面复制 Memory ID。具体可以参见 查看 Memory
actor_id
指定需创建长期记忆的用户 ID。
数据类型:String
长度限制:[1,20]
字符规则:任意字符
session_id
指定需创建长期记忆的会话 ID。
获取会话 ID,请参见 查询 Session
content
记录内容,描述记忆的实际信息。
数据类型:字符串
示例:"用户偏好使用深色主题,喜欢简洁的界面设计"。
strategy
指定长期记忆的策略类型。
可设置的策略类型,默认支持如下策略,支持自定义其他策略:
Persona_Profile:人物画像。
Task_Information:任务信息。
Factual_Experience:事实经验。

响应消息

执行成功,输出如下信息。
>>> print(json.dumps(record, ensure_ascii=False))
{"record_id": "record-Un4a****"}
参数名
参数含义
record_id
系统随机分配的长期记忆 ID,用于唯一标识该记录。