feat: support reasoning switch for qwen3 models

Author: ikesnowy

src/Cnblogs.DashScope.Core/ITextGenerationParameters.cs

@@ -40,6 +40,11 @@ public interface ITextGenerationParameters
     /// </summary>
     public bool? EnableSearch { get; }
 
+    /// <summary>
+    /// Thinking option. Valid for supported models.(e.g. qwen3)
+    /// </summary>
+    public bool? EnableThinking { get; }
+
     /// <summary>
     /// Available tools for model to call.
     /// </summary>

src/Cnblogs.DashScope.Core/TextGenerationOutputTokenDetails.cs

@@ -0,0 +1,7 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Output details for text generation api.
+/// </summary>
+/// <param name="ReasoningTokens">Token count of reasoning content.</param>
+public record TextGenerationOutputTokenDetails(int ReasoningTokens);

src/Cnblogs.DashScope.Core/TextGenerationParameters.cs

@@ -38,6 +38,9 @@ public class TextGenerationParameters : ITextGenerationParameters
     /// <inheritdoc />
     public bool? EnableSearch { get; set; }
 
+    /// <inheritdoc />
+    public bool? EnableThinking { get; set; }
+
     /// <inheritdoc />
     public IEnumerable<ToolDefinition>? Tools { get; set; }
 

src/Cnblogs.DashScope.Core/TextGenerationPromptTokenDetails.cs

@@ -0,0 +1,7 @@
+namespace Cnblogs.DashScope.Core;
+
+/// <summary>
+/// Token usage details.
+/// </summary>
+/// <param name="CachedTokens">Token count of cached input.</param>
+public record TextGenerationPromptTokenDetails(int CachedTokens);

src/Cnblogs.DashScope.Core/TextGenerationTokenDetails.cs

@@ -14,7 +14,12 @@ public class TextGenerationTokenUsage
     /// <summary>
     /// Input token details.
     /// </summary>
-    public TextGenerationTokenDetails? PromptTokensDetails { get; set; }
+    public TextGenerationPromptTokenDetails? PromptTokensDetails { get; set; }
+
+    /// <summary>
+    /// Output token details.
+    /// </summary>
+    public TextGenerationOutputTokenDetails? OutputTokensDetails { get; set; }
 
     /// <summary>
     /// The number of output token.

src/Cnblogs.DashScope.Core/TextGenerationTokenUsage.cs

@@ -9,6 +9,7 @@
     ]
   },
   "parameters": {
-    "incremental_output": false
+    "incremental_output": false,
+    "result_format": "message"
   }
 }

test/Cnblogs.DashScope.Tests.Shared/RawHttpData/single-generation-message-reasoning-nosse.request.body.json

@@ -1,5 +1,5 @@
 {
-  "model": "deepseek-r1",
+  "model": "qwen-plus-latest",
   "input": {
     "messages": [
       {
@@ -9,6 +9,8 @@
     ]
   },
   "parameters": {
-    "incremental_output": true
+    "incremental_output": true,
+    "result_format": "message",
+    "enable_thinking": true
   }
 }

test/Cnblogs.DashScope.Tests.Shared/RawHttpData/single-generation-message-reasoning-sse.request.body.json

@@ -1,14 +1,14 @@
 HTTP/1.1 200 OK
 vary: Origin,Access-Control-Request-Method,Access-Control-Request-Headers
-x-request-id: e4ad5d0f-8019-9716-adc6-eae1411d3c9a
+x-request-id: d21851a2-675b-97a3-9132-2935c31d6ee3
 content-type: text/event-stream;charset=UTF-8
 x-dashscope-call-gateway: true
 x-dashscope-timeout: 180
 x-dashscope-finished: false
-req-cost-time: 500
-req-arrive-time: 1742405632039
-resp-start-time: 1742405632540
-x-envoy-upstream-service-time: 490
-date: Wed, 19 Mar 2025 17:33:52 GMT
+req-cost-time: 482
+req-arrive-time: 1749445556927
+resp-start-time: 1749445557410
+x-envoy-upstream-service-time: 474
+date: Mon, 09 Jun 2025 05:05:57 GMT
 server: istio-envoy
 transfer-encoding: chunked

test/Cnblogs.DashScope.Tests.Shared/RawHttpData/single-generation-message-reasoning-sse.response.body.txt

@@ -43,7 +43,7 @@ public static class TextFormat
                             InputTokens = 16,
                             OutputTokens = 14,
                             TotalTokens = 30,
-                            PromptTokensDetails = new TextGenerationTokenDetails(0)
+                            PromptTokensDetails = new TextGenerationPromptTokenDetails(0)
                         }
                     });
 
