docs: update sample and README.md for QWen-Long

Author: ikesnowy

README.md

@@ -62,7 +62,7 @@ public class YourService(IDashScopeClient client)
   - Image Synthesis - `CreateWanxImageSynthesisTaskAsync()` and `GetWanxImageSynthesisTaskAsync()`
   - Image Generation - `CreateWanxImageGenerationTaskAsync()` and `GetWanxImageGenerationTaskAsync()`
   - Background Image Generation - `CreateWanxBackgroundGenerationTaskAsync()` and `GetWanxBackgroundGenerationTaskAsync()`
-
+- File API that used by Qwen-Long - `dashScopeClient.UploadFileAsync()` and `dashScopeClient.DeleteFileAsync`
 
 # Examples
 
@@ -163,3 +163,35 @@ Console.WriteLine(completion.Output.Choice[0].Message.Content);
 ```
 
 Append the tool calling result with `tool` role, then model will generate answers based on tool calling result.
+
+
+## QWen-Long with files
+
+Upload file first.
+
+```csharp
+var file = new FileInfo("test.txt");
+var uploadedFile = await dashScopeClient.UploadFileAsync(file.OpenRead(), file.Name);
+```
+
+Using uploaded file id in messages.
+
+```csharp
+var history = new List<ChatMessage>
+{
+    new(uploadedFile.Id),   // use array for multiple files, e.g. [file1.Id, file2.Id]
+    new("user", "Summarize the content of file.")
+}
+var parameters = new TextGenerationParameters()
+{
+    ResultFormat = ResultFormats.Message
+};
+var completion = await client.GetQWenChatCompletionAsync(QWenLlm.QWenLong, history, parameters);
+Console.WriteLine(completion.Output.Choices[0].Message.Content);
+```
+
+Delete file if needed
+
+```csharp
+var deletionResult = await dashScopeClient.DeleteFileAsync(uploadedFile.Id);
+```

README.zh-Hans.md

@@ -62,6 +62,7 @@ public class YourService(IDashScopeClient client)
     - 文生图 - `CreateWanxImageSynthesisTaskAsync()` and `GetWanxImageSynthesisTaskAsync()`
     - 人像风格重绘 - `CreateWanxImageGenerationTaskAsync()` and `GetWanxImageGenerationTaskAsync()`
     - 图像背景生成 - `CreateWanxBackgroundGenerationTaskAsync()` and `GetWanxBackgroundGenerationTaskAsync()`
+- 适用于 QWen-Long 的文件 API `dashScopeClient.UploadFileAsync()` and `dashScopeClient.DeleteFileAsync`
 
 
 # 示例
@@ -159,3 +160,34 @@ Console.WriteLine(completion.Output.Choice[0].Message.Content) // 现在浙江
 ```
 
 当模型认为应当调用工具时，返回消息中 `ToolCalls` 会提供调用的详情，本地在调用完成后可以把结果以 `tool` 角色返回。
+
+## 上传文件（QWen-Long）
+
+需要先提前将文件上传到 DashScope 来获得 Id。
+
+```csharp
+var file = new FileInfo("test.txt");
+var uploadedFile = await dashScopeClient.UploadFileAsync(file.OpenRead(), file.Name);
+```
+
+使用文件 Id 初始化一个消息，内部会转换成 system 角色的一个文件引用。
+
+```csharp
+var history = new List<ChatMessage>
+{
+    new(uploadedFile.Id),   // 多文件情况下可以直接传入文件 Id 数组, 例如：[file1.Id, file2.Id]
+    new("user", "总结一下文件的内容。")
+}
+var parameters = new TextGenerationParameters()
+{
+    ResultFormat = ResultFormats.Message
+};
+var completion = await client.GetQWenChatCompletionAsync(QWenLlm.QWenLong, history, parameters);
+Console.WriteLine(completion.Output.Choices[0].Message.Content);
+```
+
+如果需要，完成对话后可以使用 API 删除之前上传的文件。
+
+```csharp
+var deletionResult = await dashScopeClient.DeleteFileAsync(uploadedFile.Id);
+```

