本文旨在指导您如何快速部署并体验 Memory 服务，包括开通服务、连接服务、写入事件及检索记忆等，通过真实案例演示其快速构建过程。
说明：
当前 Memory 为内测阶段，免费体验时长为3个月。
准备工作
已注册腾讯云账号并完成实名认证。
如需注册腾讯云账号：请单击 注册腾讯云账号。
如需完成实名认证：请单击 实名认证。
申请一台与 Memory 服务在同一地域（目前仅开放广州）的云服务器，并确保该服务器与 Memory 网络互通，以获得安全且低延迟的访问体验。
操作步骤
步骤1：新建 Memory
1. 使用腾讯云账号登录 Memory 智能体控制台 页面，单击新建 Memory，进入 Memory 配置页面，如下图所示。
2. 参见下表说明，指定服务名称以及长期记忆策略，单击立即试用，等待任务执行完成，提示创建成功即可。
界面参数 | 解释 | 限制与建议 |
服务名称 | 记忆体的唯一标识名称。 | 支持60个字符内的中英文、数字、中划线及下划线，例如：Travel_Consultation。 |
长期记忆策略 | 指定长期记忆策略。 | 勾选默认策略：任务画像、任务信息、事实经验。 |
步骤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 客户端
EndPoint：配置新建 Memory 的访问地址。
ApiKey ：配置新建 Memory 的访问密钥。
MemoryId：配置 Memory ID。
from tdaimemory import MemoryClientEndPoint = "https://memory.tdai.tencentyun.com"ApiKey = "***************************************************"MemoryId = "tdai-mem-mfdk****"client = MemoryClient(endpoint=EndPoint,api_key=ApiKey,memory_id=MemoryId,default_actor_id="user-initial-test")
步骤5：创建 Session
调用 create_session() 接口来为特定用户（actor）创建一个新的 Agent-Memory 会话。创建时需指定一个会话名称（name），该名称可为1到128个字符之间的任意字符串。
import jsonsession = client.create_session(name="Travel_Consultation",)session_id = session['session_id']print(json.dumps(session_id, ensure_ascii=False))
步骤6：追加 Event
在创建的 Session 后，使用 append_event() 接口为此次会话追加具体的事件，系统将按照记忆策略分析写入记忆库。
event = client.append_event(session_id=session_id,messages={"chat": [{"role": "user","content": "嗨，帮我规划一个下周去杭州的3天行程。"},{"role": "assistant","content": "好的，已为您推荐杭州三日行程。第一天，我们聚焦西湖经典。清晨从断桥残雪出发，漫步白堤，感受水墨画般的湖光山色。随后乘船登岛探访三潭印月，下午登雷峰塔俯瞰全景，傍晚在曲院风荷赏夕阳，晚上则去河坊街夜市品尝地道小吃。\\n\\n第二天，探索湿地与运河文化。上午在西溪湿地乘坐摇橹船，听船娘小调，感受水乡慢生活；下午逛一逛桥西历史街区和文艺的小河直街，参观工艺美术博物馆，在咖啡馆小憩后即可轻松结束旅程，准备返程。\\n\\n第三天，体验禅意与宋韵。上午前往灵隐寺景区祈福，在法喜寺的黄墙拍照打卡；下午沉浸于宋城，体验AR剧本杀并观看《宋城千古情》演出；如果傍晚还有精力，可以去九溪烟树享受清凉的溪水。"},{"role": "user","content": "我喜欢人少、安静的地方，对美食特别感兴趣。"},{"role": "assistant","content": "基于您喜欢安静和美食的偏好，我为您优化了行程，避开了团队游客扎堆的景点，专注于幽静的体验和地道的风味。\\n\\n第一天：避世西湖\\n清晨漫步杨公堤与茅家埠，享受静谧湖景。午餐在老字号「奎元馆」吃虾爆鳝面。下午乘船访三潭印月，傍晚在湖边茶社小坐。晚餐去本地人爱的胜利河美食街尝地道风味。\\n\\n第二天：禅意之路\\n一早探灵隐寺，然后沿幽静天竺路步行至法喜寺。午餐在「知竹」吃素面。下午深入云栖竹径看竹海。晚餐用「新丰小吃」的喉口馒头等市井味道收尾。\\n\\n第三天：水乡慢生活\\n全天在西溪湿地坐摇橹船，深入芦苇荡享受宁静。午后往文艺的小河直街，在运河畔的咖啡馆小坐休憩，结束旅程。"},{"role": "user","content": "太好了，酒店要带健身房，另外我对花生严重过敏，预订餐厅时请务必注意。"},{"role": "assistant","content": "好的，已完全了解您的需求（偏好安静人少、喜爱美食、酒店需带健身房、对花生严重过敏）。为您精选的酒店（带健身房）：\\n\\n西湖庐驿精品酒店：位于西湖区，设计静谧，配备健身房，且远离闹市，符合您对安静的需求。\\n\\n杭州西溪紫金港希尔顿逸林酒店：靠近西溪湿地，设施完善，健身房专业，适合在第三天安排湿地行程时入住。"},{"role": "user","content": "完美！哦对了，我女朋友更喜欢现代艺术，有什么地方可以推荐吗？"},{"role": "assistant","content": "收到！考虑到您女朋友的喜好。这是为您和您女友定制的杭州三日行程：\\n\\n第一天：上午游茅家埠、杨公堤；下午观天目里美术馆现代展览。晚餐于胜利河美食街 品尝安全地道的本帮菜。\\n\\n第二天：上午早访灵隐寺，漫步幽静天竺路。下午重点参观 浙江省博物馆之江馆 重磅国际艺术大展。晚餐体验本地 新丰小吃（已规避风险）。\\n\\n第三天：上午于 西溪湿地乘摇橹船。下午在小河直街 咖啡馆悠闲小憩，结束旅程。"}],})
步骤7：搜索记忆
说明：
等待 Event 写入完成，即可开始搜索 Record 记忆。
search_records = client.search_records(content="下周去杭州的行程会去哪些地方？",session_id=session_id,# strategies=["Factual_Experience"],)print(json.dumps(search_records, ensure_ascii=False))
搜索结果，如下所示。
{"records": [{"created_at": 1757907027,"event_ids": "[\\"event-y4YD****\\"]","record_content": "第一天：上午游茅家埠、杨公堤；下午观天目里美术馆现代展览。晚餐于胜利河美食街 品尝安全地道的本帮菜。","record_id": "record-jTqG****","score": 0.7354369,"strategy_name": "Task_Information","updated_at": 1757907027},{"created_at": 1757907016,"event_ids": "[\\"event-y4YD****\\"]","record_content": "第二天：上午早访灵隐寺，漫步幽静天竺路。下午重点参观 浙江省博物馆之江馆 重磅国际艺术大展。晚餐体验本地新丰小吃","record_id": "record-YqNmt****","score": 0.6929885,"strategy_name": "Task_Information","updated_at": 1757907016},{"created_at": 1757907009,"event_ids": "[\\"event-y4YD****\\"]","record_content": "第三天上午于西溪湿地乘摇橹船。下午在小河直街 咖啡馆悠闲小憩。","record_id": "record-FtDf****","score": 0.64288217,"strategy_name": "Task_Information","updated_at": 1757907009},{"created_at": 1757907020,"event_ids": "[\\"event-y4YD****\\"]","record_content": "前两晚入住西湖庐驿精品酒店，位于西湖区，设计静谧，配备健身房，且远离闹市","record_id": "record-Zp9Ji0****","score": 0.5674117,"strategy_name": "Factual_Experience","updated_at": 1757907020},{"created_at": 1757907022,"event_ids": "[\\"event-y4YD****\\"]","record_content": "第三天晚上入住杭州西溪紫金港希尔顿逸林酒店，靠近西溪湿地，设施完善，健身房专业","record_id": "record-zGbVz****","score": 0.51946723,"strategy_name": "Factual_Experience","updated_at": 1757907022},{"created_at": 1757907028,"event_ids": "[\\"event-y4YD****\\"]","record_content": "用户喜欢人少、安静的地方，对美食特别感兴趣。","record_id": "record-kscmC****","score": 0.48046106,"strategy_name": "Persona_Profile","updated_at": 1757907028},{"created_at": 1757907032,"event_ids": "[\\"event-y4YD****\\"]","record_content": "用户预订酒店时需要配备健身房。","record_id": "record-ALokbk****","score": 0.4734102,"strategy_name": "Persona_Profile","updated_at": 1757907032},{"created_at": 1757907019,"event_ids": "[\\"event-y4YD****\\"]","record_content": "用户的女朋友喜欢现代艺术，故行程中也加入了现代艺术展览的点。","record_id": "record-61Mqo****","score": 0.47263998,"strategy_name": "Factual_Experience","updated_at": 1757907019},{"created_at": 1757907031,"event_ids": "[\\"event-y4YD****\\"]","record_content": "用户的女朋友更喜欢现代艺术。","record_id": "record-E0klI****","score": 0.40267542,"strategy_name": "Persona_Profile","updated_at": 1757907031},{"created_at": 1757907030,"event_ids": "[\\"event-y4YD****\\"]","record_content": "用户对花生严重过敏，请在预订餐厅时特别注意。","record_id": "record-pJ_g****","score": 0.38543546,"strategy_name": "Persona_Profile","updated_at": 1757907030}],"total_count": 10}
