这是一个 非常关键、但经常被混在一起 的问题。
我会用 业务能理解的语言，再配上 同一个任务的三套案例，把区别讲清楚。

一句话先给结论（给业务人员看的）

• API 用提示词 = 「程序怎么指挥模型」
• Agent 用提示词 = 「老板怎么交代一个长期员工」

它们的目标、写法、颗粒度完全不同。

🧠 提示词架构图（统一认知版）

┌──────────────────────────────────────┐
│          Agent Prompt（岗位层）       │
│  定义：AI 是谁 + 长期职责 + 工作流程 │
│  类比：岗位说明书 / 员工手册         │
└──────────────▲───────────────────────┘
               │（长期有效）
┌──────────────┴───────────────────────┐
│        System Prompt（规则层）         │
│  定义：全局规则 / 风格 / 合规边界     │
│  类比：公司制度 / 统一规范           │
└──────────────▲───────────────────────┘
               │（每次请求都会生效）
┌──────────────┴───────────────────────┐
│        User Prompt（任务层）           │
│  定义：这一次具体要做什么             │
│  类比：一条临时工作指令               │
└──────────────────────────────────────┘

一、怎么给「业务人员」解释这张图？

你可以直接照着下面这段话讲 👇

我们在用 AI 的时候，其实分三层：

• 最上面一层（Agent Prompt）：
  决定 AI 是“什么岗位的人”，长期负责什么事

• 中间一层（System Prompt）：
  决定所有输出都要遵守的规则，比如合规、语气、风格

• 最下面一层（User Prompt）：
  就是你今天这一次，具体要它干什么

业务人员只需要关心：

• 我是在“交一次任务”
• 还是在“培养一个长期干活的 AI”

二、怎么给「技术人员」解释这张图？

给技术的说法可以是 👇

• Agent Prompt：长期驻留的 meta prompt，包含职责、流程、决策逻辑
• System Prompt：request-level 的全局约束
• User Prompt：per-call 的任务输入

一句话：

Agent = 有状态的协作体
API Prompt = 无状态的调用

三、三层分别“该写什么 / 不该写什么”（重点）

1️⃣ Agent Prompt（岗位层）

✅ 该写：

• 角色定位（你是做什么的）
• 长期目标
• 工作流程
• 判断标准
• 异常处理原则

❌ 不该写：

• 具体某一次的任务
• 临时需求
• 细碎参数

📌 关键词：长期、职责、流程、判断

2️⃣ System Prompt（规则层）

✅ 该写：

• 统一语气
• 合规要求
• 禁止事项
• 输出语言
• 公司级规范

❌ 不该写：

• 复杂业务流程
• 多步推理
• 具体示例（容易污染）

📌 关键词：统一、稳定、边界

3️⃣ User Prompt（任务层）

✅ 该写：

• 明确任务
• 当前上下文
• 输出要求
• 字数 / 格式

❌ 不该写：

• 公司背景
• 长期规则
• 重复的角色说明

📌 关键词：一次性、具体、明确

四、用同一个业务案例来对比（核心部分）

📌 业务案例

场景：给 B 端客户生成一段「产品更新通知文案」

4.1、API 场景：系统提示词 vs 用户提示词

1️⃣ 系统提示词（System Prompt）

作用：设定“永久规则”

你是蜜堂有信的企业级 AI 文案助手。
你必须遵守以下规则：
- 输出内容需专业、简洁、适合 B 端客户
- 禁止夸大、虚假承诺
- 不得涉及价格、合同、法律承诺
- 输出使用简体中文

🔍 解释（业务视角）

• 像是「公司统一话术规范」
• 所有请求都会生效
• 一般不会频繁修改

2️⃣ 用户提示词（User Prompt）

作用：描述“这一次的具体任务”

请帮我写一段产品更新通知，
面向企业客户，
说明我们本次新增了「数据导出功能」，
重点强调“操作更方便”，
控制在 120 字以内。

🔍 解释（业务视角）

• 像是一次临时工作指令
• 每次任务都不同
• 不需要写背景规则（已经在 system 里）

🔁 API 提示词的典型特点

• 短
• 明确
• 不解释“为什么”
• 假设模型 不会记住上一次

4.2、Agent 场景：Agent 提示词怎么写？

Agent 提示词 ≠ System Prompt + User Prompt 简单相加
Agent 是 长期运行、会规划步骤、会反复调用工具 的。

3️⃣ Agent 提示词（完整示例）

你是蜜堂有信的「企业客户沟通 Agent」。

你的长期职责包括：
- 将产品变更转化为客户可理解的语言
- 判断不同客户类型适合的沟通方式
- 在输出前进行合规与风险自检

你的工作流程是：
1. 读取产品更新信息
2. 判断是否适合对外通知
3. 选择合适的沟通语气（正式 / 中性）
4. 生成客户通知文案
5. 自检是否存在夸大、歧义或风险表述

你的输出要求：
- 面向 B 端客户
- 专业、克制、不营销
- 默认不超过 150 字
- 如信息不足，请主动提出澄清问题

🔍 解释（业务视角）
这相当于：

“你是我们公司的客户沟通负责人，
以后所有这类事情都你来处理，
遇到不确定的你要自己判断。”

五、核心差异对照表（非常重要）

六、一个「错误 vs 正确」的整体架构对比

❌ 错误架构（常见）

System Prompt：
- 你是一个资深专家
- 你要负责所有事情
- 你要输出各种内容
- 你要判断场景
- ……

结果：

• 谁也说不清 AI 在干嘛
• 业务不敢改
• 技术不好维护

✅ 正确架构（推荐）

Agent Prompt：定义“你长期负责什么”
System Prompt：定义“永远不能越界什么”
User Prompt：定义“这次要干嘛”

结果：

• 业务知道自己该写哪一层
• 技术知道哪一层能改、哪一层不能动
• 整体可扩展、可维护

七、FAQ：

Q1：我怎么快速判断该写哪一层？

用这三句话自问自答：

1. “这是一次性的任务吗？”
   👉 是 → 写 User Prompt（用户提示词）

2. “这是所有任务都要遵守的规则吗？”
   👉 是 → 写 System Prompt（系统提示词）

3. “这是一个长期负责某类工作的角色吗？”
   👉 是 → 写 Agent Prompt（Agent 提示词）

Q2：太复杂记不住，有一句话公式吗？

有的，请背下这一句：

Agent Prompt 决定“你是谁”，
System Prompt 决定“你不能做什么”，
User Prompt 决定“你现在做什么”。

Q3：System Prompt 和 Agent Prompt 都有“角色设定”，怎么分？

核心区别在“动态”还是“静态”：

• System Prompt：侧重静态的底线和风格（如：“严禁谈论政治”、“始终保持礼貌”）。它是被动防守的。
• Agent Prompt：侧重动态的职责和流程（如：“先查询库存，再回复客户”）。它是主动执行的。

Q4：如果效果不好，我应该先改哪一层？

请按这个“倒序”来检查：

1. 先改 User Prompt（最快）：是不是这次的任务描述不清楚？
2. 再改 Agent Prompt（逻辑）：是不是工作流程或思考步骤设计错了？
3. 最后动 System Prompt（全局）：只有当所有任务都出现同样的风格/合规问题时，才去改它。