sample/Cnblogs.DashScope.Sample/Cnblogs.DashScope.Sample.csproj

@@ -12,4 +12,10 @@
       <ProjectReference Include="..\..\src\Cnblogs.DashScope.Sdk\Cnblogs.DashScope.Sdk.csproj" />
     </ItemGroup>
 
+    <ItemGroup>
+      <None Update="test.txt">
+        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+      </None>
+    </ItemGroup>
+
 </Project>

sample/Cnblogs.DashScope.Sample/Program.cs

@@ -39,6 +39,9 @@
     case SampleType.ChatCompletionWithTool:
         await ChatWithToolsAsync();
         break;
+    case SampleType.ChatCompletionWithFiles:
+        await ChatWithFilesAsync();
+        break;
 }
 
 return;
@@ -97,6 +100,49 @@ async Task ChatStreamAsync()
     // ReSharper disable once FunctionNeverReturns
 }
 
+async Task ChatWithFilesAsync()
+{
+    var history = new List<ChatMessage>();
+    Console.WriteLine("uploading file \"test.txt\" ");
+    var file = new FileInfo("test.txt");
+    var uploadedFile = await dashScopeClient.UploadFileAsync(file.OpenRead(), file.Name);
+    Console.WriteLine("file uploaded, id: " + uploadedFile.Id);
+    Console.WriteLine();
+
+    var fileMessage = new ChatMessage(uploadedFile.Id);
+    history.Add(fileMessage);
+    Console.WriteLine("system > " + fileMessage.Content);
+    var userPrompt = new ChatMessage("user", "该文件的内容是什么");
+    history.Add(userPrompt);
+    Console.WriteLine("user > " + userPrompt.Content);
+    var stream = dashScopeClient.GetQWenChatStreamAsync(
+        QWenLlm.QWenLong,
+        history,
+        new TextGenerationParameters { IncrementalOutput = true, ResultFormat = ResultFormats.Message });
+    var role = string.Empty;
+    var message = new StringBuilder();
+    await foreach (var modelResponse in stream)
+    {
+        var chunk = modelResponse.Output.Choices![0];
+        if (string.IsNullOrEmpty(role) && string.IsNullOrEmpty(chunk.Message.Role) == false)
+        {
+            role = chunk.Message.Role;
+            Console.Write(chunk.Message.Role + " > ");
+        }
+
+        message.Append(chunk.Message.Content);
+        Console.Write(chunk.Message.Content);
+    }
+
+    Console.WriteLine();
+    history.Add(new ChatMessage(role, message.ToString()));
+
+    Console.WriteLine();
+    Console.WriteLine("Deleting file by id: " + uploadedFile.Id);
+    var result = await dashScopeClient.DeleteFileAsync(uploadedFile.Id);
+    Console.WriteLine("Deletion result: " + result.Deleted);
+}
+
 async Task ChatWithToolsAsync()
 {
     var history = new List<ChatMessage>();

sample/Cnblogs.DashScope.Sample/SampleType.cs

@@ -14,5 +14,8 @@ public enum SampleType
     ChatCompletion,
 
     [Description("Conversation with tools")]
-    ChatCompletionWithTool
+    ChatCompletionWithTool,
+
+    [Description("Conversation with files")]
+    ChatCompletionWithFiles
 }

sample/Cnblogs.DashScope.Sample/SampleTypeDescriptor.cs

@@ -10,6 +10,7 @@ public static string GetDescription(this SampleType sampleType)
             SampleType.TextCompletionSse => "Simple prompt completion with incremental output",
             SampleType.ChatCompletion => "Conversation between user and assistant",
             SampleType.ChatCompletionWithTool => "Function call sample",
+            SampleType.ChatCompletionWithFiles => "File upload sample using qwen-long",
             _ => throw new ArgumentOutOfRangeException(nameof(sampleType), sampleType, "Unsupported sample option")
         };
     }

sample/Cnblogs.DashScope.Sample/test.txt

@@ -0,0 +1 @@
+测试内容。