列出工作空间事实

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456,proj_ghi789' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&actor_ids=act-a1b2c3d4e5f6' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact-2fe07aee0058d141c744685a2d7272be",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact-044bdc2ffcf8c7915aa9e79d5a10efd4",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362"
        },
        "expiration_date": null,
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": null
  }
}

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456,proj_ghi789' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&actor_ids=act-a1b2c3d4e5f6' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact-2fe07aee0058d141c744685a2d7272be",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact-044bdc2ffcf8c7915aa9e79d5a10efd4",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362"
        },
        "expiration_date": null,
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": null
  }
}

array of strings

要返回其事实的 Agent ID，以逗号分隔。

GET /openapi/memorylake/api/v3/workspaces/{workspaceId}/memories/facts

按时间倒序返回工作空间中指定项目和/或 Actor 范围内的事实。每条事实都会标注其所属的项目或 Actor，因此您可以在整个工作空间范围内查询知识，无需分别调用每个项目或 Actor 的端点。 project_ids 或 actor_ids 至少需要提供一项，且两者合计最多只能引用 50 个不同的项目/Actor。

所需权限： 按您指名的 id 种类分别要求——project_ids 里的每个项目需要 project:mem_read，actor_ids 里的每个 Actor 需要 workspace_actor:fact_read，agent_ids 里的每个 Agent 需要 workspace_agent:fact_read。只要指名了您无权读取的对象，整个请求会被拒绝，而不是把列表过滤成您能看到的部分。

路径参数

string

required

工作空间 ID

查询参数

array of strings

要包含的项目 ID；以逗号分隔（例如 proj-a,proj-b）

array of strings

要包含的 Actor ID；以逗号分隔（例如 actor-a,actor-b）

string

按内容子串筛选事实

integer

default:"50"

每页返回的事实数量。范围：1–200。

string

上一次响应返回的令牌，用于获取下一页结果

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456,proj_ghi789' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&actor_ids=act-a1b2c3d4e5f6' \
  -H 'Authorization: Bearer sk_xxxxxx'

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws-8001856949ad4f6a5b6226f415ffa877/memories/facts?project_ids=proj_def456&fact_fuzzy=deadline' \
  -H 'Authorization: Bearer sk_xxxxxx'

响应

object

Show 事实分页列表

array

事实对象数组

Show 事实对象

string

事实唯一标识符

string

事实文本

object

附加到事实的任意键值元数据

boolean

事实是否已被遗忘

object

该事实所属的项目、Actor 或 Agent

Show 归属对象

string

归属类型：project、actor 或 agent

string

归属 ID：当 type 为 project 时为项目 ID，为 actor 时为 Actor ID，为 agent 时为 Agent ID

string|null

计划的过期日期，如果事实不会过期则为 null

string

创建时间戳

string

最后更新时间戳

string|null

用于获取下一页的令牌。当没有更多结果时为 null。

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact-2fe07aee0058d141c744685a2d7272be",
        "fact": "Project deadline was moved to June 2025",
        "metadata": {
          "category": "planning"
        },
        "expired": false,
        "owner": {
          "type": "project",
          "id": "proj-b93e8d95a8705bcc4ec42a65ba4cc7f8"
        },
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact-044bdc2ffcf8c7915aa9e79d5a10efd4",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences"
        },
        "expired": false,
        "owner": {
          "type": "actor",
          "id": "actor-8d093c0578ffeb19f8fa10ea28ee9362"
        },
        "expiration_date": null,
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": null
  }
}

MemoryLake API

Memory Router API

路径参数

查询参数

响应

​路径参数

​查询参数

​响应

路径参数

查询参数

响应