跳到主要内容
开发者文档
文档目录

术语表

Markdown 版

文档中反复出现的术语,每个用一句话定义,并链接到讲解它的页面。

术语定义详见
Space权限和路径的边界,成员、角色和文件树都按 Space 划分,每个账户有一个默认 Space。核心概念
Entry一份来源的稳定身份,可以是文件、网址或一段文本。核心概念
版本Entry 内容的一次不可变记录,内容每变化一次产生一个新版本。核心概念
知识状态Entry 的处理进度,报告在 knowledge.state 上。核心概念
记忆一条有范围、状态和来源的陈述,可以是账户记忆、以 Entry 写入的记忆,或从 Entry 提炼的事实。记忆
记忆范围记忆归属的对象:project 属于一个 Space,agent 属于一个 Agent,account 属于账户。记忆
记忆状态记忆在审核中的位置:candidate、confirmed、rejected 或 superseded。记忆
主体请求以其身份执行的人(kind: human)或 Agent(kind: agent),API Key 属于主体但本身不是主体。权限
能力对一类操作的许可,例如 knowledge:read 或 knowledge:write。权限
API Key每个请求以 Authorization: Bearer mb_live_... 发送的凭据,只能收窄其主体的权限。认证与 API Key
Agentkind: agent 的主体,有自己的权限、记忆和审计身份。权限
上下文包context 为一个任务返回的结果:服务挑选来源,在 token 预算内打包,并在 route 中说明取舍。检索与上下文
引用上下文包中一条来源的 [cN] 编号,回答用它标注出处。检索与上下文
分支叠在 Space 主线上的写时复制层,用作 Agent 的工作区,合并后才在主线产生版本。分支与挂载
检查点分支自身改动在某一时刻的记录,分支可以回滚到这个检查点。分支与挂载
快照某一时刻 Space 里每个文件的路径和版本的记录,不复制任何字节。同步、快照与导出
提案Agent 对他人文件提交的待审核写入,审核人批准后才写成新版本。文件与版本
任务单次请求内无法完成的工作,返回 202 和 job_id,可轮询任务直至进入终态。API 约定
读取根路径Space 所有者为成员设定的 read_root,成员只能读取这个目录及其下的内容,其外的路径返回 404。权限
写入根路径Space 所有者为成员设定的 write_root,成员只能在这个目录下写入。权限
幂等键写请求上的 Idempotency-Key 请求头,带相同的键重发不会再执行一遍。API 约定
游标列表或变更流返回的不透明字符串,用于读取下一页或继续读取。API 约定
ETag文件最新版本的 id,用于条件写入和条件读取。API 约定
离线整理部署可选的功能,在没有 Agent 工作时整理已有的记忆、不生成新内容,API 把一次运行称为 dream。记忆

下一步

  • 文件与版本:从写入一个文件开始。
  • 权限:主体、能力、角色和根路径如何共同决定一次请求。
  • API 参考:每个接口的参数和响应。