更新画像记忆-UpdateProfile--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

请输入

画像记忆

更新画像记忆-UpdateProfile

概述

用于更新已写入库的画像记忆。

方法定义

collection.update_profile(profile_id, memory_info, headers=None, timeout=None)

请求参数

参数	类型	是否必须	参数说明
profile_id	String	是	需要更新的画像记忆id。
memory_info	Object	是	画像记忆的内容。对于内置画像sys_profile_v1只有user_profile；对于自定义画像，按照自定义的属性字段展示。需要注意的是，其格式必须遵循在记忆库中已定义的格式。如：内置画像sys_profile_v1： { "user_profile": "### 基础信息性别女/年龄 28/家乡广州/职业产品经理" } 自定义画像： { "knowledge_point_name": "math", "rating_score_max": 100 }

参数

类型

是否必须

参数说明

profile_id

String

是

需要更新的画像记忆id。

memory_info

Object

是

画像记忆的内容。对于内置画像sys_profile_v1只有user_profile；对于自定义画像，按照自定义的属性字段展示。
需要注意的是，其格式必须遵循在记忆库中已定义的格式。如：

内置画像sys_profile_v1：

{
"user_profile": "### 基础信息

性别女/年龄 28/家乡广州/职业产品经理"
}

自定义画像：

{
"knowledge_point_name": "math",
"rating_score_max": 100
}

响应消息

参数	类型	参数说明
code	Integer	状态码，0表示成功，其他表示错误。
message	String	返回信息，成功时通常为 "success"。失败则返回原因。
request_id	String	标识每个请求的唯一ID。

完整示例

请求消息

Python请求

import json
import os
import time

from vikingdb import APIKey
from vikingdb.memory import VikingMem


def build_client() -> VikingMem:
    api_key = os.getenv("MEMORY_API_KEY")
    if not api_key:
        raise RuntimeError("Missing credentials: set MEMORY_API_KEY")
    auth = APIKey(api_key=api_key)

    return VikingMem(
        host="api-knowledgebase.mlp.cn-beijing.volces.com",
        region="cn-beijing",
        auth=auth,
        scheme="http",
    )


def main() -> None:
    client = build_client()

    collection = client.get_collection(collection_name="your_collection", project_name="default")

    now_ms = int(time.time() * 1000)
    user_id = f"sdk_example_user_{now_ms}"

    created = collection.add_profile(
        profile_type="profile_v1",
        user_id=user_id,
        assistant_id="sdk_example_assistant",
        memory_info={"user_profile": "基础信息: 喜欢 跑步/咖啡"},
    )

    profile_id = (created.get("data") or {}).get("profile_id")
    if not profile_id:
        raise RuntimeError(f"add_profile did not return profile_id, response={created}")

    updated = collection.update_profile(
        profile_id=profile_id,
        memory_info={"user_profile": "兴趣偏好: 运动/马拉松"},
    )

    print("update_profile response:")
    print(json.dumps(updated, indent=2, ensure_ascii=False))
    print("profile_id:", profile_id)
    print("user_id:", user_id)


if __name__ == "__main__":
    main()

响应消息

执行成功返回

{
    "code":0,
    "message":"success",
    "request_id":"021695029537650fd001de666660000000000000000000230da93"
}

最近更新时间：2026.04.21 20:42:18

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

请求消息 #

Python请求 #

响应消息 #

执行成功返回 #

请求消息

Python请求

响应消息

执行成功返回