列出事实

返回项目中的事实分页列表

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

返回项目中存储的事实分页列表。事实是从会话中自动提取的结构化知识片段。您可以使用 fact_fuzzy 按内容筛选事实。

所需权限： project:mem_list

路径参数

workspaceId · string · required

工作空间 ID

projectId · string · required

项目 ID

查询参数

page_size · integer · default: "50"

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

continuation_token · string

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

fact_fuzzy · string

按内容子串筛选事实

cURL

curl -X GET 'https://app.memorylake.cn/openapi/memorylake/api/v3/workspaces/ws_abc123def456/projects/proj_a1b2c3d4e5f6/memories/facts?page_size=20' \
  -H 'Authorization: Bearer sk_xxxxxx'

响应

data · object

Show 事实分页列表

items · array

事实对象数组

Show 事实对象

id · string

事实唯一标识符

fact · string

事实文本

metadata · object

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

expired · boolean

事实是否已被遗忘

score · number

相关性评分

expiration_date · string|null

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

created_at · string

创建时间戳

updated_at · string

最后更新时间戳

continuation_token · string|null

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

Success (200)

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "fact_8f3a1b2c4d5e",
        "fact": "User prefers dark mode in all applications",
        "metadata": {
          "category": "preferences",
          "confidence": "high"
        },
        "expired": false,
        "score": 0.95,
        "expiration_date": null,
        "created_at": "2025-06-10T14:30:00Z",
        "updated_at": "2025-06-10T14:30:00Z"
      },
      {
        "id": "fact_2d4e6f8a0b1c",
        "fact": "User is based in San Francisco timezone (PST/PDT)",
        "metadata": {
          "category": "location"
        },
        "expired": false,
        "score": 0.88,
        "expiration_date": "2026-06-10T14:30:00Z",
        "created_at": "2025-06-12T09:15:00Z",
        "updated_at": "2025-06-12T09:15:00Z"
      }
    ],
    "continuation_token": "eyJsYXN0X2lkIjoiZmFjdF8yZDRlNmY4YTBiMWMifQ"
  }
}