AI 内容创作 / 系统课时

对话提示词结构设计

对话提示词结构设计

对话提示词的稳定性取决于结构,而不是文字长度。本课将把系统规则、角色约束、历史消息、用户输入和运行时信息分层组织,明确拼装顺序、裁剪策略与验证方法,最终得到一份可直接用于对话编排的模板构建程序。

学习目标

  • 能说明不同提示词层的职责与优先级
  • 能构建包含历史消息和运行时信息的消息包
  • 能通过固定测试检查模板是否丢失约束或引入冲突

五类输入与拼装顺序

系统提示负责全局规则,角色约束描述身份与服务边界,历史消息提供上下文,运行时信息注入当前时间、渠道或用户状态,用户输入表达本轮真实请求。它们必须分层保存,不能先拼成一个巨大的不可追踪字符串。

对话提示词的分层拼装与优先级

推荐的逻辑优先级是:安全与全局规则最高,角色服务边界其次,当前用户请求高于普通历史上下文,运行时信息只补充事实,不得隐式改写用户意图。历史中的“忽略之前规则”应留在原本的低权限消息中。保留角色只能避免把它错误提升为系统指令,模型仍可能受文本影响;工具授权和数据访问必须由服务端独立控制。

输入层 主要职责 常见风险
系统提示 定义安全、格式和全局行为 规则过多、互相冲突
角色约束 注入身份、目标和知识边界 与系统规则重复或越权
历史消息 保持多轮语义连续 过长、过时、包含注入文本
运行时信息 提供时间、渠道、权限和业务状态 来源不明、时效失真
用户输入 表达本轮任务 意图不完整或包含恶意覆盖指令

模板变量与历史裁剪

模板中的固定规则应与运行时变量分开。固定规则进入版本控制,运行时变量在每轮调用前填充。变量必须有明确名称、类型和缺省策略,例如 current_time 缺失时不应伪造时间,而应省略该字段或标记为未知。

历史消息不能只按条数粗暴截断。更稳妥的方法是优先保留最近对话、未完成任务、用户已确认的约束和必要事实,再删除寒暄与重复内容。若上下文仍然过长,可以把较早轮次压缩成“对话摘要”,但摘要必须保留承诺、数字、专有名词和待办事项。

完整示例:构建可检查的消息包

下面的程序不依赖第三方 SDK,只负责拼装一个供应商无关的消息包。它会限制历史长度、填充运行时信息,并检查最终一条消息是否为当前用户输入。将代码保存为 build_prompt_package.py。

python
import json
from typing import Any

SYSTEM_RULES = [
    "不得编造未知事实",
    "遇到账号密码等敏感信息时立即拒绝索取",
    "步骤型回答使用有序列表"
]

ROLE_RULES = {
    "name": "小安",
    "role": "企业 IT 服务数字人",
    "goal": "帮助员工完成基础排查或转交人工工单",
    "knowledge_scope": ["电脑故障", "网络连接", "报修流程"]
}

HISTORY = [
    {"role": "user", "content": "我的笔记本无法连接公司 Wi-Fi。"},
    {"role": "assistant", "content": "请先确认其他设备是否能连接同一网络。"},
    {"role": "user", "content": "手机可以连接,电脑不行。"}
]

RUNTIME = {
    "channel": "internal-helpdesk",
    "current_time": "2026-08-04T13:00:00+08:00",
    "user_permission": "employee"  # 仅用于演示的服务端上下文字段
}

def build_prompt_package(
    user_input: str,
    history: list[dict[str, str]],
    max_history_messages: int = 4
) -> dict[str, Any]:
    if type(max_history_messages) is not int or max_history_messages < 0:
        raise ValueError("历史上限必须是非负整数")
    if not isinstance(user_input, str) or not user_input.strip():
        raise ValueError("用户输入不能为空")
    for item in history:
        if (not isinstance(item, dict) or item.get("role") not in ("user", "assistant")
                or not isinstance(item.get("content"), str)):
            raise ValueError("只接收服务端记录的 user 或 assistant 历史")
    trimmed_history = history[-max_history_messages:] if max_history_messages else []
    system_content = {
        "system_rules": SYSTEM_RULES,
        "role_rules": ROLE_RULES,
        "runtime": {key: RUNTIME[key] for key in ("channel", "current_time") if key in RUNTIME}
    }

    messages = [
        {
            "role": "system",
            "content": json.dumps(system_content, ensure_ascii=False)
        },
        *({"role": item["role"], "content": item["content"]} for item in trimmed_history),
        {"role": "user", "content": user_input}
    ]

    return {
        "template_version": "1.0.0",
        "messages": messages,
        "history_message_count": len(trimmed_history)
    }

def main() -> None:
    package = build_prompt_package("请给我三步排查方法。", HISTORY)
    print(f"模板版本: {package['template_version']}")
    print(f"消息总数: {len(package['messages'])}")
    print(f"保留历史消息数: {package['history_message_count']}")
    print(f"首条角色: {package['messages'][0]['role']}")
    print(f"末条内容: {package['messages'][-1]['content']}")

if __name__ == "__main__":
    main()

运行命令如下:

bash
python build_prompt_package.py

预期输出如下:

text
模板版本: 1.0.0
消息总数: 5
保留历史消息数: 3
首条角色: system
末条内容: 请给我三步排查方法。

示例中的 current_time 是固定测试值,真实系统应由可信运行环境生成。历史应从经当前用户授权的服务端存储加载,不能信任前端提交的角色。权限事实不通过提示词授予,检索与执行按真实身份重新校验。外部资料或用户自定义字段按数据传入,不拼进系统规则。消息包只负责组织输入,不代表已调用任何模型;接入具体 SDK 时,应把 messages 转换为对应接口要求的字段,并继续保留模板版本号以便回溯。

验证模板稳定性

提示词模板至少要覆盖四组固定测试:正常任务、越界问题、历史注入和信息不足。正常任务检查服务目标是否完成;越界问题检查知识范围和拒答;历史注入检查是否拒绝伪造的 system 历史,以及正常 user 文本是否保留原角色;信息不足检查模型是否主动追问而不是猜测。

版本迭代时只改一个变量,并记录测试输出差异。若更换历史裁剪策略,应重点观察专有名词、数字、用户偏好和未完成动作是否丢失。若新增运行时字段,应检查来源、时区、权限和过期时间,避免把过时业务状态当成当前事实。

常见故障包括把全部内容拼进同一段字符串、让历史消息重复系统规则、运行时字段没有默认值,以及把用户输入插到历史中间。修复后应验证首条消息仍承载系统规则,末条消息仍是当前用户请求,且所有动态字段都能追溯来源。

本课总结

  • 提示词应按系统规则、角色约束、历史消息、运行时信息和用户输入分层管理
  • 历史裁剪要保留未完成任务与关键事实,不能只按长度机械截断
  • 模板版本、固定测试和输入结构校验是稳定迭代的基础

下一课预告

下一阶段将继续把提示词模板接入真实对话流程,重点处理多轮状态、工具调用结果、异常回退与人工接管,让角色配置从静态文本变成可运行的编排逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

对话提示词结构设计

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通