提示词

把反复使用的提示词存成配置，在 Agent 里按需组合，避免每次手写。

两种类型

类型	用在哪	典型内容
系统提示词	定义角色、边界、输出格式	「你是代码审查员，只报告可复现的问题」
用户提示词	作为用户侧的开场或约束	「回答前先列出假设」

一个 Agent 可以同时选多条，按列表顺序拼接。

新建提示词

左侧菜单 Prompts → 新建：

1. 标题：写清用途，例如「严格 JSON 输出」。
2. 提示词类型：系统 / 用户。
3. 内容：支持模板变量，写作 $variable 或 ${variable}。
4. 保存。

模板变量

在内容里写 $name 或 ${name}，运行时会替换为对应值。适合：

• 项目名、模块名
• 输出语言
• 固定格式的字段说明

变量没有值时，会保持原样或按界面提示处理；发布前先用一个会话试跑。

在 Agent 中使用

打开 Agents 编辑页：

• 系统提示词区域勾选；
• 用户提示词区域勾选。

调整顺序会影响拼接结果，建议把「角色定义」放在最前，「输出格式」放在最后。

编写建议

1. 一条提示词只做一件事，方便复用与替换。
2. 写可验证的约束：格式、长度、必须包含/禁止出现的内容。
3. 不要把密钥、内部地址写进提示词；需要凭据时用交换空间。
4. 先在小会话里验证，再挂到生产 Agent。

常见问题

修改后没生效：确认 Agent 引用的是这条提示词，并且新回合已开始。

变量没替换：检查变量名拼写与写法（$name / ${name}）。

提示词互相冲突：拆成多条并按顺序排列，冲突的约束只保留一条。