核心概念
在接入 Memaster 前，建议先理解下面几个核心概念。它们会影响你如何组织用户、Agent、会话和记忆检索范围。
Memory（记忆）
记忆是从对话或业务事件中沉淀出来的长期事实、偏好、决策或上下文。Memaster 会把原始输入转化为可检索的结构化内容，并附带向量、元数据和时间信息。
user_id
user_id 是终端用户的稳定标识。一个用户的长期偏好、历史事实和业务上下文都建议绑定到同一个 user_id。
常见形式：
- 你系统内部的用户 ID，如
user_123 - 邮箱或手机号的脱敏标识
- UUID
agent_id
agent_id 用于区分不同 Agent 或应用场景。例如同一个用户在客服 Agent、销售 Agent、教育 Agent 中可以拥有不同的记忆视角。
run_id
run_id 表示一次会话或一次任务运行。适合存放短期上下文，用于区分同一个用户在不同会话中的临时信息。
metadata
metadata 是记忆上的附加结构化字段。你可以用它保存来源、标签、项目、业务域等信息，后续通过 filters 做精确过滤。
{
"project": "crm",
"source": "support-ticket",
"tags": ["vip", "renewal"]
}写入与检索
- 写入：
POST /memories，把 messages 或 text 写入 Memaster。 - 检索：
POST /search，根据 query + user_id / agent_id / run_id 找到相关记忆。
配额
Memaster 按写入与检索次数计费：
memory_write：写入或更新记忆memory_search：检索记忆
你可以在 Dashboard 的「记忆看板」中查看使用趋势和详细日志。