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,124 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.ChatCompletion;
+using Microsoft.SemanticKernel.Connectors.OpenAI;
+using Microsoft.SemanticKernel.Plugins.Core;
+
+namespace Examples;
+
+/// <summary>
+/// This example demonstrates how to configure prompts as described at
+/// https://learn.microsoft.com/semantic-kernel/prompts/configure-prompts
+/// </summary>
+public class ConfiguringPrompts(ITestOutputHelper output) : LearnBaseTest(["Who were the Vikings?"], output)
+{
+    [Fact]
+    public async Task RunAsync()
+    {
+        Console.WriteLine("======== Configuring 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();
+
+        // <FunctionFromPrompt>
+        // Create a template for chat with settings
+        var chat = kernel.CreateFunctionFromPrompt(
+            new PromptTemplateConfig()
+            {
+                Name = "Chat",
+                Description = "Chat with the assistant.",
+                Template = @"{{ConversationSummaryPlugin.SummarizeConversation $history}}
+                            User: {{$request}}
+                            Assistant: ",
+                TemplateFormat = "semantic-kernel",
+                InputVariables =
+                [
+                    new() { Name = "history", Description = "The history of the conversation.", IsRequired = false, Default = "" },
+                    new() { Name = "request", Description = "The user's request.", IsRequired = true }
+                ],
+                ExecutionSettings =
+                {
+                    {
+                        "default",
+                        new OpenAIPromptExecutionSettings()
+                        {
+                            MaxTokens = 1000,
+                            Temperature = 0
+                        }
+                    },
+                    {
+                        "gpt-3.5-turbo", new OpenAIPromptExecutionSettings()
+                        {
+                            ModelId = "gpt-3.5-turbo-0613",
+                            MaxTokens = 4000,
+                            Temperature = 0.2
+                        }
+                    },
+                    {
+                        "gpt-4",
+                        new OpenAIPromptExecutionSettings()
+                        {
+                            ModelId = "gpt-4-1106-preview",
+                            MaxTokens = 8000,
+                            Temperature = 0.3
+                        }
+                    }
+                }
+            }
+        );
+        // </FunctionFromPrompt>
+
+        // Create chat history and choices
+        ChatHistory history = [];
+
+        // Start the chat loop
+        Console.Write("User > ");
+        string? userInput;
+        while ((userInput = Console.ReadLine()) is not null)
+        {
+            // Get chat response
+            var chatResult = kernel.InvokeStreamingAsync<StreamingChatMessageContent>(
+                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 > ");
+        }
+    }
+}