编程语言Agent Runtime教程MCP
《Agent Runtime 工程化》第六章 MCP 与 Provider 抽象：6.7 验收标准
Agent 可以动态接入和移除工具；工具 schema 改变不会把 Agent 弄崩；MCP 工具仍然经过本地权限审批；模型供应商替换不影响 runtime 主循环。完成这一章，你的 miniagent 已经具备生态接入能力。
站点编辑发布于 2026/8/13更新于 2026/10/146 浏览0 点赞约 6 分钟阅读
标签：教程
编程语言Agent Runtime教程安全
《Agent Runtime 工程化》第七章 权限与安全边界：7.7 动手任务
实现 Tool Permission Matrix： 对文件路径做 workspace whitelist； 对 shell 命令做风险分类； 对 destructive 操作默认拒绝； 对 write/network/install 操作生成 preview 并请求确认； 所有审批写入 audit
站点编辑发布于 2026/8/13更新于 2026/10/143 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程
《Agent Runtime 工程化》第五章 上下文工程：5.5 工具结果降级
工具结果进入上下文前，应先问： 这是事实结果，还是日志噪声？ 后续步骤是否需要逐字引用？ 是否有结构化字段可提取？ 是否超过预算？ 是否包含 secret 或隐私数据？ 例如测试失败日志，模型通常需要失败用例、断言信息、文件路径、行号、错误堆栈顶部，而不是全部构建输出。搜索结果通常需要文件路径和匹配
站点编辑发布于 2026/8/13更新于 2026/10/145 浏览0 点赞约 6 分钟阅读
编程语言Agent Runtime教程
《Agent Runtime 工程化》第十二章 二开毕业项目：12.2 方向 B：Context Budget Allocator
目标：给 Agent 增加上下文预算分配器。 功能范围： 对历史消息、文件片段、工具结果、repo map 分配 token； 超限时按优先级降级； 生成 context debug report； 在 UI 或日志中解释'为什么包含/丢弃某项'。 适合证明： 上下文工程； token 成本治理；
站点编辑发布于 2026/8/13更新于 2026/10/142 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程可观测性
《Agent Runtime 工程化》第九章 可观测与 Trace：9.5 本地 trace JSON
入门阶段可先用本地 JSONL： 每个 run 写入： 后续再接 OpenTelemetry、LangSmith 或自建 UI。先把语义记对，再追求漂亮 dashboard。
站点编辑发布于 2026/8/13更新于 2026/10/157 浏览0 点赞约 6 分钟阅读
编程语言Agent Runtime教程可观测性
《Agent Runtime 工程化》第十章 Eval Harness 与 CI 回归：导读
说 Agent '变好了'很容易。证明它变好了，要靠 eval。 Agent 产品很容易陷入'今天试了几个问题，感觉不错'的幻觉。工程系统不能靠感觉上线。Eval Harness 要把真实任务变成可重复的测试，把 trace 变成回归样本，把 prompt、工具和 runtime 策略的变化变成可比
站点编辑发布于 2026/8/13更新于 2026/10/144 浏览0 点赞约 6 分钟阅读
编程语言Agent Runtime教程
《Agent Runtime 工程化》第一章 Agent Runtime 全景：1.4 step、turn、run、trace、session、checkpoint
本书统一使用以下术语。 turn 是一次用户与系统的交互轮次。用户提出一个任务，是一个 turn 的开始。 step 是 runtime 在一个 turn 内的一次模型决策或工具执行推进。一次 turn 可以有很多 step。 run 是一次完整执行，从收到用户请求到最终回答、失败或取消。长任务中，
站点编辑发布于 2026/8/13更新于 2026/10/141 浏览0 点赞约 8 分钟阅读
编程语言Agent Runtime教程可靠性
《Agent Runtime 工程化》第八章 Checkpoint、Resume、Rollback：8.3 git-based checkpoint
第八章 Checkpoint、Resume、Rollback：8.3 gitbased checkpoint 另一种做法是借助 git。每个 step 或关键写入点创建临时 commit、stash、worktree 或 patch 文件。 gitbased 的优点是成熟、可审计、适合代码项目。缺点
站点编辑发布于 2026/8/13更新于 2026/10/142 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程
《Agent Runtime 工程化》第四章 工具系统设计：4.1 Tool Registry 的真正职责
Tool Registry 不是一个 Map<string, Function。它至少保存以下信息： 这些字段不是装饰。description 会影响模型是否选择工具；inputSchema 负责校验；riskLevel 进入权限审批；timeoutMs 进入执行器；outputPolicy 进入上
站点编辑发布于 2026/8/13更新于 2026/10/146 浏览0 点赞约 9 分钟阅读
编程语言Agent Runtime教程
《Agent Runtime 工程化》第十一章 源码研读方法：11.6 读上下文构建
上下文构建往往是 coding agent 的核心竞争力。读时关注： system/developer 指令； 用户消息和历史保留； 文件读取策略； repo map； 最近修改； terminal output； diagnostics； selection/range； embedding 或检
站点编辑发布于 2026/8/13更新于 2026/10/149 浏览0 点赞约 6 分钟阅读
编程语言Agent Runtime教程可靠性
《Agent Runtime 工程化》第八章 Checkpoint、Resume、Rollback：8.6 rollback 不是 undo 按钮
用户说'回滚'时，可能有三种意思： 回滚文件到某个 checkpoint； 回滚对话状态，让 Agent 忘记某段计划； 回滚外部副作用，例如撤销 API 操作。 Runtime 必须区分这三件事。文件 patch 可以回滚，对话状态可以恢复，外部副作用通常只能补偿，不能直接撤销。比如创建了 Git
站点编辑发布于 2026/8/13更新于 2026/10/151 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程MCP
《Agent Runtime 工程化》第六章 MCP 与 Provider 抽象：6.5 降级、限流与重试
模型调用失败时，runtime 可以重试；但要分清失败类型。 网络抖动可以重试；限流需要退避；上下文超限需要重新构建上下文；模型不支持某个 schema 特性，需要 schema 降级；工具调用格式不合法，可以让模型重试一次；安全策略拒绝，不应换模型绕过。 一个清晰的模型错误分类： 类型 处理 RA
站点编辑发布于 2026/8/13更新于 2026/10/143 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程
《Agent Runtime 工程化》第十二章 二开毕业项目：12.7 最终验收标准
完成本书和毕业项目后，你应能做到： 从零实现一个 TypeScript Agent Runtime； 讲清楚 tool call loop 的完整生命周期； 设计工具 schema、权限模型和审批流； 解决 context 超限与历史压缩； 实现 checkpoint、resume、rollback
站点编辑发布于 2026/8/13更新于 2026/10/146 浏览0 点赞约 6 分钟阅读
编程语言Agent Runtime教程TypeScript
《Agent Runtime 工程化》第二章 TypeScript / Node Runtime 基础：2.3 AbortSignal：取消要能传到底
一个成熟 runtime 必须支持取消。取消不是'UI 不显示了'，而是从用户操作一路传播到模型请求、工具执行、子进程和资源清理。 这段代码只是开始。上线后的 runtime 需要把 AbortSignal 传给 HTTP client、模型 SDK、工具 executor、子进程管理器。任何一层吞
站点编辑发布于 2026/8/13更新于 2026/10/150 浏览0 点赞约 9 分钟阅读
编程语言Agent Runtime教程安全
《Agent Runtime 工程化》第七章 权限与安全边界：导读
能力越大，边界越要清楚。本章谈权限和安全。 Agent 的能力来自工具，风险也来自工具。一个不会调用工具的模型，最多说错话；一个能执行命令、写文件、联网、访问数据库的 Agent，可能造成真实损失。Runtime 的安全目标不是把 Agent 绑住，而是让它在明确边界内做事；越过边界时，停下来请人确
站点编辑发布于 2026/8/13更新于 2026/10/143 浏览0 点赞约 6 分钟阅读
编程语言Agent Runtime教程可靠性
《Agent Runtime 工程化》第八章 Checkpoint、Resume、Rollback：8.4 crash recovery
恢复流程要保守： 1. 找到最新完整 checkpoint； 2. 校验 workspace 状态； 3. 恢复 message history 和 run state； 4. 检查最后一个 tool call 是否已完成； 5. 对不可重复工具禁止自动重放； 6. 给模型注入恢复说明； 7. 从下
站点编辑发布于 2026/8/13更新于 2026/10/148 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程MCP
《Agent Runtime 工程化》第六章 MCP 与 Provider 抽象：导读
Agent 迟早要接外部工具。本章讨论怎么接，以及怎么避免被某个供应商或协议绑死。 Agent Runtime 不能永远只使用本地写死的工具。它需要连接数据库、浏览器、设计工具、代码托管平台、内部系统、文档库和企业权限系统。MCP 的出现，正是为了解决 LLM 应用与外部数据、工具之间缺少统一连接方
站点编辑发布于 2026/8/13更新于 2026/10/153 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程MCP
《Agent Runtime 工程化》第六章 MCP 与 Provider 抽象：6.2 tools/list 与 tools/call
MCP Tools 规范里，Client 通过 tools/list 发现可用工具，通过 tools/call 调用工具。工具包含名称、描述和输入 schema。Server 声明 tools capability 后，必须响应 tools/list；工具列表可以为空，也可以随时间变化。 对 run
站点编辑发布于 2026/8/13更新于 2026/10/149 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程可观测性
《Agent Runtime 工程化》第十章 Eval Harness 与 CI 回归：10.2 deterministic mock model
真实模型有随机性、网络波动和供应商变化。Eval 需要两层： 第一层用 deterministic mock model 测 runtime 逻辑。它按照脚本返回固定 tool calls，用来验证 schema 校验、权限、checkpoint、trace、停止条件。 第二层用真实模型测端到端能力
站点编辑发布于 2026/8/13更新于 2026/10/147 浏览0 点赞约 7 分钟阅读
编程语言Agent Runtime教程可观测性
《Agent Runtime 工程化》第十章 Eval Harness 与 CI 回归：10.3 replay：让 trace 进入测试
一次线上失败，如果不能转化为 eval，它就会再次发生。建议流程： 1. 从 trace 中提取用户目标、关键上下文、工具调用和失败结果； 2. 去除 secret 和用户隐私； 3. 固化 workspace fixture； 4. 写 expected behavior； 5. 加入 CI； 6
站点编辑发布于 2026/8/13更新于 2026/10/141 浏览0 点赞约 6 分钟阅读