> ## Documentation Index
> Fetch the complete documentation index at: https://blog.pig4cloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QwQ-32B 高效推理大模型

## 概述

QwQ-32B 是阿里巴巴 Qwen 团队基于 Qwen2.5 架构研发的先进大语言模型，专为高性能推理任务设计。本文档介绍 QwQ-32B 的核心技术特性、性能优势及应用实践，帮助开发者快速了解并应用这一前沿模型。

## 技术架构

QwQ-32B 采用纯解码器（Decoder-Only）的 Transformer 架构，具备以下核心特点：

* **参数规模**：320亿参数，平衡了模型能力与资源需求
* **强化学习优化**：通过 RL 技术进行训练，采用奖励机制引导模型决策优化
* **高效设计**：在保持参数效率的同时实现性能突破

## 性能表现

<div align="center">
  <img src="https://minio.pigx.vip/oss/202503/1741268511.png" alt="QwQ-32B 性能对比图" width="800" />
</div>

根据阿里巴巴官方基准测试数据（X平台及技术白皮书），QwQ-32B 在多项核心能力指标上均展现领先优势：

| 能力维度 | 评测基准          | QwQ-32B   | DeepSeek-R1 | 性能优势  |
| ---- | ------------- | --------- | ----------- | ----- |
| 数学推理 | AIME24        | **79.74** | 79.13       | +0.61 |
| 代码生成 | LiveCodeBench | **73.54** | 72.91       | +0.63 |
| 综合推理 | LiveBench     | **82.1**  | 81.3        | +0.8  |
| 指令跟随 | IFEval        | **85.6**  | 84.9        | +0.7  |
| 安全合规 | BFCI          | **92.4**  | 91.8        | +0.6  |

## 资源效率突破

QwQ-32B 在保持高性能的同时，实现了显著的资源效率突破：

* **DeepSeek-R1**：需要超过 1,500 GB 的 vRAM 才能运行（16 块 Nvidia A100 GPU）
* **QwQ-32B**：仅需 24 GB 的 vRAM，可在单 GPU（如 Nvidia H100）上运行

这一突破性进展使 QwQ-32B 能够在消费级硬件上高效部署，大幅降低了应用门槛和运营成本。

## 快速上手指南

### Ollama 环境部署

QwQ-32B 模型已正式登陆 Ollama 模型库，开发者可通过以下步骤快速体验：

```bash theme={null}
# 查看可用模型列表
$ ollama ls
NAME        ID             SIZE    MODIFIED
qwq:latest  cc1091b0e276   19 GB   17 minutes ago

# 启动模型交互
$ ollama run qwq:latest
>>> 请用java实现快速排序算法
```

### Java 应用集成

通过兼容 QwQ 的 deepseek4j 库，可轻松将模型能力集成到 Java 应用中：

#### Maven 依赖配置

```xml theme={null}
<dependency>
  <groupId>io.github.pig-mesh.ai</groupId>
  <artifactId>deepseek-spring-boot-starter</artifactId>
  <version>1.4.5</version>
</dependency>
```

#### 应用配置

```yaml theme={null}
deepseek:
  base-url: http://127.0.0.1:11434/v1
  model: qwq:latest
  api-key: local-key
```

#### 基础调用示例

```java theme={null}
@Autowired
private DeepSeekClient deepSeekClient;

@GetMapping(value = "/chat", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
public Flux<ChatCompletionResponse> chat(String prompt) {
    return deepSeekClient.chatFluxCompletion(prompt);
}
```

<div align="center">
  <img src="https://minio.pigx.vip/oss/202503/1741269045.png" alt="Java 集成效果" width="800" />
</div>

## 函数调用能力

QwQ-32B 作为专注推理的大模型，令人振奋地支持 Function Calling 能力（该特性在 DeepSeek-R1 中尚未实现）。这使模型能够主动调用外部工具进行逻辑推演，大幅拓展了 AI 推理的应用边界。

<div align="center">
  <img src="https://minio.pigx.vip/oss/202503/1741269399.png" alt="Function Calling 示例" width="800" />
</div>

### 天气查询示例

以下代码演示了如何让 QwQ-32B 模型调用天气查询工具函数：

```java theme={null}
@GetMapping(value = "/chat", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
public Flux<ChatCompletionResponse> chat(String prompt) {
    // 定义天气查询函数
    Function WEATHER_FUNCTION = Function.builder()
            .name("get_current_weather")
            .description("Get the current weather in a given location")
            .parameters(JsonObjectSchema.builder()
                    .properties(new LinkedHashMap<String, JsonSchemaElement>() {{
                        put("location", JsonStringSchema.builder()
                                .description("The city name")
                                .build());
                    }})
                    .required(asList("location", "unit"))
                    .build())
            .build();

    // 将 Function 转换为 Tool
    Tool WEATHER_TOOL = Tool.from(WEATHER_FUNCTION);

    // 创建请求
    ChatCompletionRequest request = ChatCompletionRequest.builder()
            .model("Qwen/QwQ-32B")  // 指定模型
            .addUserMessage(prompt)
            .tools(WEATHER_TOOL)    // 添加工具函数
            .build();

    // 发送请求并获取响应
    ChatCompletionResponse response = deepSeekClient.chatCompletion(request).execute();

    // 获取工具调用信息
    AssistantMessage assistantMessage = response.choices().get(0).message();
    ToolCall toolCall = assistantMessage.toolCalls().get(0);

    // 解析函数调用参数
    FunctionCall functionCall = toolCall.function();
    String arguments = functionCall.arguments();  // 例如: {"location": "北京"}

    // 执行函数获取结果
    Map map = Json.fromJson(arguments, Map.class);
    String weatherResult = map.get("location") + "气温 20°";

    // 创建工具消息
    ToolMessage toolMessage = ToolMessage.from(toolCall.id(), weatherResult);

    // 继续对话
    ChatCompletionRequest followUpRequest = ChatCompletionRequest.builder()
            .model("Qwen/QwQ-32B")
            .messages(
                    UserMessage.from(prompt),
                    assistantMessage,
                    toolMessage  // 添加工具消息
            )
            .build();

    return deepSeekClient.chatFluxCompletion(followUpRequest);
}
```

## 总结

QwQ-32B 作为阿里巴巴 Qwen 团队的最新推理型大模型，在多项关键指标上全面超越 DeepSeek R1 的 671 能力基准。同时，QwQ-32B 创新性地支持 Function Calling 能力，将模型从单纯的语言生成工具提升为可与外部系统交互的智能助手，为开发者提供了构建复杂 AI 应用的强大基础。

您现在可以通过 PIG AI 的深度推理模块快速体验 QwQ-32B 模型。PIG AI 让您无需复杂配置即可体验 QwQ-32B 的强大能力。QwQ 模型的推理速度非常出色，响应几乎实时，快 快 快 ！！

<img src="https://minio.pigx.vip/oss/202503/1741270591.png" alt="1741270591" />
