如何把 Agent 做成项目？四类场景的架构与验收
内容摘要：把前面各章的模块组合成四类典型 Agent。每个项目给出架构、工具集、状态、安全边界与评测要点。示例沿用统一数据模型（见首页），避免重复造轮子。 难度：高级 |前置知识：06、08、13、14
常见误区
只要把模型、几个工具和一段系统提示拼起来，编码、数据分析、客服或运维 Agent 就具备可交付能力。
先给结论
Agent 项目应从任务边界、工具权限、状态、失败路径和验收指标开始设计。不同场景共享受控循环骨架，但工具副作用、事实来源、人工审批和质量指标必须按领域分别定义。
带着这三个问题阅读：
- 四类项目共享哪些模块，哪些边界绝不能照搬？
- 每个项目的高风险工具、事实来源和人工接管点在哪里？
- 怎样把“能演示”转化为可重复的验收标准？
通用骨架
四类项目共享同一骨架：目标 → 受控上下文 → 循环决策 → 校验 → 权限内执行 → 观察 → 停止/审批 → 记录轨迹（06 + 08 + 13 + 17）。差异只在工具集、权限与评测指标。
一、运维 Agent（KB-Ops，本库主线）
- 工具：只读观测 + 高危写（审批闸门，13）。
- 状态：任务 phase、待审批动作（09）。
- 安全：只处理 test/staging；高危必审批；参数白名单（14）。
- 评测：排障建议正确性、误操作率（必须 0 未授权高危执行）、平均步数。
二、编码 Agent
- 工具：读文件、检索、在沙箱中执行/测试（14 沙箱）。
- 安全：代码执行必须沙箱（无网/只读/限额）；写仓库/开 PR 走人工评审。
- 停止条件：测试通过 or 步数上限；失败可重试有限次（15）。
- 评测：测试通过率、补丁最小性、是否引入回归。
三、数据分析 Agent
- 工具：参数化/受限的只读查询（绝不拼接执行，14）、可选沙箱内计算。
- 安全：只读账号、行数/超时限制、禁写；SQL 经允许列表/模板，不裸执行模型输出。
- 评测：答案与金标准比对、SQL 正确率、忠实度（不编造数字）。
四、客服 Agent
- 工具：RAG 检索（11）、工单创建（写，幂等，15）。
- 安全：外部知识不可信；不泄露他人数据；退款/改单等高危转人工。
- 记忆：用户偏好/历史（10，多租户隔离）。
- 评测：解决率、引用正确性、升级率、投诉率。
五、四项目对比
| 项目 | 主要工具 | 最大风险 | 关键控制 | 核心指标 |
|---|---|---|---|---|
| 运维 | 观测 + 高危写 | 误操作生产 | 审批 + 白名单 + 幂等 | 未授权高危执行=0 |
| 编码 | 代码执行 | 沙箱逃逸/坏改动 | 沙箱 + 人工评审 | 测试通过率/回归 |
| 数据分析 | 只读查询 | SQL 注入/全表扫 | 参数化 + 只读 + 限行 | 答案正确率/忠实度 |
| 客服 | RAG + 工单 | 幻觉/数据泄露 | 引用 + 转人工 + 隔离 | 解决率/投诉率 |
六、失败路径（共性）
- 把只读场景误配了写权限。
- 代码/SQL 直接执行模型输出，无沙箱/无参数化。
- 无停止条件导致刷步数。
- 无引用导致无法验证客服/分析结论。
七、测试与验证
- 每个项目都要有：单元（工具/校验）+ 集成（Mock 模型轨迹）+ 端到端评测集 + 对抗测试（16）。
八、安全与权限
九、性能与成本
- 分析/编码类步数多、Token 高，务必预算护栏与模型路由（18）。
十、关联章节
- 下一章：22 故障排查 相关：全库各章的落地综合。
面试复述
项目落地要把目标、工具、状态、安全和评测组合成闭环。先交付受限的最小场景，用成功与失败轨迹验收，再依据线上证据逐步增加自主性。
复述时先给结论，再补机制、适用边界和一个可验证指标；不要只罗列框架名称或产品功能。
迁移练习
从四类项目中任选一个，写出 MVP 的输入、输出、工具白名单、状态机、三条失败路径、人工接管点和五个量化验收指标。
检索关键词
运维 Agent 编码 Agent 沙箱 数据分析 Agent SQL 安全 客服 Agent RAG 项目架构对比
官方来源
- 本章为各章综合的工程实践，不依赖特定框架（
verified_at: 2026-09-07）。