腾讯云数据库 AI 服务快速体验

本文旨在指导您如何快速部署并体验 Memory 服务，包括开通服务、连接服务、写入事件及检索记忆等，通过真实案例演示其快速构建过程。
说明：
当前 Memory 为内测阶段，免费体验时长为3个月。
准备工作
已注册腾讯云账号并完成实名认证。
如需注册腾讯云账号：请单击 注册腾讯云账号。
如需完成实名认证：请单击 实名认证。
申请一台与 Memory 服务在同一地域（目前仅开放广州）的云服务器，并确保该服务器与 Memory 网络互通，以获得安全且低延迟的访问体验。
操作步骤
步骤1：新建 Memory 
使用腾讯云账号登录 Memory 智能体控制台 页面，单击新建 Memory，进入 Memory 配置页面，如下图所示。在服务名称的输入框，根据界面提示要求，指定 Memory 的名称，单击右下角的立即试用，等待任务执行完成即可。
﻿
步骤2：获取 Memory 连接凭据
在 Memory 服务列表页面，可看到新建的 Memory 卡片，如下图所示。
Memory ID：将鼠标悬停在 ID 上，点击 ID 可一键复制 Memory ID。
访问地址及密钥：单击卡片，可在服务概览的 API 接入区域获取 Memory 访问地址与访问密钥。
﻿
步骤3：在客户端安装 tdaimemory SDK
使用 pip 命令，在 CVM 上安装 SDK，如下示例，推荐使用 Python 3.8及以上版本。
pip3 install tdaimemory-0.0.1-py3-none-any.whl
步骤4：初始化 Memory 客户端
配置连接凭据参数，创建客户端连接对象。获取连接凭据，请参见 步骤2：获取 Memory 连接凭据。
EndPoint：配置新建 Memory 的访问地址。
ApiKey ：配置新建 Memory 的访问密钥。
MemoryId：配置 Memory ID。
from tdaimemory import MemoryClient
﻿
﻿
EndPoint = "https://memory.tdai.tencentyun.com"
ApiKey = "***************************"
MemoryId = "tdai-mem-********"
client = MemoryClient(endpoint=EndPoint,
                      api_key=ApiKey,
                      memory_id=MemoryId,
                      timeout=100)
