附录 C：术语表
| 术语 | 本教程中的含义 |
|---|---|
| Agent Harness | 把模型、工具、状态、中间件和运行上下文组装成可用 Agent 的能力层 |
| Lead Agent | 面向用户主线程、可委派子任务的顶层 Agent |
| Custom Agent | 用户定义 SOUL、模型、工具组和 Skills 的 Agent 配置 |
| Thread | 长期对话与工作区的逻辑容器 |
| Run | Thread 上的一次 Agent 执行尝试 |
| Checkpoint | LangGraph 在某一步保存的精确 ThreadState |
| Super-step | 图中一组可并行节点共同读取旧状态、写入 reducer 的执行批次 |
| Reducer | 同一状态字段多次写入时的合并规则 |
| StreamBridge | 将后台 run 产生的事件发布给当前或重连 SSE 消费者的桥 |
| Run Event | 带序号的耐久事件，用于历史、重放、子任务步骤或审计 |
values | LangGraph 流中的完整状态快照 |
messages-tuple | 消息/token 级增量流 |
| Gap | 客户端请求的 SSE 游标早于服务端保留窗口，需要重载 durable state |
| Sandbox | 文件与命令能力的统一接口；实现可能是本地映射或真正隔离环境 |
| Artifact | Agent 通过 present_file 明确交付给用户的文件 |
| Workspace changes | 一次 run 前后工作区实际差异，与 Artifact 选择不同 |
| Delegation ledger | 摘要后仍保留的有界子代理任务账本 |
| Summary | 旧活跃消息的有损语义压缩，用于控制模型上下文 |
| Memory | 跨线程、用户/Agent 级的长期信息存储 |
| Skill | 按需加载的操作说明与工具策略包 |
| MCP | 外部工具 server 与 client 的标准连接协议 |
| Deferred tool | 已注册但暂不向模型暴露 schema、需搜索/路由晋升的工具 |
| Principal | 运行时授权使用的可信身份、角色与属性集合 |
| Finalizing | Agent graph 结束后、run 完成前的持久化和收尾阶段 |
| Lease | 多 worker 下某个 worker 对 run 的有期限所有权 |
最容易混淆的三组概念
Thread / Run / Checkpoint
Thread 是容器，Run 是一次尝试，Checkpoint 是尝试过程中保存的状态点。一个 Thread 有多个 Run，一个 Run 有多个 Checkpoint。
Tool / Skill / MCP
Tool 是可执行接口，Skill 是使用说明与策略，MCP 是一类工具的连接来源。三者不是同一抽象层。
Sandbox / Workspace / Artifact
Sandbox 是执行接口与隔离实现，Workspace 是线程文件区域，Artifact 是从 Workspace 中明确交付的文件。