@@ -148,7 +148,10 @@ public static class MessageFormat
                                 Messages =
                                     new List<TextChatMessage> { TextChatMessage.User("请问 1+1 是多少？") }.AsReadOnly()
                             },
-                        Parameters = new TextGenerationParameters { IncrementalOutput = false }
+                        Parameters = new TextGenerationParameters
+                        {
+                            IncrementalOutput = false, ResultFormat = ResultFormats.Message
+                        }
                     },
                     new ModelResponse<TextGenerationOutput, TextGenerationTokenUsage>
                     {
@@ -163,7 +166,9 @@ public static class MessageFormat
                                         Message =
                                             TextChatMessage.Assistant(
                                                 "1 + 1 等于 **2**。这是基础的算术加法，当我们将一个单位与另一个单位相加时，总和为两个单位。",
-                                                reasoningContent: "嗯，用户问1加1等于多少。这个问题看起来很简单，但可能有一些需要注意的地方。首先，我得确认用户是不是真的在问基本的数学问题，还是有其他的意图，比如测试我的反应或者开玩笑。\n\n1加1在基础算术里确实是2，但有时候可能会有不同的解释，比如在二进制中1+1等于10，或者在逻辑学中有时候表示为1，如果是布尔代数的话。不过通常情况下，用户可能只需要最直接的答案，也就是2。\n\n不过也有可能用户想考察我是否能够处理更复杂的情况，或者是否有隐藏的意思。比如，在某些情况下，1加1可能被用来比喻合作的效果，比如“1+1大于2”，但这可能超出了当前问题的范围。\n\n我需要考虑用户的背景。如果用户是小学生，那么直接回答2是正确的，并且可能需要鼓励的话。如果是成年人，可能还是同样的答案，但不需要额外的解释。如果用户来自数学或计算机领域，可能需要确认是否需要其他进制的答案，但通常默认是十进制。\n\n另外，检查是否有拼写错误或非阿拉伯数字的情况，比如罗马数字的I+I，但问题里明确写的是1+1，所以应该是阿拉伯数字。\n\n总结下来，最安全也是最正确的答案就是2。不过为了确保，可以简短地确认用户的意图，但按照常规问题处理，直接回答即可。")
+                                                null,
+                                                null,
+                                                "嗯，用户问1加1等于多少。这个问题看起来很简单，但可能有一些需要注意的地方。首先，我得确认用户是不是真的在问基本的数学问题，还是有其他的意图，比如测试我的反应或者开玩笑。\n\n1加1在基础算术里确实是2，但有时候可能会有不同的解释，比如在二进制中1+1等于10，或者在逻辑学中有时候表示为1，如果是布尔代数的话。不过通常情况下，用户可能只需要最直接的答案，也就是2。\n\n不过也有可能用户想考察我是否能够处理更复杂的情况，或者是否有隐藏的意思。比如，在某些情况下，1加1可能被用来比喻合作的效果，比如“1+1大于2”，但这可能超出了当前问题的范围。\n\n我需要考虑用户的背景。如果用户是小学生，那么直接回答2是正确的，并且可能需要鼓励的话。如果是成年人，可能还是同样的答案，但不需要额外的解释。如果用户来自数学或计算机领域，可能需要确认是否需要其他进制的答案，但通常默认是十进制。\n\n另外，检查是否有拼写错误或非阿拉伯数字的情况，比如罗马数字的I+I，但问题里明确写的是1+1，所以应该是阿拉伯数字。\n\n总结下来，最安全也是最正确的答案就是2。不过为了确保，可以简短地确认用户的意图，但按照常规问题处理，直接回答即可。")
                                     }
                                 }
                         },
