Documentation
文档概览
World Machine 是一项面向 AI Agent 的云端记忆与世界状态服务。通过官方 world CLI 与 world-machine Agent Skill,只需几分钟即可让你的助手拥有可回溯的长期记忆。
它能解决什么问题
把聊天记录存成普通文本切片,只能回答「谁曾经说过某句话」。World Machine 在逐字留档原话的同时,还会自动维护随时间演进的结构化状态——因此你的 Agent 能直接回答几类关键问题:
| 你想让 Agent 回答什么 | World Machine 如何帮你做到 |
|---|---|
| 现在的情况是什么 | 自动更新当前有效的实体属性(如现居城市、当前项目、个人偏好),不用让模型从几十条旧消息里猜 |
| 某件事是从什么时候开始算的 | 每个属性都记录独立的生效起点,准确理解「昨天」「上个月」等相对时间表达 |
| 过去某一天是什么状态 | 通过 --as-of 指定历史日期,无损还原那一刻的世界切片 |
| 这条信息有多可信 | 区分「用户口述」「推断结论」「争议信息」与「已核验事实」,方便 Agent 决定谨慎程度 |
| 当时原话到底怎么说的 | 原始陈述一字不改永久留档,与结构化状态一起返回,随时可核对依据 |
写与读的流转
记下一句日常语言后,原话会立刻落盘可读,后台则自动抽取并更新相关实体的状态区间;召回时一次同时拿到两层信息:
选择阅读路线
根据你的使用场景,从下面四条路线中任选一条开始:
快速连通性验证
完成登录授权后,运行下面三条命令即可确认云端读写正常:
Shell
# 检查授权状态,并试写与召回一条记忆 world auth status world remember "我偏好使用深色模式,开发语言主要是 Go。" --source cli world recall "我偏好什么开发语言?"
正在为自有服务端编写集成代码?无需阅读 CLI 命令,直接前往 REST API 参考 获取完整的 cURL / TypeScript / Python 示例与端点契约。