新一代提示词工程 · 知识全景图面向有工程基础、提示词工程尚未系统化的工程师
显示设置

系统 / 开发者 / 用户提示词分层

System, Developer, and User Prompt Layering

PE-F-02内容已写满G00地基:模型是概率采样器第 1 层

地基提示词分层缓存

一句话结论

按变更频率与权威性把提示词分层,稳定前缀放前、易变内容放后。

本页结构(可跳转)

L1 系统层 产品身份 · 长期约束 · 安全策略 几乎不变 ⇒ 可缓存 L2 开发者层 任务级指令 · 输出契约 随调用点变化 L1->L2 特权递减 C 稳定前缀 缓存命中面 L1->C L3 用户层 本次输入 完全不可信 L2->L3 特权递减 X 易变后缀 每次重算 L2->X L3->X N 放错层的代价 易变内容进了系统层 ⇒ 前缀失效、缓存归零 (还顺手把「谁说了算」也搅乱了) L3->N 失配
分层图:三层的稳定性与特权递减,以及「缓存命中面」恰好切在稳定前缀与易变后缀之间。 (本站自制)

01为什么需要它

提示词不是一段越写越长的文本,而是按特权与生命周期分层的一组指令。

适用边界

层数由运行时决定,若所用运行时只暴露单层提示,则应至少用分隔符在文本上模拟出分层,而不能因此放弃分层心智。

02机制说明

系统层承载产品身份、长期约束与安全策略,其特点是稳定、由开发者掌控、可被缓存;开发者层承载任务级指令与输出契约,随调用点变化;用户层承载本次输入,内容不可信。

03何时该用 / 何时不该用

按场景对照:先看条件,再看该怎么做。
类别场景 / 条件(总结)具体做法(细节)
该用提示中包含长期不变的产品约束时放进系统层,使缓存可命中且改动面最小。
该用需要表达指令优先级时用分层承载特权关系,而不是在正文里用大写强调。
不该用把系统层当垃圾桶把每次调用都变的内容写进系统层会破坏前缀稳定性并推高成本。
不该用假设分层本身即安全层级只是工程落点,真正的防御还需要权限收窄与输出校验。

04实验台

  1. shellbash

    查看代码
    # 同一段长前缀,分别用「系统层内容完全不变」与「系统层改一个字」的两种方式调用
    # 记录每档的时间与计费字段(缓存命中通常在响应里以 cached_tokens 之类的字段体现)
    for variant in stable mutated; do
      echo "== variant=$variant =="
      for i in 1 2 3; do
        curl -s "$API_ENDPOINT" -H 'content-type: application/json' \
          -d @"payload-$variant.json" | grep -o '"[a-z_]*cached[a-z_]*":[0-9]*'
      done
    done

    预期观察:stable 档从第二次起出现缓存命中字段、延迟明显下降;mutated 档每次都当作全新前缀,命中归零。这一步让读者亲眼看到「系统层的稳定性 = 可缓存性 = 成本」。

  2. filemarkdown

    查看代码
    分层记录表:把现有提示逐段剪开,每段填四列
      段内容 | 放在哪一层(系统 / 开发者 / 用户) | 变更频率(几乎不变 / 每次调用 / 完全不可信) | 若放错层的代价
    判据:凡是「几乎不变」的内容都应落在系统层且位于前缀;凡是「每次调用都变」的内容都不得进系统层。
    不得用「反正模型看得懂」替代分层判断——分层要管的是缓存与权限,不是模型理解力。

    预期观察:读者能把自己的提示切成三层,并说出每一段为什么在那层,而不是凭感觉排列顺序。

05证据

主张精简系统层(删掉重复指令与示例、简化工具描述)在内部编码 agent 评测中把分数提高约 10–15%,同时把 token 降 41–66%、成本降 33–67%;其一般化规则是「每条指令只写一次」。

分级official

来源S-0012 https://developers.openai.com/api/docs/guides/latest-model

原文

展开原文关键句 原文截断
Removing repeated instructions and examples and simplifying tool descriptions can improve task performance and token efficiency. ... State each instruction once.

06术语

术语提示词分层 系统 / 开发者 / 用户)(Prompt Layering

界定把提示词按特权与生命周期拆为系统、开发者、用户三层,各层承担不同的稳定性与权威性职责。

相关节点—

术语提示缓存 Prompt Caching

界定把稳定的提示前缀在服务端缓存复用,以降低重复前缀的延迟与计费成本;要求前缀稳定且顺序固定。

相关节点—

07失效模式

08在本站知识结构中的位置

所属分组
G00地基:模型是概率采样器
依赖深度
第 1 层(同层节点彼此无先后约束)
前置PE-F-01→PE-F-02 本节点→后继PE-F-03

在 交互全景图 中定位本节点。