跳到主要内容

Events API

POST /v1/users/:user_id/streams/:stream_id/events​

把原始事件写入 L0 事件流。

这个路由用来做什么​

当你需要把源材料追加进 Memorose，在它们变成长期记忆前先落到事件层时，就用这个接口。

典型用途：

  • 对话轮次
  • 工具输出
  • 结构化 JSON 负载
  • 图片、音频或视频引用
  • 与任务执行相关的事件

请求​

POST /v1/users/dylan/streams/11111111-1111-1111-1111-111111111111/events
Authorization: Bearer <token>
Content-Type: application/json

{
  "org_id": "default",
  "content": "Dylan prefers dark terminals and concise updates.",
  "content_type": "text",
  "level": 1,
  "parent_id": "22222222-2222-2222-2222-222222222222",
  "task_status": "InProgress",
  "task_progress": 0.6
}

请求字段​

字段类型必填说明
contentstring是事件内容
content_typestring否text、image、audio、video、json
org_idstring否组织作用域
levelnumber否目标层级提示，写入 metadata
parent_idstring否父对象引用，写入 metadata
task_statusstring否任务状态提示，写入 metadata
task_progressnumber否任务进度提示，写入 metadata

返回​

{
  "status": "accepted",
  "event_id": "9db1d859-0a32-4c33-8b94-8cab9f8e0d16"
}

实践说明​

  • stream_id 是路径中的 UUID。
  • 当 content_type 为 json 时，content 必须是 JSON 字符串。
  • 这个路由写入的是 L0；真正的 L1 / L2 记忆会在整合和反思后出现。
  • 写请求会发往当前 leader；非 leader 节点会在可能时做转发。

相关页面​