附录 03 模板库

本附录收集整套《前端转 AI Agent 工程师进阶指南》中最常用、最容易复用的模板。它的目标不是替代思考，而是帮助你在做方案设计、Prompt 编写、评测、上线、复盘和作品集整理时，直接拿到一个可改、可用的起点。

1. 如何使用这份模板库

推荐做法不是原样复制，而是按下面的顺序使用：

• 先明确场景目标。
• 再选最接近的模板。
• 根据你的业务边界补字段或删字段。
• 和真实输入样本一起跑一轮。
• 最后把结果沉淀回模板版本库。

一个成熟的团队，不是“每次都从零开始写”，而是持续沉淀模板资产。

2. Prompt 模板

2.1 系统角色模板

你是一个 {{role_name}}，服务对象是 {{target_users}}。
你的核心目标是 {{goal}}。

你必须遵守以下边界：
1. 只能基于给定信息作答，不能编造事实。
2. 遇到证据不足的情况要明确说明不确定。
3. 涉及高风险操作时，必须提示用户确认。
4. 输出必须遵守给定格式。

2.2 结构化输出模板

请严格按照以下 JSON 返回，不要添加额外解释：
{
  "answer": "string",
  "confidence": "high|medium|low",
  "citations": [
    {
      "doc_id": "string",
      "title": "string",
      "quote": "string"
    }
  ],
  "need_human_review": true
}

2.3 RAG 回答模板

你正在回答企业内部知识问题。
请仅基于提供的检索证据作答。
如果证据不足，请明确说明“根据当前资料无法确认”。
回答时请给出简洁结论，并附带引用来源。

用户问题：
{{user_question}}

检索证据：
{{retrieved_context}}

2.4 工具调用前计划模板

请先生成一个执行计划，不要立刻执行。
要求输出：
1. 目标是什么
2. 预计分几步执行
3. 哪些步骤有副作用
4. 哪些步骤需要用户确认

3. 评测模板

3.1 评测样本字段模板

{
  "id": "sample_001",
  "question": "报销申请最晚什么时候提交？",
  "expected_answer": "示例标准答案",
  "allowed_docs": ["expense_policy_v2"],
  "must_refuse": false,
  "tags": ["hr", "policy", "simple"]
}

3.2 版本回归记录模板

版本号：
修改内容：
涉及模块：Prompt / 检索 / 重排 / 工具 / 模型版本
评测集名称：
关键指标：
- 正确率：
- 引用准确率：
- 拒答准确率：
- 平均延迟：
- 单次成本：
结论：通过 / 不通过 / 需复查

3.3 失败样本复盘模板

样本 ID：
用户问题：
期望结果：
实际结果：
失败类型：召回失败 / 重排失败 / 生成失败 / 格式失败 / 拒答失败
根因分析：
修复动作：
是否加入回归集：是 / 否

4. 工作流与运行模板

4.1 节点设计模板

节点名称：
节点目标：
输入：
输出：
依赖：
失败回退：
是否可重试：是 / 否
是否需要人工确认：是 / 否

4.2 上线前检查模板

版本号：
发布日期：
变更范围：
是否完成回归评测：是 / 否
是否完成灰度方案：是 / 否
是否有回滚方案：是 / 否
监控指标是否配置：是 / 否
风险负责人：
最终结论：可发布 / 暂缓发布

4.3 故障 Runbook 模板

故障名称：
影响范围：
故障现象：
初步判断：模型异常 / 工具异常 / 检索异常 / 外部依赖异常
应急动作：
回滚动作：
用户侧公告文案：
复盘负责人：

5. 前端交互模板

5.1 Agent 状态枚举模板

export type AgentStatus =
  | 'idle'
  | 'thinking'
  | 'retrieving'
  | 'calling_tool'
  | 'waiting_user_confirmation'
  | 'partial_success'
  | 'needs_human_takeover'
  | 'completed'
  | 'cancelled'
  | 'failed';

5.2 高风险确认弹窗模板

操作名称：
影响对象：
可能结果：
是否可撤销：
建议说明：
确认按钮：继续执行
取消按钮：先不执行

5.3 失败空态模板

这次没有顺利完成。
可能原因：
- 当前信息不足
- 外部系统暂时不可用
- 当前操作需要更高权限

你可以尝试：
- 补充更多上下文
- 稍后重试
- 转人工处理

6. 项目与作品集模板

6.1 项目卡片模板

项目名称：
业务背景：
目标用户：
核心问题：
方案概述：
关键能力：RAG / Tool Calling / Workflow / Eval / Observability / Security
结果指标：
个人职责：
复盘总结：

6.2 STAR 讲述模板

Situation：当时的业务背景和痛点是什么。
Task：你要解决的关键问题是什么。
Action：你具体做了哪些设计、实现、评测和优化动作。
Result：指标、结果、业务反馈和复盘是什么。

6.3 证据材料清单模板

- 系统架构图
- 核心链路图
- 关键 Prompt 版本
- 评测报告
- 指标对比图
- 发布与回滚记录
- Demo 截图或录屏
- 项目复盘文档

7. 学习与复盘模板

7.1 每周复盘模板

本周目标：
本周完成：
本周卡点：
解决方式：
沉淀产物：
下周重点：

7.2 章节练习复盘模板

章节名称：
本章关键收获：
我做出的产物：
哪一步最难：
我还缺什么能力：
我能如何向面试官表达：

8. 如何维护模板库

建议把模板库当成持续更新的资产，而不是一次性文档。 你可以按以下方式维护：

• 每完成一个项目，就补充一份真实有效的模板变体。
• 每发现一种高频失败模式，就补一个复盘模板或检查清单。
• 每经历一次上线或面试，就把有效话术和检查项沉淀下来。
• 模板命名尽量体现适用场景，而不是只写“final”“new”“v2”。

9. 面试表达

你可以这样讲：

“我在做 AI Agent 工程时，不只积累代码，也同步沉淀了 Prompt、评测、Runbook、交互和项目复盘模板。这样做的价值在于，项目不会停留在一次性 Demo，而是能够被团队复用、被后续版本延续，也更容易在面试中展示我是如何把经验产品化和工程化的。”