编写提示词

Normal

普通模板，支持简单的变量替换，包裹在双大括号 {{}} 中的内容将被自动定义为变量。

• Prompt 模板内容：我的问题是“{{question}}”
• 变量内容：question=中国是什么类型气候
• 实际输入给模型的 Prompt：我的问题是“中国是什么类型气候”

Jinja2

Jinja2 模板，允许在提示词中嵌入逻辑，使提示词能够根据上下文动态调整，适合在需要动态智能提示的场景（如聊天机器人、客服）下更灵活和高效地编写提示词。

• 支持 Jinja2 语法，可实现过滤器、条件判断等复杂的变量逻辑。
• 需要先在右侧变量区域添加变量，才能用双大括号 {{}} 引用变量。

此外， Jinja2 模板还支持多种数据类型的 Prompt 变量，部分数据类型有一定格式要求。详细说明可参考Jinjia2 模板变量数据类型。

• Prompt 模板内容：The title is {{title_variable|title}}. Please discuss it.
• 变量内容：title_variable为a simple question
• 实际输入给模型的 Prompt：The title is A Simple Question. Please discuss it.

更多示例可参考模板引擎语法示例。

Normal

Normal 模板无需手动定义变量，直接在 Prompt 中输入变量格式即可。
在 Prompt 模板区域，直接输入变量格式和变量名称，例如 {{City}}。系统会自动识别变量格式，并在右侧的 Prompt 变量区域添加对应名称（例如 City）的变量。

Jinja2

Jinja2 模板需要手动定义变量，然后才能在 Prompt 中引用这个变量。

1. 在 Prompt 变量区域中，单击新增变量。
2. 设置变量的名称、数据类型和变量值，并单击确认。
3. 在 Prompt 模板区域，输入变量格式和变量名称来引用这个变量，例如 {{Province}}。

系统提示词 (System prompt)

作用：定义模型的全局规则，用于指导模型的整体行为，例如角色设定、任务边界、输出格式要求等。
使用场景：系统提示词在所有对话开始时加载，持续影响后续交互。

System prompt 示例：

你是一名长沙旅游向导助手，需遵守以下规则：
1. 推荐内容需标注价格范围和地理位置（如“五一广场附近”）；
2. 若用户需求不明确，主动提问澄清。
3. 使用中文回答用户问题，注意礼貌。

用户提示词 (User prompt)

作用：用于接收用户动态请求，通常使用占位符{{query}} 绑定具体内容。
使用场景：当用户与 AI 应用进行交互时，他们提供的输入信息会被系统接收。系统会将提示中的占位符替换为用户的实际输入内容，从而生成完整的提示信息，然后将其发送给模型进行处理。

• User prompt 示例：

  用户需求：{{query}}
  请按上述规则回答，并附上费用估算。
  

• 用户提示词：“推荐五一广场附近的平价住宿”

• 替换后，发给模型的完整提示如下：

  用户需求：推荐五一广场附近的平价住宿
  请按上述规则回答，并附上费用估算。
  

助手回复 (Assistant prompt)

作用：明确指导模型以特定角色、风格、格式或逻辑进行回应的提示内容。
使用场景：通常与用户的问题（User Prompt）配合使用，用于约束或引导模型的输出行为，使其更符合预期的应用场景。

以下是一个文案生成助手的 Prompt 模板配置示例。

• 系统提示词：

  你是一个电商客服，可以回答用户的问题。
  

• 用户提示词：

  我的订单显示发货了，但一周还没收到，怎么办？
  

• 助手回复：

  你现在是某电商平台的客服助手，需要以友好、专业的语气回应。首先安抚用户情绪，然后分步骤提供解决方案（如查询物流、联系快递、补发订单），最后主动询问是否需要进一步帮助。
  

模型会参考助手回复的内容，生成一个如下的输出：

非常抱歉给您带来不便！您的包裹可能因物流高峰期有所延迟。建议您先通过订单页面查询物流单号和最新状态；若信息异常，我们可以帮您联系快递确认；若长时间未收到，我们将为您申请补发。请问需要为您转接物流查询服务吗？

占位符 (Placeholder)

作用：用于记录历史对话记录，提供模型更多上下文信息。
使用场景：在多轮对话场景中，用户追问时，模型可以根据历史对话记录，准确生成回复内容。
配置说明：当在 Prompt 模板中添加 Placeholder 后，需要在右侧的 Prompt 变量区域，单击编辑 Placeholder 添加作为上下文历史内的对话历史**。**