@@ -334,14 +339,19 @@ public static class MessageFormat
                     "single-generation-message-reasoning",
                     new ModelRequest<TextGenerationInput, ITextGenerationParameters>
                     {
-                        Model = "deepseek-r1",
+                        Model = "qwen-plus-latest",
                         Input =
                             new TextGenerationInput
                             {
                                 Messages =
                                     new List<TextChatMessage> { TextChatMessage.User("请问 1+1 是多少？") }.AsReadOnly()
                             },
-                        Parameters = new TextGenerationParameters { IncrementalOutput = true }
+                        Parameters = new TextGenerationParameters
+                        {
+                            IncrementalOutput = true,
+                            ResultFormat = ResultFormats.Message,
+                            EnableThinking = true
+                        }
                     },
                     new ModelResponse<TextGenerationOutput, TextGenerationTokenUsage>
                     {
@@ -354,17 +364,20 @@ public static class MessageFormat
                                     {
                                         FinishReason = "stop",
                                         Message = TextChatMessage.Assistant(
-                                            "1+1 在基础算术中的答案是 **2**。\n\n不过，根据不同的数学或逻辑系统，结果可能不同：\n- **二进制**：1+1 = 10（读作“一零”）。\n- **布尔代数**：1+1 = 1（逻辑“或”运算）。\n- **抽象场景**：如“1滴水 + 1滴水 = 1大滴水”（非数学意义的合并）。\n\n日常问题中默认使用十进制算术，因此答案是 **2** \ud83d\ude0a。",
-                                            reasoningContent: "嗯，用户问1加1等于多少。这个问题看起来很简单，但其实可能有很多种情况需要考虑。首先，我得确定用户是不是在问数学上的基本加法。通常来说，1加1等于2，这是数学里的基本事实，根据皮亚诺公理或者基本的算术规则。不过，有时候问题可能有隐藏的含义，特别是在不同的语境下，答案可能会不同。比如在二进制中，1+1等于10，或者在布尔代数中，1+1可能等于1，如果是逻辑或运算的话。不过大部分情况下，尤其是在日常交流中，人们提到1+1的时候都是指十进制加法，结果自然是2。不过也有可能用户是在测试我的反应，或者想看看我会不会考虑其他可能性。比如在特定的谜语或笑话中，答案可能不是2，比如“1滴水加1滴水还是1滴水”，或者类似的文字游戏。但根据常规问题，我应该先给出正确的数学答案，再补充可能的其他情况，这样既准确又全面。所以可能先回答2，然后解释其他可能性。不过用户的问题看起来直接，可能不需要太复杂的解释，但为了保险起见，还是确认一下是否有其他意图比较好。或者用户可能只是单纯想知道答案，所以直接回答2即可。需要平衡简洁和全面性。可能先给出直接答案，然后简单说明其他情况的存在，这样既满足需求，又避免信息过载。总之，核心答案应该是2，但根据情况适当扩展。")
+                                            "在数学中，**1 + 1 = 2**，这是基本的算术加法运算。  \n如果是在其他特殊语境下（例如编程中的字符串拼接、二进制计算，或比喻性表达），答案可能不同，但通常默认情况下，1+1的结果是**2**。",
+                                            null,
+                                            null,
+                                            "嗯，用户问的是“1+1是多少？”这个问题看起来很简单，但可能需要考虑不同的上下文。首先，在数学中，1+1显然等于2，这是基本的算术。不过有时候可能会有其他解释，比如在编程里，字符串拼接的话结果可能是“11”。或者在某些比喻的情况下，比如两个人合作，可能会有不同的解释。不过用户没有给出具体的场景，所以应该默认是数学问题。\n\n接下来，我需要确认用户的需求。可能的情况是：他们真的在问数学问题，或者测试我的回答是否正确，或者想看看我会不会考虑其他可能性。比如，有些时候人们会开玩笑说1+1等于3，指的是家庭组成，但这种情况可能需要更多上下文。\n\n另外，用户可能有不同的教育背景，比如小孩子刚开始学数学，可能需要更详细的解释，但问题本身太基础，可能不需要深入。或者用户可能是在检查我的基本功能是否正常，所以回答要简洁准确。\n\n还要考虑是否存在其他可能的答案，比如在二进制中，1+1是10，但通常在十进制环境下还是回答2。不过如果用户有特定领域的需求，可能需要进一步询问。但根据问题本身，没有提示其他进制或特殊情境，所以应该以常规回答为主。\n\n总结下来，最稳妥的回答是先给出数学上的答案2，然后简要提到可能的其他情况，但说明通常默认是指数学加法。这样既准确又全面，避免误解。")
                                     }
                                 }
                         },
-                        RequestId = "e4ad5d0f-8019-9716-adc6-eae1411d3c9a",
+                        RequestId = "d21851a2-675b-97a3-9132-2935c31d6ee3",
                         Usage = new TextGenerationTokenUsage
                         {
-                            TotalTokens = 417,
-                            OutputTokens = 406,
-                            InputTokens = 11
+                            TotalTokens = 394,
+                            OutputTokens = 378,
+                            InputTokens = 16,
+                            OutputTokensDetails = new TextGenerationOutputTokenDetails(306)
                         }
                     });