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,68 @@
+// Copyright (c) Microsoft. All rights reserved.
+#pragma warning disable VSTHRD111 // Use ConfigureAwait(bool)
+#pragma warning disable CA1050 // Declare types in namespaces
+#pragma warning disable CA2007 // Consider calling ConfigureAwait on the awaited task
+
+using System.ComponentModel;
+using Microsoft.Extensions.Configuration;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.ChatCompletion;
+using Microsoft.SemanticKernel.Connectors.OpenAI;
+
+var config = new ConfigurationBuilder()
+    .AddUserSecrets<Program>()
+    .AddEnvironmentVariables()
+    .Build()
+    ?? throw new InvalidOperationException("Configuration is not provided.");
+
+ArgumentNullException.ThrowIfNull(config["OpenAI:ChatModelId"], "OpenAI:ChatModelId");
+ArgumentNullException.ThrowIfNull(config["OpenAI:ApiKey"], "OpenAI:ApiKey");
+
+var kernelBuilder = Kernel.CreateBuilder().AddOpenAIChatCompletion(
+    modelId: config["OpenAI:ChatModelId"]!,
+    apiKey: config["OpenAI:ApiKey"]!);
+
+kernelBuilder.Plugins.AddFromType<TimeInformationPlugin>();
+var kernel = kernelBuilder.Build();
+
+// Get chat completion service
+var chatCompletionService = kernel.GetRequiredService<IChatCompletionService>();
+
+// Enable auto function calling
+OpenAIPromptExecutionSettings openAIPromptExecutionSettings = new()
+{
+    FunctionChoiceBehavior = FunctionChoiceBehavior.Auto()
+};
+
+Console.WriteLine("Ask questions to use the Time Plugin such as:\n" +
+                  "- What time is it?");
+
+ChatHistory chatHistory = [];
+string? input = null;
+while (true)
+{
+    Console.Write("\nUser > ");
+    input = Console.ReadLine();
+    if (string.IsNullOrWhiteSpace(input))
+    {
+        // Leaves if the user hit enter without typing any word
+        break;
+    }
+    chatHistory.AddUserMessage(input);
+    var chatResult = await chatCompletionService.GetChatMessageContentAsync(chatHistory, openAIPromptExecutionSettings, kernel);
+    Console.Write($"\nAssistant > {chatResult}\n");
+}
+
+/// <summary>
+/// A plugin that returns the current time.
+/// </summary>
+public class TimeInformationPlugin
+{
+    /// <summary>
+    /// Retrieves the current time in UTC.
+    /// </summary>
+    /// <returns>The current time in UTC. </returns>
+    [KernelFunction, Description("Retrieves the current time in UTC.")]
+    public string GetCurrentUtcTime()
+        => DateTime.UtcNow.ToString("R");
+}