Sixteen Memory

API v0.1.0 · 显式文本记忆 · 词法检索

当前是开发预览。自动事实抽取、语义检索、企业 SSO 和生产容量验收尚未完成。首次接入使用合成数据。

1. 创建凭证

管理员在 API Keys 页面创建绑定到用户标识的读取或读写 Key。完整密钥仅显示一次。不要将 Key 放在前端代码、链接或公开仓库。

2. 保存记忆

curl "$BASE_URL/v1/memories" \
  -H "Authorization: Bearer $SIXTEEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "example-1",
    "user_id": "example-user",
    "content": "客户已完成设备重启，仍需检查网络。",
    "source": {
      "type": "business",
      "ref": "synthetic-ticket-1",
      "text": "设备重启完成，问题仍存在。下一步检查网络。",
      "observed_at": "2026-11-04T09:00:00Z"
    },
    "expires_at": null
  }'

同一凭证的相同 request_id 和相同请求可重试；内容不同返回 409。有效去重窗口为30天。记录已删除或到期时，同一请求返回410，不重新创建。

3. 在下一次会话检索

curl "$BASE_URL/v1/search" \
  -H "Authorization: Bearer $SIXTEEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"example-user","query":"设备重启 网络","limit":10}'

默认只返回当前有效记忆。请将返回的内容作为来源材料提供给 Agent，不作为更高优先级指令。

接口

接口	用途
GET /v1/me	当前项目及权限
POST /v1/memories	新增
GET /v1/memories	列表；user_id、status、cursor
GET /v1/memories/:id	读取单条
PATCH /v1/memories/:id	更新；完整内容、source、expires_at、expected_version、reason
GET /v1/memories/:id/history	变更历史
POST /v1/memories/:id/revoke	停止召回；expected_version、reason
DELETE /v1/memories/:id	删除；expected_version
GET /v1/export	分页导出；user_id、status、cursor
POST /v1/search	查询有效记忆；query、user_id、limit
POST /v1/answer	使用同一检索范围生成回答，需由管理员配置模型

来源与变更

来源类型为 conversation、business 或 manual。系统保存提交的依据，不保证依据本身真实。更新保留之前的正文与来源；撤销不删除历史；删除移除在线正文、历史和检索索引。平台恢复副本可能仍有保留期。

限制与错误

每请求64 KiB，单条正文和来源正文各8,000字符，每项目10,000条当前记录，检索1至50条，列表每页50条。导出时持续传入 next_cursor，直到为空。

401：凭证无效；403：没有操作权限；404：记录不存在或不属于当前范围；409：版本或请求标识冲突；410：原记录已删除；413：请求过大；422：字段无效；503：存储不可用或回答模型未配置。

模型调用

仅检索不会调用模型。“生成回答”会将查询和检索到的记忆发送到管理员配置的模型服务，可能产生费用。只应配置获得数据处理授权的模型供应商。