BUILD / DOCUMENTATION

第一次接入,从一条记忆开始。

取得测试 Key,保存合成数据,检索,再查看来源和历史。这里的示例对应线上 v0.1.0 核心 API。

三个接入步骤。

Key 仅放在应用服务端或本机环境变量中,不嵌入网页、代码仓库或公开截图。

01 / 获取测试 Key

由管理员提供绑定用户范围的凭证。当前没有自助注册入口,可通过公开邮箱讨论接入。

02 / 写入与检索

使用下面的 JavaScript 或 REST 示例,仅替换用户范围和环境变量。先使用合成数据。

03 / 查看与管理

在控制台检查来源、当前版本和历史。需要删除时提供当前版本号。

import { SixteenMemory } from "./sixteen-memory-sdk.mjs";

const memory = new SixteenMemory({
  baseUrl: "https://console.sixteenmemory.com",
  apiKey: process.env.SIXTEEN_API_KEY
});

await memory.add({
  request_id: "synthetic-ticket-884",
  user_id: "customer-42",
  content: "Replacement shipped; refund still open.",
  source: {
    type: "business",
    ref: "synthetic-ticket-884",
    text: "Replacement shipped; refund still open.",
    observed_at: "2026-11-05T09:00:00Z"
  },
  expires_at: null
});

const results = await memory.search({
  user_id: "customer-42",
  query: "refund open",
  limit: 10
});

POST/v1/memories

新增

POST/v1/search

检索

GET/v1/memories

列表

GET/v1/memories/:id

读取

PATCH/v1/memories/:id

更新

GET/v1/memories/:id/history

历史

POST/v1/memories/:id/revoke

停用

DELETE/v1/memories/:id

删除

GET/v1/export

导出

一次写入,需要哪些字段?

保持请求 ID 稳定可避免相同请求重复保存。相同 ID 改了内容会返回冲突,不应无限重试。

字段含义
user_idKey 允许访问的用户标识
request_id新增请求的唯一标识;同请求重试保持不变
content要保存的记忆正文,最多 8,000 字符
sourcetype、ref、text、observed_at:来源类型、标识、正文和时间
expires_at可选到期时间;不设置时为 null
expected_version更新、停用或删除时提供当前版本

先理解错误,再决定下一步。

客户端保留 HTTP 状态和 error.code。不要把权限失败、版本冲突或缺少模型配置当成网络重试问题。

401

检查凭证是否缺失、无效或已退出。

403 / 404

确认角色与用户范围;不要尝试绕过权限。

409

重新读取当前版本,或检查请求 ID 是否用于不同内容。

422

按字段说明检查内容、来源、标识和日期格式。

429

按 Retry-After 等待,降低请求频率。

503

服务或模型配置暂不可用,先检查配置和服务状态。