写入一条记忆
/v1/memories
一句话加可选的来源、时间与时区。返回 eventId,支持 Idempotency-Key 安全重试。
把自然语言记忆写成实体与组件,每个属性带自己的生效时间。四个 HTTP 接口:写入、读实体、召回、擦除。
写入 / 读实体 / 召回 / 擦除
返回 eventId 即可召回
每个组件各自生效
一份凭证只看到一个主体空间
Agent 出错往往不是读得不够多,而是拿到的是一堆互相矛盾的历史片段,也不知道哪条还算数。
asOfValidTimeMs 取任意历史时刻的状态。stated_claim 等状态,应用层据此决定要不要二次确认。左侧切换场景,右侧逐步发生。演示用真实接口的字段,数据是示意。
切换场景会重放整条链路
没有「列出全部实体」,也没有批量写入。少一点接口,语义就少一点歧义。
/v1/memories
一句话加可选的来源、时间与时区。返回 eventId,支持 Idempotency-Key 安全重试。
/v1/entities/{entityId}
已知 ID 时直取,拿到全部组件与各自的生效时间。可加 asOfValidTimeMs 回到过去。
/v1/memories:recall
不确定 ID 时的入口。一次返回实体与原文,条数受 maxEntities / maxEvents 约束。
/v1/users/me/data
没有「删谁」这个参数。主体从凭证推出,擦除后进入抑制状态,重放也写不回来。
服务地址是 https://api.worldmachine.dev。凭证需要向接入方申请,拿到后先发这一条确认链路通。
# 把 $WM_TOKEN 换成发给你的凭证 curl -sS -X POST "https://api.worldmachine.dev/v1/memories" \ -H "Authorization: Bearer $WM_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"text":"我上个月搬到上海,现在在 Acme 当架构师。","timezone":"Asia/Shanghai"}' # {"eventId":"0136159b-eb97-54b5-a05d-e37619881c70"}
maxEntities 传 0 或超过 100 会被替换成 20