Prompt 管理
Prompt 管理页面用于管理系统的 AI 提示词模板。通过该页面可以查看、新增、编辑和恢复 Prompt，优化面试训练效果。Prompt 是 CueMate 与大语言模型交互的核心，定义了 AI 的行为和响应方式。
1. 进入 Prompt 管理
1.1 打开 Prompt 管理页面
点击顶部下拉列表菜单中的"Prompt 管理"，进入 Prompt 管理页面。
2. 查看 Prompt 列表
2.1 列表字段说明
Prompt 列表以表格形式展示，包含以下字段：
序号:
- 当前页中的序号
- 自动计算，从 1 开始递增
ID:
- Prompt 的唯一标识符
- 以蓝色等宽字体显示
- 通常使用驼峰命名法
- 示例：InitPrompt、AnswerPrompt、ResumeOptimizationPrompt
描述:
- Prompt 的简要说明
- 描述该 Prompt 的用途和功能
- 帮助快速了解 Prompt 的作用
来源:
- 标识 Prompt 的使用场景
- 用不同颜色的标签显示：
- Desktop：紫色标签，表示桌面客户端使用的 Prompt
- Web：绿色标签，表示 Web 端使用的 Prompt
变量:
- 显示 Prompt 中使用的模板变量
- 以灰色背景的等宽字体显示
- 示例：jobPosition.title、resume.content
- 这些变量在运行时会被实际值替换
操作:
- 编辑：打开编辑侧拉弹框修改 Prompt 内容
- 恢复：查看和恢复 Prompt 的历史版本
- 删除：删除该 Prompt（当前禁用，系统 Prompt 不可删除）
2.2 分页功能
列表底部提供分页控件：
功能说明:
- 显示当前页码和总页数
- 显示总记录数
- 每页显示数量可选：10、20、50、100 条
- 切换页码查看更多 Prompt
3. 筛选 Prompt
3.1 来源筛选
使用"来源"下拉框筛选不同来源的 Prompt。
筛选选项:
- 全部：显示所有 Prompt
- Desktop：仅显示桌面客户端使用的 Prompt
- Web：仅显示 Web 端使用的 Prompt
使用场景:
- 查看特定平台的 Prompt
- 优化特定场景的提示词
- 分析不同平台的 Prompt 配置
4. 新增 Prompt
4.1 打开新增侧拉弹框
点击页面右上角的"新增"按钮，打开新增 Prompt 侧拉弹框。
弹框特性:
- 右侧侧拉弹框，占屏幕宽度 60%
- 提供完整的 Prompt 配置表单
- 支持模板变量定义
4.2 填写 Prompt 信息
Prompt ID（必填）:
- 输入 Prompt 的唯一标识符
- 必须唯一，不能与现有 Prompt 重复
- 建议使用驼峰命名法
- 示例：InitPrompt、AnswerPrompt、CustomPrompt
- 以等宽字体显示
描述（选填）:
- 简要描述这个 Prompt 的用途
- 帮助其他用户理解 Prompt 的功能
- 示例："用于初始化面试对话"、"生成答案要点"
来源（必填）:
- 选择 Prompt 的使用场景
- Desktop：桌面客户端使用
- Web：Web 端使用
Prompt 内容（必填）:
- 输入 Prompt 的实际内容
- 支持最多 10,000 字符
- 显示字符计数
- 以等宽字体显示，便于编辑
- 支持多行文本
- 可以包含模板变量
4.3 模板变量使用
变量格式:
- 使用
${variableName}格式定义变量 - 示例：
${jobPosition.title}、${resume.content} - 变量在运行时会被实际值替换
变量使用说明:
- 使用
${variableName}格式定义变量 - 例如：
${jobPosition.title}、${resume.content} - 保存后变量会自动被识别和保护
常用变量示例:
${jobPosition.title}- 岗位标题${jobPosition.description}- 岗位描述${resume.content}- 简历内容${question.text}- 问题文本${context}- 上下文信息
4.4 保存 Prompt
点击"保存"按钮创建 Prompt：
保存流程:
- 填写必填字段（ID、来源、内容）
- 点击"保存"按钮
- 显示全屏加载提示："正在保存，请稍候..."
- 保存成功后显示"Prompt 创建成功"提示
- 关闭侧拉弹框
- 列表自动刷新，显示新创建的 Prompt
注意事项:
- ID 和内容为必填项，不填写时保存按钮禁用
- ID 必须唯一，重复会导致保存失败
- 保存后列表会跳转到第 1 页
5. 编辑 Prompt
5.1 打开编辑侧拉弹框
点击 Prompt 列表中的"编辑"按钮，打开编辑 Prompt 侧拉弹框。
弹框特性:
- 右侧侧拉弹框，占屏幕宽度 60%
- 显示 Prompt 的完整信息
- 支持内容编辑和 Extra 配置
5.2 查看基本信息
弹框顶部显示 Prompt 的基本信息：
只读信息:
- ID：Prompt 的唯一标识符（蓝色等宽字体）
- 描述：Prompt 的功能说明
- 来源：Desktop 或 Web（带颜色标签）
5.3 模板变量保护
如果 Prompt 包含模板变量，会显示变量保护提示：
变量列表:
- 显示所有模板变量及其编号
- 每个变量以橙色标签形式展示
- 格式：[变量 N] $
- 示例：[变量 1] $
编辑保护机制:
- 编辑时变量会显示为
[变量 N:不可修改] - 保存时自动将占位符替换回原始变量
- 防止误修改或删除重要变量
- 确保 Prompt 的功能完整性
5.4 编辑 Prompt 内容
内容编辑区:
- 大文本输入框，支持 20 行显示
- 以等宽字体显示，便于编辑
- 支持最多 10,000 字符
- 显示字符计数
- 变量显示为占位符，保存时自动恢复
编辑提示:
- 变量会显示为
[变量 N:不可修改] - 可以修改变量之外的所有内容
- 保存时系统会自动恢复变量
5.5 Extra 配置
Extra 配置说明:
- 选填字段，用于存储额外的配置参数
- 必须是 JSON 格式
- 支持最多 1,000 字符
- 以等宽字体显示
使用场景:
- 存储面试问题数量：
{"totalQuestions": 10} - 配置答案长度：
{"maxLength": 500} - 定义输出格式：
{"format": "markdown"} - 其他自定义配置参数
5.6 查看历史版本
如果 Prompt 有历史版本，会显示上一版本的内容：
历史内容展示:
- 只读显示区域
- 以等宽字体显示
- 最大高度 160px，超出可滚动
- 仅供参考，不可编辑
使用场景:
- 对比修改前后的差异
- 参考之前的 Prompt 内容
- 评估修改的影响
5.7 重置和保存
重置按钮:
- 恢复为打开弹框时的初始内容
- 包括 Prompt 内容和 Extra 配置
- 点击后显示"已重置为初始内容"提示
保存按钮:
- 保存修改后的 Prompt
- 显示全屏加载提示："正在保存，请稍候..."
- 保存成功后显示"Prompt 更新成功"提示
- 关闭侧拉弹框
- 列表自动刷新
6. 恢复 Prompt
6.1 打开恢复侧拉弹框
点击 Prompt 列表中的"恢复"按钮，打开恢复 Prompt 侧拉弹框。
恢复功能说明:
- 查看 Prompt 的历史版本
- 对比当前版本和历史版本
- 恢复到之前的版本
- 撤销不当的修改
使用场景:
- 修改后发现效果变差，需要恢复
- 对比不同版本的差异
- 学习优化思路
7. 刷新列表
7.1 手动刷新
点击页面右上角的"刷新"按钮，手动刷新 Prompt 列表。
刷新功能:
- 重新获取最新的 Prompt 列表
- 刷新时按钮图标会旋转
- 刷新完成后列表自动更新
- 保持当前的筛选条件
使用场景:
- 查看其他用户的修改
- 确认新增的 Prompt
- 验证编辑是否成功
8. Prompt 模板变量详解
8.1 变量格式
标准格式:
${variableName}- 简单变量${object.property}- 对象属性${array[0]}- 数组元素（如果支持）
命名规范:
- 使用驼峰命名法
- 避免特殊字符
- 保持语义清晰
8.2 常用变量列表
岗位相关:
${jobPosition.title}- 岗位标题${jobPosition.description}- 岗位描述${jobPosition.requirements}- 岗位要求${jobPosition.company}- 公司名称
简历相关:
${resume.content}- 简历完整内容${resume.name}- 候选人姓名${resume.skills}- 技能列表${resume.experience}- 工作经验
面试相关:
${question.text}- 问题文本${question.type}- 问题类型${context}- 上下文信息${history}- 对话历史
8.3 变量使用示例
示例 1：初始化 Prompt
你是一位专业的 ${jobPosition.title} 面试助手。
候选人的简历如下：
${resume.content}
请根据简历内容，准备面试问题。示例 2：答案生成 Prompt
面试问题：${question.text}
根据候选人的简历：
${resume.content}
请生成专业的答案要点，要求：
1. 结合候选人的实际经验
2. 体现对 ${jobPosition.title} 的理解
3. 突出相关技能和项目经验示例 3：简历优化 Prompt
请优化以下简历，使其更符合 ${jobPosition.title} 岗位要求。
原始简历：
${resume.content}
岗位要求：
${jobPosition.requirements}
优化建议：
1. 突出相关技能
2. 量化工作成果
3. 调整语言表达9. Prompt 优化技巧
9.1 清晰的角色定位
推荐做法:
- 明确定义 AI 的角色
- 说明期望的行为方式
- 设定输出格式和风格
示例:
你是一位经验丰富的技术面试官，擅长评估候选人的技术能力和项目经验。
请以专业、客观的态度分析候选人的回答。9.2 具体的任务描述
推荐做法:
- 明确说明要完成的任务
- 列出具体的要求和限制
- 提供必要的上下文信息
示例:
任务：根据候选人的简历生成 5 个面试问题
要求：
1. 问题要与候选人的项目经验相关
2. 难度适中，既考察基础也考察深度
3. 覆盖不同的技术领域9.3 结构化输出
推荐做法:
- 使用编号列表
- 使用 Markdown 格式
- 分段组织内容
示例:
请按以下格式输出：
## 答案要点
1. 核心观点
2. 支持论据
3. 实例说明
## 注意事项
- 避免的陷阱
- 加分项9.4 Token 优化
优化建议:
- 精简冗余描述
- 避免重复信息
- 控制输出长度
- 使用简洁的表达
对比示例:
不推荐（冗长）:
请你作为一个非常专业的、经验非常丰富的、对技术有深刻理解的面试官...
推荐（简洁）:
你是一位资深技术面试官，请评估候选人的技术能力。10. 常见问题
10.1 保存失败
问题：点击"保存"按钮，提示保存失败。
解决方案:
- 检查 ID 是否唯一（新增时）
- 检查必填字段是否填写完整
- 检查 Extra 配置是否为有效的 JSON 格式
- 检查内容长度是否超过限制
- 查看浏览器控制台错误信息
10.2 变量丢失
问题：编辑 Prompt 后，模板变量丢失。
解决方案:
- 不要删除
[变量 N:不可修改]占位符 - 如果误删，点击"重置"按钮恢复
- 保存前检查所有变量是否完整
- 如果已保存，使用"恢复"功能恢复之前版本
10.3 筛选无结果
问题：选择来源筛选后，列表为空。
解决方案:
- 确认该来源确实有 Prompt
- 尝试选择"全部"查看所有 Prompt
- 点击"刷新"按钮更新列表
- 检查网络连接是否正常
10.4 恢复功能无效
问题：点击"恢复"按钮，没有历史版本可恢复。
解决方案:
- 该 Prompt 可能从未被修改过
- 历史版本可能已被清理
- 只有编辑过的 Prompt 才有历史版本
- 查看详情确认是否有 history_pre 字段
11. 最佳实践
11.1 版本管理
建议做法:
- 重大修改前先测试效果
- 记录修改原因和预期效果
- 定期检查 Prompt 性能
- 保留关键版本的备份
11.2 协作规范
建议规范:
- 使用清晰的描述说明 Prompt 用途
- 修改前查看历史版本了解背景
- 测试修改后的效果再保存
- 重大修改前与团队沟通
11.3 性能优化
优化建议:
- 定期审查 Prompt 的有效性
- 删除未使用的 Prompt
- 优化 Token 使用
- A/B 测试不同版本的效果
11.4 安全注意
安全建议:
- 不要在 Prompt 中硬编码敏感信息
- 使用变量替代具体值
- 定期检查 Prompt 是否泄露信息
- 控制 Prompt 的访问权限
12. Prompt 应用场景
12.1 桌面客户端场景
InitPrompt:
- 初始化面试对话
- 设定 AI 角色和行为
- 加载候选人信息
AnswerPrompt:
- 生成面试问题的答案要点
- 结合简历和岗位要求
- 提供专业建议
12.2 Web 端场景
ResumeOptimizationPrompt:
- 优化简历内容
- 匹配岗位要求
- 提供修改建议
QuestionGenerationPrompt:
- 根据岗位生成面试问题
- 覆盖不同技术领域
- 难度分级