You need to enable JavaScript to run this app.
导航
画像记忆更新时机和更新方式配置示例
最近更新时间:2025.12.09 16:30:24首次发布时间:2025.12.09 16:30:24
复制全文
我的收藏
有用
有用
无用
无用

记忆更新时机和记忆更新方式怎么配置?

  • 更新时机

更新时机

适用场景

实时更新

已经接入线上流量,需要在写入原始数据后,实时进行画像更新

每日更新/每周更新

已经接入线上流量,但是画像更新不需要太频繁,按日或按周更新即可

手动更新

一次性写入大量历史数据,写入数据后再手动调接口触发更新,可以一次性做画像更新处理、节省token

  • 记忆更新方式:
    • 覆盖更新:常用方式,即持续更新当前画像
    • 新增并保存历史:新增记忆会保存历史版本,只有在更新时机为 每日更新/每周更新 时可选,仅在需要生成日报/周报场景下使用。

日报生成场景实践

一些业务场景下需要对历史记忆做周期总结,以面向用户做日报的展示,在记忆库可以通过如下操作实现。

step1: 创建记忆库,配置事件和画像

事件:可直接使用模板
画像:

  • 创建一个 weekly_summary 字段,关联 event_v1 的 summary 字段
  • 画像抽取方法,如果只是对事件做简单的summary,那么可以不填写特殊描述,如果需要做一些特定维度的总结,可以在画像抽取方法中进行详细的定义
  • 记忆更新时机选择每日更新,记忆更新方式选择新增并保存历史

Image

Image

step2: 写入数据

参考 AddSession 接口写入数据

step3: 检索日报

由于更新时机选择了每日更新,即平台会在每日 00:00 自动更新画像,处理上次更新后到昨天 23:59 之间产生的数据。
等到第二天,可以通过检索接口,检索指定日期的日报。使用方法参考接口:SearchProfileMemory
检索示例:

import os
import requests
import json

API_KEY = os.getenv("MEMORY_API_KEY", "your_key")
url = "https://api-knowledgebase.mlp.cn-beijing.volces.com/api/memory/profile/search"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

data = {
    "collection_name": "my_first_memory_collection",
    "query": "",
    "limit": 1,
    "filter": {
        "user_id": "user1",
        "memory_type": ["daily_summary"],
        "profile_date": "2025/01/01"
    }
}

response = requests.post(url, headers=headers, data=json.dumps(data))

print("Status Code:", response.status_code)
print("Response:", response.text)