KEEL · 龙骨 · A CURRICULUM FOR THE AI ERA
Harness 术语地图 — keel 龙骨
Agent Harness 的参考信息：Harness 术语地图
| 术语 | 先用一句话理解 | 工程边界 |
|---|---|---|
| Model | 根据输入生成下一段输出的概率系统 | 不拥有工具权限 |
| Tool | 对一个外部能力的明确封装 | 不自行决定调用者权限 |
| Agent | 为了目标进行多步行动的应用 | 不等于某个模型 |
| Workflow | 由程序预先规定主要步骤 | 分支主要由代码控制 |
| Agent loop | 根据每轮决定继续行动的循环 | 仍需外部停止条件 |
| Harness | 管理模型、工具、状态、策略和终止的运行时 | 不把模型建议直接当动作 |
| Decision | 模型提出的下一步建议 | 还没有获得执行权限 |
| Action | 通过协议和策略校验后的动作 | 才可以进入执行器 |
| Result | 动作的结构化结果或错误 | 不能只打印后丢弃 |
| Message | 发送给模型或从模型收到的协议消息 | 不等于完整运行状态 |
| Context | 本轮模型真正看到的材料 | 有 token 预算 |
| State | 运行当前处于什么阶段 | 服务恢复和并发控制 |
| Event | 某件事已经发生的不可变记录 | 适合观测、审计和回放 |
| Checkpoint | 某个状态版本的可恢复快照 | 不自动等于事件日志 |
| Adapter | 把供应商格式转换成内部协议 | 不应修改业务状态 |
| Policy | 根据身份、资源和风险决定允许与否 | 不能只写在 prompt 里 |
| Timeout | 一次调用最多等待多久 | 不等于整次运行 deadline |
| Deadline | 整次运行最晚结束时间 | 需要传递给子调用 |
| Cancellation | 用户或系统主动停止运行 | 仍要处理迟到结果 |
| Idempotency | 重复到达不会重复产生业务效果 | 需要业务记录支持 |
一条运行的最小时间线
run.started
-> model.requested
-> decision.parsed
-> tool.started
-> tool.succeeded / tool.failed
-> model.requested
-> run.completed / run.failed / run.cancelled
看到任何 Harness 代码时，先问它在这条时间线上写入了什么、改变了什么状态、允许哪些下一步。