SDK 接入
Python SDK

Python SDK

Python SDK 适合后端服务、Agent Worker、数据处理脚本和自动化任务。

安装

pip install memaster

配置 API Key

export MEMASTER_API_KEY="msk_xxx"

写入记忆

from memaster import MemoryClient
 
client = MemoryClient(api_key="msk_xxx")
 
client.add(
    user_id="user_123",
    messages=[
        {"role": "user", "content": "我喜欢中文回复，正在评估 AI 记忆方案"},
        {"role": "assistant", "content": "我会优先使用中文，并保留你的偏好。"},
    ],
    metadata={"project": "demo", "source": "chat"},
    infer=True,
)

检索记忆

results = client.search(
    query="用户偏好什么回复语言？",
    user_id="user_123",
    top_k=5,
)
 
for item in results["results"]:
    print(item["memory"])

在 Agent 中使用

建议在 Agent 回复前调用 search 获取相关长期记忆，并把结果注入 system prompt 或上下文片段；在一轮对话结束后调用 add 写入新的稳定事实。设置 infer=True 时，服务端会先用 LLM 从消息中抽取稳定记忆并去重。

下一步

概览TypeScript SDK