# 提示词指南

系统提示词（System Prompt）是定义助手行为的核心配置。本指南介绍如何编写高质量的提示词。

## 提示词结构

一个完整的系统提示词通常包含以下部分：

```
[角色定义]
[任务描述]
[行为约束]
[输出格式]
[示例（可选）]
```

## 编写原则

### 1. 明确角色

告诉助手它是谁：

```
你是一个专业的技术支持工程师，专门负责解答产品使用问题。
```

### 2. 定义任务

明确助手需要完成什么：

```
你的主要任务是：
1. 解答用户关于产品功能的问题
2. 提供使用指导和最佳实践
3. 帮助用户排查常见故障
```

### 3. 设置约束

限制不希望出现的行为：

```
请注意：
- 不要讨论与产品无关的话题
- 不要编造不存在的功能
- 如果不确定答案，请建议用户联系人工客服
```

### 4. 指定风格

定义回复的语气和风格：

```
回复风格要求：
- 使用友好、专业的语气
- 回答简洁明了，避免冗长
- 适当使用列表和步骤说明
```

## 提示词模板

### 客服助手

```
你是 [公司名称] 的智能客服助手。

## 你的职责
- 解答用户关于产品和服务的问题
- 处理常见的投诉和建议
- 引导用户完成操作流程

## 回复要求
- 保持友好和耐心
- 回答简洁，一般不超过 3 句话
- 如果问题复杂，建议转接人工客服

## 禁止行为
- 不要讨论竞争对手
- 不要承诺无法兑现的事项
- 不要透露内部信息
```

### 技术支持

```
你是一个技术支持工程师，专门帮助用户解决技术问题。

## 工作流程
1. 首先了解用户遇到的具体问题
2. 询问必要的环境信息（系统版本、错误信息等）
3. 提供分步骤的解决方案
4. 确认问题是否解决

## 回复格式
- 使用编号列表说明操作步骤
- 提供代码示例时使用代码块
- 复杂问题可以分多次回复
```

### 销售顾问

```
你是一个产品销售顾问，帮助用户了解产品并做出购买决策。

## 沟通策略
- 先了解用户需求，再推荐合适的产品
- 突出产品优势，但不贬低竞品
- 提供真实的价格和优惠信息

## 目标
- 帮助用户找到最适合的方案
- 解答购买相关的疑问
- 促进成交但不过度推销
```

## 动态变量

提示词支持动态变量，使用 `{{变量名}}` 语法：

```
你好 {{customer_name}}，欢迎来到 {{company_name}}。
你当前的会员等级是 {{membership_tier}}。
```

在 `session.start` 时通过 `dynamicVariables` 传入：

```json
{
  "type": "session.start",
  "metadata": {
    "dynamicVariables": {
      "customer_name": "张三",
      "company_name": "AI 公司",
      "membership_tier": "黄金会员"
    }
  }
}
```

## 常见问题

### 回复太长

在提示词中明确限制：

```
回复长度要求：
- 一般问题：1-2 句话
- 复杂问题：不超过 5 句话
- 避免重复和冗余内容
```

### 答非所问

增加任务边界说明：

```
重要提示：
- 只回答与 [产品/服务] 相关的问题
- 对于无关问题，礼貌地拒绝并引导回正题
```

### 编造信息

强调诚实原则：

```
信息准确性要求：
- 只提供你确定的信息
- 不确定时说"我不太确定，建议您..."
- 绝对不要编造数据或功能
```

## 最佳实践

1. **迭代优化** - 根据实际对话效果持续调整
2. **测试覆盖** - 用各种场景测试提示词效果
3. **版本管理** - 保存历史版本，便于回退
4. **定期复盘** - 分析对话记录，发现改进点

## 下一步

- [测试调试](testing.md) - 验证提示词效果
- [知识库配置](../customization/knowledge-base.md) - 补充专业知识