以下是一个客服场景的 Prompt 模板配置示例。

• 系统提示词：

  你是一名电信运营商智能客服，需要遵守以下规则：
  1. 准确识别用户问题类型（资费查询/故障报修/套餐变更）
  2. 每次回复需包含当前对话轮次标识
  3. 当用户问题不明确时，要求提供手机号码后四位验证身份
  

• Placeholder 配置：

  {{chat_history}}
  

• Prompt 变量中添加的 Placeholder 的对话历史：

  User: 我的网络突然不能用了
  Assistant: 请问您的手机号码后四位是多少？我们需要先验证身份。
  User：1389
  Assistant: 1389尾号用户您好，检测到您家宽带处于离线状态，正在为您创建故障工单...
  

当用户提问工单号是多少时，模型回复如下所示：

1389尾号用户您好，您当前的故障工单号是【CT20231115001】，已安排工程师尽快为您处理，预计2小时内修复。请保持手机畅通，以便工程师联系您。

当用户进行追问时，通过占位符自动注入完整对话历史，保证了对话的连续性和回复的准确性。

Normal 模板引擎

支持简单占位符以供静态变量注入。
例如：

• 模板：我的问题是：{{question}}
• 变量输入 ：question=中国是什么类型气候
• 传递给模型：我的问题是：中国是什么类型气候

提示结构固定。

• 场景：构建一个多轮对话的AI助手，目标是当对话历史较长（比如超过3轮）时，在提示中加入对历史对话的总结。
• 解法：普通模板引擎不支持条件判断和复杂逻辑，必须在 Prompt 外部处理逻辑，然后将处理后的字符串传入 Prompt。

Jinja2 模板引擎

条件判断

支持变量的复杂逻辑/计算，如条件分支/循环/过滤器等。
例如：

• 模板：

{% if include_hint %}温馨提示：{{hint_variable}}
{% endif %}。
我的问题是：{{question}}

• 变量输入：include_hint=True，hint_variable=想想中国地理知识，question=中国是什么类型气候
• 传递给模型：

温馨提示：想想中国地理知识。
我的问题是：中国是什么类型气候

实时根据上下文调整提示结构。
示例效果如下：

• 场景：构建一个多轮对话的AI助手，目标是当对话历史较长（比如超过3轮）时，在提示中加入对历史对话的总结
• 解法：在 Prompt 中根据上下文动态生成不同的提示结构

{% if history
  以下是对话的总结：{{ summarize_history(history) }}
  请根据以上总结继续对话。
{% else %}
  对话历史：
  {% for turn in history %}     {{ turn.role }}: {{ turn.content }}
  {% endfor %}
{% endif %}
用户最新输入：{{ new_input }}

循环

• 模板：

{% for choice in choices %}选项{{loop.index}}：{{choice}}
{% endfor %}
你认为哪个选项最合适？

• 变量输入：choices=[‘热带’, ‘亚热带’, ‘温带’]
• 传递给模型：

选项1：热带
选项2：亚热带
选项3：温带
你认为哪个选项最合适？

过滤器

• 模板：标题是{{title_variable
• 变量输入：title_variable=brief introduction to chinese culture
• 传递给模型：标题是Brief Introduction To Chinese Culture。请对此展开讨论。

String

字符串类型

“Hello World”

Integer

整数类型
必须是 Int64 范围

42

Float

浮点数类型

• Float64 范围
• 最多支持 4 位小数

3.1415

Boolean

布尔类型

True / False

Object

对象类型

• 符合 JSON 格式的对象
• 最多支持三层嵌套
• 不支持自引用

{“name”: “张三”, “age”: 30}

Array

字符串数组

• 符合 JSON 格式的数组
• 元素数量不超过 100 个

[“苹果”, “香蕉”, “橙子”]

Array

整数数组

• 符合 JSON 格式的数组
• 元素数量不超过 100 个

[1, 2, 3, 4, 5]

Array

浮点数数组

• 符合 JSON 格式的数组
• 元素数量不超过 100 个

[1.1, 2.2, 3.3]

Array

布尔值数组

• 符合 JSON 格式的数组
• 元素数量不超过 100 个

[true, false, true]

Array

对象数组

• 符合 JSON 格式的数组
• 元素数量不超过 100 个

[{“id”: 1, “name”: “张三”}, {“id”: 2, “name”: “李四”}]