SDK 接入
概览

SDK 接入

Memaster SDK 封装了记忆写入、语义检索、API Key 鉴权和默认云端 API 地址。你可以在服务端、Agent Runtime、自动化任务或后端业务系统中直接调用。

默认 API Endpoint 是 https://api.memaster.cn (opens in a new tab)。你只需要在 Dashboard 创建 API Key,并在运行环境中配置 MEMASTER_API_KEY

通用接入流程

  1. 打开 Dashboard 注册或登录。
  2. API Keys 页面创建密钥。
  3. 在服务端环境变量中配置 MEMASTER_API_KEY
  4. 调用 SDK 写入和检索记忆。

数据隔离建议

  • 使用 user_id 绑定终端用户记忆。
  • 使用 agent_id 区分不同 Agent 或应用。
  • 使用 run_id 标识一次会话或任务。
  • 使用 metadata 保存项目、标签、来源等过滤字段。