切换深色模式
术语速查与常见误解
本页按课程中的职责解释术语。具体协议字段以正文明确引用的版本为准；下表不是所有框架通用的接口定义。
| 术语 | 一句话解释 | 研究助手中的例子 | 容易混淆 |
|---|---|---|---|
| Model / 模型 | 根据输入生成输出的组件 | 提议再搜索一次 | 整个 Agent 服务 |
| Runtime / 运行时 | 实际调度、执行和控制边界的程序 | 拒绝私有读取 | 模型的自我约束 |
| Agent loop | 依据观察反复选择行动的循环 | 新证据引出新查询 | 固定三步脚本 |
| Workflow | 程序预设主要执行结构 | 检索后固定生成 | 一定不含模型 |
| Tool call | 对工具的候选请求 | read_note 的名字和参数 | 已经执行成功 |
| Observation | 环境返回的真实结果 | 文档不存在 | 原来的计划 |
| State | 系统保存的任务进展 | 已读版本、待解决问题 | 本轮全部模型输入 |
| Context | 本轮实际送给模型的信息 | 精选证据、近期观察 | 永久记忆 |
| Memory | 可跨轮或跨任务复用的信息 | 用户明确保存的偏好 | 向量数据库本身 |
| RAG | 检索外部资料后辅助生成 | 找笔记支持回答 | 自动保证真实性 |
| Chunk | 具有来源位置的资料片段 | Markdown 一个小节 | 不带前提的句子 |
| Recall@k | 前 k 个结果覆盖标注相关项的比例 | L3 的 0.5 与 1 | 生成答案准确率 |
| Rerank | 对候选结果再次排序 | 将条件更匹配的片段前移 | 对事实真假的认证 |
| Grounding | 将输出的判断落实到证据 | 结论映射原文位置 | 只附一个网址 |
| MCP | 应用连接工具等能力的协议 | 工具发现与调用 | 规划算法和授权万能层 |
| Skill | 某类任务的操作规程与资源 | 研究报告写作规程 | 自动获得操作权限 |
| Handoff | 转移任务处理责任或控制权 | 分诊后交给专门助手 | 普通函数返回值 |
| Checkpoint | 可供恢复的执行状态快照 | 保存已完成读取 | 外部副作用恰好一次 |
| Idempotency / 幂等 | 相同业务意图重试不重复产生效果 | 同一操作 ID 只发布一次 | 任何重复请求都丢弃 |
| Trial | 一次从规定初始条件开始的尝试 | 同题第 3 次运行 | 一个新的独立问题 |
| Grader | 对某个质量维度作判定的规则或评审者 | 来源检查、人工支持标签 | 生成模型自称正确 |
| Trace | 可观察的执行轨迹 | 参数、结果、耗时和状态 | 必须获取内部思维链 |
| Prompt injection | 不可信内容试图改变任务或行为 | 笔记要求上传文件 | 仅仅出现危险关键词 |
先问哪个问题，决定先看哪一层
回答不对时，先确认执行器是否真的读到所引用资料。没有读到，查工具与证据记录；读到了但材料本身不足，查检索与数据；材料充分但结论过度，查生成与语义验收。这样一次只改最有证据的问题层。
动作被拒绝时，先看参数是否合法，再看工具是否允许、资源是否授权、版本是否一致。不要把权限拒绝当临时网络故障无限重试。协议连接正常也不意味着业务调用成功。
耗时变长时，先分解决策、检索、读取、重试与排队时间，再检查重复工作。并行可能缩短墙钟时间，却不会自动减少总工作量。没有逐调用记录时，先补记录再比较架构。
几个经常卡住的学习问题
必须先学某个框架吗？ 不必。本课程先用最少代码暴露控制责任，再映射到框架。后续使用框架时仍需核对恢复、消息与工具的实际语义。
为什么例子不用向量数据库？ 基础实验要先验证执行边界。常量数组既不能代表真实检索，也不应掩盖后续需要测召回、切分和版本更新的工作。
为什么拒绝也能通过测试？ 测试检查的是约定行为。越权请求被拒绝是正确结果；正常请求被错误拒绝则是不合格。看任务契约，不只看状态名。
读完能否直接拿去上线？ 先按结课验收证明自己实现的范围。离线脚本没有真实认证、网络容错和模型评估；上线能力必须补实现和对应验证。