Skip to main content
本指南将引导您完成 MemoryLake 的核心 API 工作流。完成后,您将创建好一个工作空间、提交一段会话并搜索提取的记忆。

前提条件

  • 拥有 MemoryLake 账户和 API 密钥(参见认证
  • 已安装 curl(或任意 HTTP 客户端)
所有示例使用基础 URL https://app.memorylake.cn/openapi/memorylake。请在每个请求中将 YOUR_API_KEY 替换为您的实际 API 密钥。

端到端演练

1

获取 API 密钥

登录 MemoryLake 控制台,在账户设置中生成 API 密钥。您将在所有 API 调用的 Authorization 请求头中使用此密钥。
2

创建工作空间

工作空间是所有数据的顶层容器。创建一个工作空间即可开始。
Response
保存工作空间的 id——后续步骤中会用到。
3

创建 Actor

Actor 代表会话中的参与者。为需要追踪记忆的人类用户创建一个 Actor。
Response
将 Actor 绑定到工作空间,以便 MemoryLake 在该工作空间的所有项目中将事实与此 Actor 关联。详见绑定 Actor
4

创建项目

项目是工作空间中的知识容器,用于存放文档、会话及从中提取的事实。
Response
5

创建会话并追加消息

向工作空间提交一段会话。首先创建会话,然后逐条添加消息。MemoryLake 会自动从消息中提取结构化事实。创建会话:
Response
追加第一条消息(用户):
追加第二条消息(助手):
提交消息后,MemoryLake 会异步处理。事实通常在几秒钟内即可使用。
6

搜索记忆

在工作空间中搜索 MemoryLake 从会话中提取的事实。
Response
MemoryLake 自动从会话中提取了结构化事实,并将其关联到 Jane 的 Actor。这些事实会持久保存,并可在整个工作空间内搜索。

完整 Python 示例

以下是将完整流程整合在一个 Python 脚本中的示例:
quickstart.py

完成内容

仅需几分钟,您已经:
  1. 创建了一个工作空间来隔离数据
  2. 创建了一个Actor来代表人类用户
  3. 创建了一个项目来存放知识
  4. 提交了一段带有消息的会话
  5. 搜索并检索了自动提取的事实
MemoryLake 完成了最困难的部分——解析会话、识别事实、将事实关联到正确的 Actor,并为所有内容建立搜索索引。

下一步

工作空间与项目

了解何时使用多个工作空间与多个项目

Actor 与记忆

了解跨项目的每用户记忆如何工作

记忆管道

深入了解会话如何转化为结构化事实

API 参考

探索工作空间、Actor、项目和搜索的完整 API