mirror of
https://github.com/linshenkx/prompt-optimizer.git
synced 2026-05-07 22:18:23 +08:00
148 lines
5.3 KiB
Markdown
148 lines
5.3 KiB
Markdown
# 上下文模式（Context Mode）使用指南
|
||
|
||
本文档解释 Prompt Optimizer 的「上下文模式」怎么用、什么时候用、以及常见踩坑。
|
||
|
||
上下文模式在界面上对应顶部功能模式里的「上下文」，并提供两个子模式：
|
||
|
||
- 多消息（Multi-message）：面向多轮对话/多条消息的“消息级优化”
|
||
- 变量（Variable）：面向单条用户提示词的“变量与工具驱动优化”
|
||
|
||
## 1. 一句话理解：上下文模式解决什么问题？
|
||
|
||
当你发现“单条提示词优化”不够稳定时，往往缺的是上下文信息（前置约束、示例、工具可用性、变量值等）。
|
||
|
||
上下文模式的核心价值是：
|
||
|
||
- 在优化时，把你配置的「对话消息 / 变量 / 工具」一并作为上下文交给模型
|
||
- 让优化结果更贴合真实运行环境（而不是只看一段孤立文字）
|
||
|
||
## 2. 先选对模式：多消息 vs 变量
|
||
|
||
用下面这张表快速判断：
|
||
|
||
| 你现在要做的事 | 推荐子模式 |
|
||
| --- | --- |
|
||
| 你在做角色扮演/多轮对话，想优化某一条 system/user 消息，让风格与上下文一致 | 多消息 |
|
||
| 你在写“一条用户提示词”，但里面有大量可复用参数（如人名、日期、规格、输出格式），想用 {{var}} 管理与测试 | 变量 |
|
||
| 你想配置/管理工具（Function Calling），并在测试时验证工具调用行为 | 变量（更匹配 UI 行为） |
|
||
|
||
提示：两种子模式都支持右侧“测试区”用多列对比跑不同变量/不同版本。
|
||
|
||
## 3. 多消息（Multi-message）快速上手
|
||
|
||
适合：优化对话中的某一条 system/user 消息（不是让模型回答）。
|
||
|
||
### Step 0：进入多消息模式
|
||
|
||
1. 顶部功能模式选择「上下文」
|
||
2. 子模式选择「多消息」
|
||
|
||
### Step 1：准备对话上下文
|
||
|
||
在左侧的会话管理区域添加/编辑消息：
|
||
|
||
- system/user/assistant/tool 都可以存在于上下文中
|
||
- 但“可被优化的目标”通常是 system 或 user 消息
|
||
|
||
### Step 2：选中你要优化的那条消息
|
||
|
||
关键点：必须选中一条 system/user 消息，否则“优化”按钮会不可用。
|
||
|
||
### Step 3：选择模型与模板
|
||
|
||
推荐先从内置模板开始：
|
||
|
||
- 通用消息优化（推荐）：适用于绝大多数对话场景
|
||
|
||
它的核心规则是：
|
||
|
||
- 优化 != 回复（只改写那条消息本身）
|
||
- 保持原消息角色不变（system 还是 system、user 还是 user）
|
||
- 保留所有 {{变量占位符}} 原样
|
||
|
||
### Step 4：点击“优化”并理解 V0/V1
|
||
|
||
多消息模式的优化是“消息级版本链”：
|
||
|
||
- V0：原始内容（首次创建时保存，用于回退）
|
||
- V1：优化后的内容（默认会应用回对话）
|
||
|
||
如果你觉得“优化后反而变差”，正确做法是：
|
||
|
||
- 切换版本回到 V0 或其它版本（而不是手动复制粘贴回退）
|
||
|
||
### Step 5：用右侧测试区验证效果
|
||
|
||
建议把测试当成“验收步骤”：
|
||
|
||
1. 在测试区填变量（如果对话中用到了 {{var}}）
|
||
2. 运行测试（可以用多列对比不同变量组合/不同版本）
|
||
3. 看输出是否满足你期望的格式、语气和约束
|
||
|
||
## 4. 变量（Variable）快速上手
|
||
|
||
适合：优化“一条用户提示词”，并把其中的可变信息抽成变量，方便复用与测试。
|
||
|
||
### Step 0：进入变量模式
|
||
|
||
1. 顶部功能模式选择「上下文」
|
||
2. 子模式选择「变量」
|
||
|
||
### Step 1：用 {{var}} 写提示词
|
||
|
||
你可以把可复用参数写成双花括号变量，例如：
|
||
|
||
```text
|
||
请你根据 {{product_name}} 的需求，输出一份 {{output_format}} 格式的方案。
|
||
约束：预算 {{budget}}，交付时间 {{deadline}}。
|
||
```
|
||
|
||
小技巧：输入 `{{}}` 通常可以触发变量自动补全。
|
||
|
||
### Step 2：管理变量值（让测试可复现）
|
||
|
||
变量模式会提示缺失变量，并提供预览：
|
||
|
||
- 缺失变量：先补齐变量值，再看优化/测试结果
|
||
- 预览：确认最终渲染出来的提示词是否符合预期（占位符是否被正确替换）
|
||
|
||
### Step 3：可选：配置工具（Function Calling）
|
||
|
||
如果你希望提示词在“可调用工具”的环境运行：
|
||
|
||
1. 在工具管理里维护工具定义（名称、描述、参数等）
|
||
2. 在测试时验证模型是否会按预期触发工具
|
||
|
||
### Step 4：选择模板并开始优化
|
||
|
||
变量模式对应的模板通常会强调：
|
||
|
||
- 在上下文/工具约束下，把原始用户提示词改写得更明确、可执行、可验证
|
||
- 必须保留所有 {{var}} 占位符
|
||
|
||
推荐先从“上下文版·用户提示词基础优化”开始。
|
||
|
||
## 5. 常见问题（高频踩坑）
|
||
|
||
### Q1：为什么我感觉“上下文模式”输出像在回答我？
|
||
|
||
多消息模式的推荐模板明确要求“只输出优化后的消息”，不是生成回复。
|
||
如果你换了自定义模板，请检查模板里是否混入了“回答任务”的指令。
|
||
|
||
### Q2：为什么优化按钮是灰的？
|
||
|
||
多消息模式下通常是因为：
|
||
|
||
- 没有选中要优化的 system/user 消息
|
||
- 没选模型或没选模板
|
||
|
||
### Q3：优化后内容直接改了原消息，是 bug 吗？
|
||
|
||
不是。多消息模式默认会把 V1 应用回会话，方便你继续在“真实上下文”里测试。
|
||
如果不满意，应该通过版本切换回到 V0。
|
||
|
||
### Q4：变量没替换/预览里还有 {{var}} 怎么办？
|
||
|
||
说明该变量没有赋值。补齐变量值后再预览或测试。
|
||
|