Skip to main content

Dream 数据结构

Dream 对象、输入输出和状态的复用结构。

Dream 对象

创建、查询、列表、取消和归档接口都会返回 Dream 对象。
字段类型说明
idstringDream ID,前缀为 drm_
typestring固定值 "dream"
statusstringDream 状态,见 Dream status
inputsarray输入列表,见 Dream input
outputsarray输出列表,见 Dream output
modelobject已保存的模型配置,见 Dream model
instructionsstring自定义整理指令,UTF-8 编码后最多 4096 字节
session_idstring 或 null关联的 Dreaming Session ID(运行后填充)
usageobjectToken 用量统计
errorobject 或 null失败时的错误详情
created_atstringUTC 创建时间(ISO 8601)
ended_atstring 或 nullUTC 结束时间(仅终态时有值)
archived_atstring 或 nullUTC 归档时间

Dream model

请求兼容字符串 ID,所有 Dream 响应中的 model 均为对象:
字段类型说明
idstring保存的模型 ID;默认路由为 auto
effortstring可选,仅在显式设置时返回。规范值为 none、low、medium、high、xhigh、max;none 不会被当成缺省值省略
context_windowinteger可选,仅在显式设置时返回,单位为 token
{"id":"dfmodel","effort":"none","context_window":400000}
未设置选项的历史 Dream 和仅传模型 ID 的新 Dream 返回例如 {"id":"auto"},不会凭空补入选项。创建、详情、列表、取消和归档保持相同配置回显。这里返回的是已保存的选择,不代表运行时最终路由的模型、实际上下文使用量或 token 用量;查询历史 Dream 不按当前模型目录重新校验。 请求校验、可用选项及 auto 规则见 创建 Dream。

Dream status

值说明
pending已创建,等待执行
running正在执行记忆整理
completed整理完成,outputs 中有结果
failed执行失败,error 中有原因
canceled被用户取消

Dream input

inputs 数组中的每个元素:
type 值必填字段说明
memory_storememory_store_id指定输入 Memory Store(必选,且仅允许一个)
sessionssession_ids指定重点回顾的 Session(可选,最多 100 个 ID)

Dream output

Dream 完成后,outputs 数组中的元素:
字段类型说明
typestring固定值 "memory_store"
memory_store_idstring整理后的输出 Memory Store ID
files_touchedarray被创建/修改/删除的 memory 文件路径列表

Dream usage

字段类型说明
input_tokensinteger输入 token 数
output_tokensinteger输出 token 数
cache_creation_input_tokensinteger缓存创建 token 数
cache_read_input_tokensinteger缓存读取 token 数

Dream error

失败时返回的错误对象:
字段类型说明
typestring错误类型(如 "no_output"、"internal_error")
messagestring错误描述