提示词模板 ★
一句话：模板是聊天面板的提词起手式——用户点一下，正文原样插进输入框，可以改完再发送；它不进系统提示词，也不影响工具与权限。
功能在哪
- 菜单路径：AI → AI 助手 → 提示词模板
- 地址栏路由：
/ai/agent/prompt-template - 主要权限：
agent:prompt-template:query（新增 / 编辑 / 删除等按钮另受对应写权限控制）
界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 查询区 | 名称 / 正文（按关键字找）/ 分类 / 状态 | 「搜索」「重置」「新增」 |
| 列表 | 展开箭头 / 序号 / 模板名称 / 分类 / 正文 / 占位符（标签）/ 排序 / 状态（开关）/ 创建时间 / 操作 | 行内「查看」「编辑」「删除」；展开箭头看示例 |
点行首展开箭头，行内展开该模板的示例子表（标题「『{模板名}」的示例 N 条」+「新增示例」按钮）：
示例子表列：标题 / 正文（点一下原样插进聊天输入框）/ 期望要点 / 期望分型（如 BUILD）/ 排序 / 状态 / 操作（编辑、删除）。示例是给管理页与验收脚本看的「这条模板填完长什么样」，不会发给模型。
模板不是系统提示词
页面底部信息条原话：「模板是聊天面板的提词起手式：用户点一下，正文就插入到输入框，他可以改完再发送。它不会进系统提示词，也不影响工具调用与权限，所以这里不需要声明风险等级。正文里用 {{占位符}} 标记要用户替换的位置。」
编辑面板：左表单、右预览
行内「编辑」或「新增」进入页内面板（「返回 / 取 消 / 保 存」）：
| 字段 | 要点 |
|---|---|
| 模板名称 | 128 字；「聊天面板里按钮上显示的就是它，短一点更好认。」 |
| 分类 | 聊天面板按分类分组：同分类内排序小的在前，分类之间则按「该分类里最小的排序号」排先后——想让整个分类靠前，就把它某条模板的排序调小；「未分类」排最后 |
| 排序 | 数值，规则见上 |
| 状态 | 开启 / 关闭；「关闭后不出现在聊天面板，但仍在列表里可见可改——比删掉再重建常用。」 |
| 用途说明 | 500 字；给维护者看的一句话场景描述 |
| 模板正文 | 8000 字；自动识别 {{占位符}} 并打成标签，可「在光标处插入占位符」 |
| 右侧预览 | 「聊天面板里的样子」：占位符高亮展示，所见即用户所得 |
示例弹窗：给模板配「填完的样子」
子表「新增示例」或行内「编辑」打开弹窗（页脚「取 消 / 保 存」）：
| 字段 | 提示原话摘录 |
|---|---|
| 所属模板 | 只读 |
| 标题 | 「『示例』页签里显示的就是它，短到一行能读完；它的作用是让人在几十条示例里一眼认出『这条像我的场景』。」 |
| 正文 | 「点一下原样插进输入框：不改写、不补全、不 trim 内部空白。写满真实细节（具体表名、具体字段名、具体报错原文），而不是又一篇换个说法的骨架。正常情况下不该留下未填的 {{占位符}}；但工作流 DSL 的取值表达式本身就长这样（{{ $.input.tableName }}），教用户问 DSL 的示例必须能把它写出来，故这里不拦。」 |
| 期望要点 | 「一条合格回答应该线上出现什么。只给管理页和验收脚本看，不会发给模型。写可判定的事实（『是否提到 DDL 预览』），别写『回答应当专业、清晰、有条理』——后者永远为真，也就永远验不出任何回归。」 |
| 期望分型 | 「期望分型留空 = 这条用例正压在『问怎么做』与『让你去做』的界线上，两种分型都对，验收时不拿它做断言。关闭 = 不出现在聊天面板，但这里仍可见可改。」 |
| 排序 / 状态 | 数值与开启 / 关闭 |
常用操作
新增 / 编辑模板
「新增」进面板填名称、分类、正文（用「在光标处插入占位符」补 {{...}}），右列预览确认聊天面板里的样子后「保 存」。
维护示例
展开行 →「新增示例」填「填完的样子」与期望要点 / 期望分型；示例行内「编辑 / 删除」单独维护，不动模板本体。
临时下架模板
行内状态开关关掉即可：聊天面板不再展示，列表里保留配置，随时可再开启——比删除重建省事。
视角对照
| 视角 | 看到什么 |
|---|---|
租户管理员 docadmin | 模板与示例的全量维护 |
业务角色（如 salesman01） | 看不到本菜单；他们在聊天面板看到开启中的模板按钮，点一下正文进输入框 |
进阶
- 占位符语法
{{名称}}：正文里几处占位符，列表「占位符」列就打几个标签，编辑时自动识别； - 模板与智能体人设是两层：人设管「怎么答」，模板管「怎么问得标准」——把高频诉求固化成模板，能显著降低用户提问质量的方差；
- 示例的期望要点 / 期望分型是验收资产：改模板或改人设后，拿示例跑一遍验收脚本即可发现回归；
- 排序规则同时作用于分类内与分类间（分类间比「该分类最小排序号」），调面板顺序时先想清楚动哪一层。
常见问题
Q：模板会进系统提示词吗？会影响工具调用吗？ A：都不会。模板只是插进输入框的起手式，用户可改后再发送（见信息条原话）。
Q：模板关闭和删除有什么区别？ A：关闭后聊天面板不展示、列表保留可改；删除是彻底移除。临时下架用关闭。
Q：示例是发给模型看的吗？ A：不是。示例只给管理页与验收脚本看；其中「正文」是用户点一下插进输入框的样例文本。
Q：为什么示例正文里还留着 {{...}} 不算错？ A：工作流 DSL 的取值表达式本身就长这样，教用户问 DSL 的示例必须能写出来，故不拦（见正文提示原话）。
Q：怎么让整个分类在聊天面板里靠前？ A：把该分类里某条模板的排序号调到最小——分类之间比的是「该分类里最小的排序号」。