术语表
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 |
| Agent | kind: 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。 | 记忆 |
