World Machine

Documentation

文档概览

World Machine 是一项面向 AI Agent 的云端记忆与世界状态服务。通过官方 world CLI 与 world-machine Agent Skill,只需几分钟即可让你的助手拥有可回溯的长期记忆。

首选方式:world CLI & Agent Skill控制台:console.worldmachine.dev底层协议:REST / JSON(按需直连)
本页目录(4 节)

它能解决什么问题

把聊天记录存成普通文本切片,只能回答「谁曾经说过某句话」。World Machine 在逐字留档原话的同时,还会自动维护随时间演进的结构化状态——因此你的 Agent 能直接回答几类关键问题:

你想让 Agent 回答什么World Machine 如何帮你做到
现在的情况是什么自动更新当前有效的实体属性(如现居城市、当前项目、个人偏好),不用让模型从几十条旧消息里猜
某件事是从什么时候开始算的每个属性都记录独立的生效起点,准确理解「昨天」「上个月」等相对时间表达
过去某一天是什么状态通过 --as-of 指定历史日期,无损还原那一刻的世界切片
这条信息有多可信区分「用户口述」「推断结论」「争议信息」与「已核验事实」,方便 Agent 决定谨慎程度
当时原话到底怎么说的原始陈述一字不改永久留档,与结构化状态一起返回,随时可核对依据

写与读的流转

记下一句日常语言后,原话会立刻落盘可读,后台则自动抽取并更新相关实体的状态区间;召回时一次同时拿到两层信息:

记下一句话如何同时沉淀为原文记忆与可回溯的结构化状态 左侧是 world remember 写入与 world recall 召回。写入后原文即时落盘为 Memories,后台异步结构化为 Entities,召回一次同时返回两层结果。 记下变化 world remember "我上个月搬到上海, 现在在 Acme 当架构师。" 后台结构化 识别实体与生效时间 原文留档 即时落盘 · 永不改写 按需召回 world recall "我现在在哪工作?" 可加 --as-of 回看历史 Entities · 结构化状态 self · Person Employment → Acme (架构师) Location → 上海 (home) 每个属性带生效时间与可信度等级 Acme · Organization Memories · 原始陈述 "我上个月搬到上海,现在在 Acme…" occurredAt: 2026-11-18 12:00 逐字保留,按相关性与时效排序
写进去一句话,读回来两层。原文写入即落盘并立即可查;结构化实体与属性区间由后台异步沉淀,随时支持按历史日期回看。

选择阅读路线

根据你的使用场景,从下面四条路线中任选一条开始:

快速连通性验证

完成登录授权后,运行下面三条命令即可确认云端读写正常:

Shell
# 检查授权状态,并试写与召回一条记忆
world auth status
world remember "我偏好使用深色模式,开发语言主要是 Go。" --source cli
world recall "我偏好什么开发语言?"
正在为自有服务端编写集成代码?无需阅读 CLI 命令,直接前往 REST API 参考 获取完整的 cURL / TypeScript / Python 示例与端点契约。