# 通义千问（Qwen）提示词指南：Alibaba的六段式框架、分隔符与JSON模式

> 依据阿里云百炼（Model Studio）官方的提示词指南和API文档，介绍如何为Qwen3.8 Max、Qwen3.7 Plus和Qwen3.8 Flash编写提示词。

来源：Promptea — https://www.promptea.me/zh/guides/qwen-prompt-guide · 语言：简体中文 · 最后更新：2026-11-14

## Alibaba的建议

- 用六个部分搭建提示词：背景、目标、风格、语气、受众和回复。每一部分都回答一个模型原本只能去猜的问题；任务用不到的部分可以省略。
- “回复”指输出的具体形式：列表、表格、带命名字段的JSON、字数限制等。
- 用###或===这类醒目的标记把各段材料隔开，让边界一目了然。
- 格式重要时就给示例：示例能让模型模仿格式、术语和语气，让回答更一致。对于结构化输出，把格式模板和示例数据搭配使用。

## 会影响提示词的设置

- Qwen3.8 Max、Qwen3.7 Plus和Qwen3.8 Flash默认开启思考模式。需要快速回答时可用enable_thinking关闭，或用thinking_budget设定上限。
- JSON模式：使用response_format json_object时，提示词中必须出现“JSON”一词，否则请求会失败。json_schema配合strict会强制遵循schema。
- 联网搜索是一个参数（enable_search），不是在正文里提出的要求。在Qwen3.8 Max上，该功能在北京和新加坡地域可用。
- 三个模型都支持文本、图片和视频输入，上下文窗口为1M token，长文档也放得下，但要说明其中哪一部分最重要。

## 模板

### 六段式需求说明

```text
### 背景
[模型需要了解的背景信息]
### 目标
[要完成的唯一任务]
### 风格
[例如：客服人员的回复]
### 语气
[例如：亲切、简洁]
### 受众
[谁来读，他们已经知道什么]
### 回复
[确切格式，例如：3个短段落，不超过120字]
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%23%23%23+%E8%83%8C%E6%99%AF%0A%5B%E6%A8%A1%E5%9E%8B%E9%9C%80%E8%A6%81%E4%BA%86%E8%A7%A3%E7%9A%84%E8%83%8C%E6%99%AF%E4%BF%A1%E6%81%AF%5D%0A%23%23%23+%E7%9B%AE%E6%A0%87%0A%5B%E8%A6%81%E5%AE%8C%E6%88%90%E7%9A%84%E5%94%AF%E4%B8%80%E4%BB%BB%E5%8A%A1%5D%0A%23%23%23+%E9%A3%8E%E6%A0%BC%0A%5B%E4%BE%8B%E5%A6%82%EF%BC%9A%E5%AE%A2%E6%9C%8D%E4%BA%BA%E5%91%98%E7%9A%84%E5%9B%9E%E5%A4%8D%5D%0A%23%23%23+%E8%AF%AD%E6%B0%94%0A%5B%E4%BE%8B%E5%A6%82%EF%BC%9A%E4%BA%B2%E5%88%87%E3%80%81%E7%AE%80%E6%B4%81%5D%0A%23%23%23+%E5%8F%97%E4%BC%97%0A%5B%E8%B0%81%E6%9D%A5%E8%AF%BB%EF%BC%8C%E4%BB%96%E4%BB%AC%E5%B7%B2%E7%BB%8F%E7%9F%A5%E9%81%93%E4%BB%80%E4%B9%88%5D%0A%23%23%23+%E5%9B%9E%E5%A4%8D%0A%5B%E7%A1%AE%E5%88%87%E6%A0%BC%E5%BC%8F%EF%BC%8C%E4%BE%8B%E5%A6%82%EF%BC%9A3%E4%B8%AA%E7%9F%AD%E6%AE%B5%E8%90%BD%EF%BC%8C%E4%B8%8D%E8%B6%85%E8%BF%87120%E5%AD%97%5D&purpose=text&target=qwen)

### 带示例的分类

```text
把每张客服工单归类为"billing"、"bug"或"how-to"。返回JSON：[{"id": number, "label": string}]。

示例：
"我被扣了两次费" -> billing
"点导出按钮没有任何反应" -> bug
"怎么添加团队成员？" -> how-to

### 工单
[粘贴工单及其id]
###
```

[在Promptea中打开](https://www.promptea.me/zh/analyzer?prompt=%E6%8A%8A%E6%AF%8F%E5%BC%A0%E5%AE%A2%E6%9C%8D%E5%B7%A5%E5%8D%95%E5%BD%92%E7%B1%BB%E4%B8%BA%22billing%22%E3%80%81%22bug%22%E6%88%96%22how-to%22%E3%80%82%E8%BF%94%E5%9B%9EJSON%EF%BC%9A%5B%7B%22id%22%3A+number%2C+%22label%22%3A+string%7D%5D%E3%80%82%0A%0A%E7%A4%BA%E4%BE%8B%EF%BC%9A%0A%22%E6%88%91%E8%A2%AB%E6%89%A3%E4%BA%86%E4%B8%A4%E6%AC%A1%E8%B4%B9%22+-%3E+billing%0A%22%E7%82%B9%E5%AF%BC%E5%87%BA%E6%8C%89%E9%92%AE%E6%B2%A1%E6%9C%89%E4%BB%BB%E4%BD%95%E5%8F%8D%E5%BA%94%22+-%3E+bug%0A%22%E6%80%8E%E4%B9%88%E6%B7%BB%E5%8A%A0%E5%9B%A2%E9%98%9F%E6%88%90%E5%91%98%EF%BC%9F%22+-%3E+how-to%0A%0A%23%23%23+%E5%B7%A5%E5%8D%95%0A%5B%E7%B2%98%E8%B4%B4%E5%B7%A5%E5%8D%95%E5%8F%8A%E5%85%B6id%5D%0A%23%23%23&purpose=data&target=qwen)

## 常见问题

### 为什么我的JSON模式请求失败了？

使用json_object时，阿里云百炼要求提示词中包含“JSON”一词。把它加上（例如“返回包含以下字段的JSON……”），或者改用json_schema。

### Qwen有专门的代码模型吗？

Alibaba的文档现在建议用最新的通用模型处理编程任务，所以请使用Qwen3.8 Max或Qwen3.7 Plus，并给出清晰的验收标准。
