接口介绍
本接口(/memory/v1/record/append)用于创建新的长期记忆记录,用于存储用户自定义的个性化信息,如用户偏好、重要事实等。
Method 与 URL
POST https://{服务访问地址}/memory/v1/record/append
使用示例
curl -i -k -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer ******************************' \\-H "x-tdai-service-id: tdai-mem-8i8t****" \\https://memory.tdai.tencentyun.com/memory/v1/record/append \\-d '{"memory_id": "tdai-mem-8i8t****","actor_id": "user-test-001","session_id": "session-PTVM****","strategy": "旅游关注维度","content": "美食维度为地道风味。"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
memory_id | 是 | 指定需创建长期记忆的 Memory ID。 | |
actor_id | 是 | 指定需创建长期记忆的用户 ID。 | 数据类型:String 长度限制:[1,20] 字符规则:任意字符 |
session_id | 是 | 指定需创建长期记忆的会话 ID。 | |
content | 是 | 记录内容,描述记忆的实际信息。 | 数据类型:字符串 示例:"用户偏好使用深色主题,喜欢简洁的界面设计"。 |
strategy | 是 | 指定长期记忆的策略类型。 | 可设置的策略类型,默认支持如下策略,支持自定义其他策略: Persona_Profile:人物画像。 Task_Information:任务信息。 Factual_Experience:事实经验。 |
响应消息
执行成功,输出如下信息。
{"status": "success","message": "Record appended successfully","data": {"record_id": "record-Ukuw****"}}
参数名(一级) | 参数名(二级) | 参数含义 |
data | record_id | 系统随机分配的长期记忆 ID,用于唯一标识该记录。 |