﻿
步骤5：创建 Session
调用 create_session() 接口来为特定用户（actor）创建一个新的 Agent-Memory 会话。创建时需指定一个会话名称（name），该名称可为1到128个字符之间的任意字符串。
import json
session = client.create_session(
    name="Travel_Consultation",
)
session_id = session['session_id']
print(session_id)
步骤6：追加 Event
在创建的 Session 后，使用 append_event() 接口为此次会话追加具体的事件消息，系统将按照记忆策略分析写入记忆库。
﻿
import json
﻿
event = client.append_event(
    session_id="session-1c54d41a********",
    actor_id="user-sdk-test",
    messages=[
         {
            "role": "user",
            "content": "嗨，帮我规划一个下周去杭州的3天行程。",
            "timestamp": "2025-12-01T10:00:05Z"
        },
        {
            "role": "assistant",
            "content": "好的，已为您推荐杭州三日行程。第一天，我们聚焦西湖经典。清晨从断桥残雪出发，漫步白堤，感受水墨画般的湖光山色。随后乘船登岛探访三潭印月，下午登雷峰塔俯瞰全景，傍晚在曲院风荷赏夕阳，晚上则去河坊街夜市品尝地道小吃。\\n\\n第三天，探索湿地与运河文化。上午在西溪湿地乘坐摇橹船，听船娘小调，感受水乡慢生活；下午逛一逛桥西历史街区和文艺的小河直街，参观工艺美术博物馆，在咖啡馆小憩后即可轻松结束旅程，准备返程。\\n\\n第二天，体验禅意与宋韵。上午前往灵隐寺景区祈福，在法喜寺的黄墙拍照打卡；下午沉浸于宋城，体验AR剧本杀并观看《宋城千古情》演出；如果傍晚还有精力，可以去九溪烟树享受清凉的溪水。",
            "timestamp": "2025-12-01T10:00:05Z"
        },
        {
            "role": "user",
            "content": "我喜欢人少、安静的地方，对美食特别感兴趣。",
            "timestamp": "2025-12-01T10:00:05Z"
        },
        {
            "role": "assistant",
            "content": "基于您喜欢安静和美食的偏好，我为您优化了行程，避开了团队游客扎堆的景点，专注于幽静的体验和地道的风味。\\n\\n第一天：避世西湖\\n清晨漫步杨公堤与茅家埠，享受静谧湖景。午餐在老字号「奎元馆」吃虾爆鳝面。下午乘船访三潭印月，傍晚在湖边茶社小坐。晚餐去本地人爱的胜利河美食街尝地道风味。\\n\\n第二天：禅意之路\\n一早探灵隐寺，然后沿幽静天竺路步行至法喜寺。午餐在「知竹」吃素面。下午深入云栖竹径看竹海。晚餐用「新丰小吃」的喉口馒头等市井味道收尾。\\n\\n第三天：水乡慢生活\\n全天在西溪湿地坐摇橹船，深入芦苇荡享受宁静。午后往文艺的小河直街，在运河畔的咖啡馆小坐休憩，结束旅程。",
            "timestamp": "2025-12-01T10:00:05Z"
        },
        {
            "role": "user",
            "content": "太好了，酒店要带健身房，另外我对花生严重过敏，预订餐厅时请务必注意。",
            "timestamp": "2025-12-01T10:00:05Z"
        },
        {
            "role": "assistant",
            "content": "好的，已完全了解您的需求（偏好安静人少、喜爱美食、酒店需带健身房、对花生严重过敏）。为您精选的酒店（带健身房）：\\n\\n西湖庐驿精品酒店：位于西湖区，设计静谧，配备健身房，且远离闹市，符合您对安静的需求。\\n\\n杭州西溪紫金港希尔顿逸林酒店：靠近西溪湿地，设施完善，健身房专业，适合在第三天安排湿地行程时入住。",
            "timestamp": "2025-12-01T10:00:05Z"
        },
        {
            "role": "user",
            "content": "完美！哦对了，我女朋友更喜欢现代艺术，有什么地方可以推荐吗？",
            "timestamp": "2025-12-01T10:00:05Z"
﻿
        },
        {
            "role": "assistant",
            "content": "收到！考虑到您女朋友的喜好。这是为您和您女友定制的杭州三日行程：\\n\\n第一天：上午游茅家埠、杨公堤；下午观天目里美术馆现代展览。晚餐于胜利河美食街 品尝安全地道的本帮菜。\\n\\n第二天：上午早访灵隐寺，漫步幽静天竺路。下午重点参观 浙江省博物馆之江馆 重磅国际艺术大展。晚餐体验本地 新丰小吃（已规避风险）。\\n\\n第三天：上午于 西溪湿地乘摇橹船。下午在小河直街 咖啡馆悠闲小憩，结束旅程。",
            "timestamp": "2025-12-01T10:00:05Z"
        }
    ],
)
print(json.dumps(event, ensure_ascii=False))
步骤7：快速召回
使用 search_records() 接口，指定关键词，快速召回记忆。
说明：
等待 Event 写入完成，即可开始搜索 Record 记忆。
﻿
search_records = client.search_records(
    actor_id="user-sdk-test",
    query="用户喜欢什么美食",
    type="episodic",
)
print(json.dumps(search_records, ensure_ascii=False))
搜索结果，如下所示。
﻿
{
    "records": [
        {
            "record_id": "mem_e607197e********",
            "record_content": "基于您喜欢安静和美食的偏好，我为您优化了行程，避开了团队游客扎堆的景点，专注于幽静的体验和地道的风味。\\n\\n第一天：避世西湖\\n清晨漫步杨公堤与茅家埠，享受静谧湖景。午餐在老字号「奎元馆」吃虾爆鳝面。下午乘船访三潭印月，傍晚在湖边茶社小坐。晚餐去本地人爱的胜利河美食街尝地道风味。\\n\\n第二天：禅意之路\\n一早探灵隐寺，然后沿幽静天竺路步行至法喜寺。午餐在「知竹」吃素面。下午深入云栖竹径看竹海。晚餐用「新丰小吃」的喉口馒头等市井味道收尾。\\n\\n第三天：水乡慢生活\\n全天在西溪湿地坐摇橹船，深入芦苇荡享受宁静。午后往文艺的小河直街，在运河畔的咖啡馆小坐休憩，结束旅程。",
            "type": "episodic",
            "updated_time": "",
            "activity_start_time": "2025-12-01T00:00:00Z",
            "activity_end_time": "2025-12-03T23:59:59Z",
            "scene_name": "我（AI）在和用户做杭州三日休闲旅行规划，包含安静路线、美食体验及住宿安排",
            "event_id": "event-724c5fe6********"
        },
        {
            "record_id": "mem_0230efad********",
            "record_content": "太好了，酒店要带健身房，另外我对花生严重过敏，预订餐厅时请务必注意。",
            "type": "episodic",
            "updated_time": "",
            "activity_start_time": "2025-12-01T10:00:05Z",
            "activity_end_time": "2025-12-01T10:00:05Z",
            "scene_name": "我（AI）在和用户做杭州三日休闲旅行规划，包含安静路线、美食体验及住宿安排",
            "event_id": "event-2855d62a********"
        },
        {
            "record_id": "mem_2c33235c********",
            "record_content": "好的，已完全了解您的需求（偏好安静人少、喜爱美食、酒店需带健身房、对花生严重过敏）。为您精选的酒店（带健身房）：\\n\\n西湖庐驿精品酒店：位于西湖区，设计静谧，配备健身房，且远离闹市，符合您对安静的需求。\\n\\n杭州西溪紫金港希尔顿逸林酒店：靠近西溪湿地，设施完善，健身房专业，适合在第三天安排湿地行程时入住。",
            "type": "episodic",
            "updated_time": "",
            "activity_start_time": "2025-12-01T10:00:05Z",
            "activity_end_time": "2025-12-01T10:00:05Z",
            "scene_name": "我（AI）在和用户做杭州三日休闲旅行规划，包含安静路线、美食体验及住宿安排",
            "event_id": "event-63fb98fa********"
        }
    ],
    "events": [
        {
            "event_id": "msg_5fe661c6********",
            "event_content": "基于您喜欢安静和美食的偏好，我为您优化了行程，避开了团队游客扎堆的景点，专注于幽静的体验和地道的风味。\\n\\n第一天：避世西湖\\n清晨漫步杨公堤与茅家埠，享受静谧湖景。午餐在老字号「奎元馆」吃虾爆鳝面。下午乘船访三潭印月，傍晚在湖边茶社小坐。晚餐去本地人爱的胜利河美食街尝地道风味。\\n\\n第二天：禅意之路\\n一早探灵隐寺，然后沿幽静天竺路步行至法喜寺。午餐在「知竹」吃素面。下午深入云栖竹径看竹海。晚餐用「新丰小吃」的喉口馒头等市井味道收尾。\\n\\n第三天：水乡慢生活\\n全天在西溪湿地坐摇橹船，深入芦苇荡享受宁静。午后往文艺的小河直街，在运河畔的咖啡馆小坐休憩，结束旅程。",
            "scene_name": null,
            "timestamp": null
        },
        {
            "event_id": "msg_c7dcab3b********",
            "event_content": "完美！哦对了，我女朋友更喜欢现代艺术，有什么地方可以推荐吗？",
            "scene_name": null,
            "timestamp": null
        },
        {
            "event_id": "msg_679ad772********",
            "event_content": "好的，已完全了解您的需求（偏好安静人少、喜爱美食、酒店需带健身房、对花生严重过敏）。为您精选的酒店（带健身房）：\\n\\n西湖庐驿精品酒店：位于西湖区，设计静谧，配备健身房，且远离闹市，符合您对安静的需求。\\n\\n杭州西溪紫金港希尔顿逸林酒店：靠近西溪湿地，设施完善，健身房专业，适合在第三天安排湿地行程时入住。",
            "scene_name": null,
            "timestamp": null
        },
        {
            "event_id": "msg_14827fd4********",
            "event_content": "太好了，酒店要带健身房，另外我对花生严重过敏，预订餐厅时请务必注意。",
            "scene_name": null,
            "timestamp": null
        },
        {
            "event_id": "msg_56657fbf********",
            "event_content": "收到！考虑到您女朋友的喜好。这是为您和您女友定制的杭州三日行程：\\n\\n第一天：上午游茅家埠、杨公堤；下午观天目里美术馆现代展览。晚餐于胜利河美食街 品尝安全地道的本帮菜。\\n\\n第二天：上午早访灵隐寺，漫步幽静天竺路。下午重点参观 浙江省博物馆之江馆 重磅国际艺术大展。晚餐体验本地 新丰小吃（已规避风险）。\\n\\n第三天：上午于 西溪湿地乘摇橹船。下午在小河直街 咖啡馆悠闲小憩，结束旅程。",
            "scene_name": null,
            "timestamp": null
        }
    ],
    "total_count": 8
}
步骤8：Agentic 召回
使用 deepsearch 接口，设置问题，获取使用 AI 模型对记忆进行深度搜索和总结的答案。
search_records = client.deepsearch(
    actor_id="user-sdk-test",
    query="用户喜欢什么美食",
)
查询结果，如下所示。
{
  "records": {
    "query": "用户喜欢什么美食",
    "answer": "根据记忆，用户对美食表现出浓厚兴趣，但具体喜欢哪些美食类型或菜系的信息并未明确提及。此外，用户对饮食环境有一些偏好，例如喜欢人少、安静的地方用餐。同时需要注意的是，用户对花生严重过敏，在安排饮食时需特别避免含有花生成分的食物。"
  }
}
快速体验

本页目录：

准备工作

操作步骤

步骤1：新建 Memory

步骤2：获取 Memory 连接凭据

步骤3：在客户端安装 tdaimemory SDK

步骤4：初始化 Memory 客户端

步骤5：创建 Session

步骤6：追加 Event

步骤7：快速召回

步骤8：Agentic 召回
