chore: import upstream snapshot with attribution

2026-07-13 13:21:23 +08:00
commit b957a53def
5423 changed files with 863745 additions and 0 deletions
@@ -0,0 +1,125 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System.Reflection;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.ChatCompletion;
+using Microsoft.SemanticKernel.Plugins.Core;
+using Microsoft.SemanticKernel.PromptTemplates.Handlebars;
+
+namespace Examples;
+
+/// <summary>
+/// This example demonstrates how to serialize prompts as described at
+/// https://learn.microsoft.com/semantic-kernel/prompts/saving-prompts-as-files
+/// </summary>
+public class SerializingPrompts(ITestOutputHelper output) : LearnBaseTest([
+            "Can you send an approval to the marketing team?",
+    "That is all, thanks."], output)
+{
+    [Fact]
+    public async Task RunAsync()
+    {
+        Console.WriteLine("======== Serializing Prompts ========");
+
+        string? endpoint = TestConfiguration.AzureOpenAI.Endpoint;
+        string? modelId = TestConfiguration.AzureOpenAI.ChatModelId;
+        string? apiKey = TestConfiguration.AzureOpenAI.ApiKey;
+
+        if (endpoint is null || modelId is null || apiKey is null)
+        {
+            Console.WriteLine("Azure OpenAI credentials not found. Skipping example.");
+
+            return;
+        }
+
+        var builder = Kernel.CreateBuilder()
+                            .AddAzureOpenAIChatCompletion(modelId, endpoint, apiKey);
+        builder.Plugins.AddFromType<ConversationSummaryPlugin>();
+        Kernel kernel = builder.Build();
+
+        // Load prompts
+        var prompts = kernel.CreatePluginFromPromptDirectory("./../../../Plugins/Prompts");
+
+        // Load prompt from YAML
+        using StreamReader reader = new(Assembly.GetExecutingAssembly().GetManifestResourceStream("Resources.getIntent.prompt.yaml")!);
+        KernelFunction getIntent = kernel.CreateFunctionFromPromptYaml(
+            await reader.ReadToEndAsync(),
+            promptTemplateFactory: new HandlebarsPromptTemplateFactory()
+        );
+
+        // Create choices
+        List<string> choices = ["ContinueConversation", "EndConversation"];
+
+        // Create few-shot examples
+        List<ChatHistory> fewShotExamples =
+        [
+            [
+                new ChatMessageContent(AuthorRole.User, "Can you send a very quick approval to the marketing team?"),
+                new ChatMessageContent(AuthorRole.System, "Intent:"),
+                new ChatMessageContent(AuthorRole.Assistant, "ContinueConversation")
+            ],
+            [
+                new ChatMessageContent(AuthorRole.User, "Can you send the full update to the marketing team?"),
+                new ChatMessageContent(AuthorRole.System, "Intent:"),
+                new ChatMessageContent(AuthorRole.Assistant, "EndConversation")
+            ]
+        ];
+
+        // Create chat history
+        ChatHistory history = [];
+
+        // Start the chat loop
+        Console.Write("User > ");
+        string? userInput;
+        while ((userInput = Console.ReadLine()) is not null)
+        {
+            // Invoke handlebars prompt
+            var intent = await kernel.InvokeAsync(
+                getIntent,
+                new()
+                {
+                    { "request", userInput },
+                    { "choices", choices },
+                    { "history", history },
+                    { "fewShotExamples", fewShotExamples }
+                }
+            );
+
+            // End the chat if the intent is "Stop"
+            if (intent.ToString() == "EndConversation")
+            {
+                break;
+            }
+
+            // Get chat response
+            var chatResult = kernel.InvokeStreamingAsync<StreamingChatMessageContent>(
+                prompts["chat"],
+                new()
+                {
+                    { "request", userInput },
+                    { "history", string.Join("\n", history.Select(x => x.Role + ": " + x.Content)) }
+                }
+            );
+
+            // Stream the response
+            string message = "";
+            await foreach (var chunk in chatResult)
+            {
+                if (chunk.Role.HasValue)
+                {
+                    Console.Write(chunk.Role + " > ");
+                }
+                message += chunk;
+                Console.Write(chunk);
+            }
+            Console.WriteLine();
+
+            // Append to history
+            history.AddUserMessage(userInput);
+            history.AddAssistantMessage(message);
+
+            // Get user input again
+            Console.Write("User > ");
+        }
+    }
+}