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,52 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Connectors.OpenAI;
+
+namespace GettingStarted;
+
+/// <summary>
+/// This example shows how to create and use a <see cref="Kernel"/> with ChatClient.
+/// </summary>
+public sealed class Step1_Create_Kernel(ITestOutputHelper output) : BaseTest(output)
+{
+    /// <summary>
+    /// Show how to create a <see cref="Kernel"/> using ChatClient and use it to execute prompts.
+    /// </summary>
+    [Fact]
+    public async Task CreateKernel()
+    {
+        // Create a kernel with OpenAI chat completion using ChatClient
+        Kernel kernel = Kernel.CreateBuilder()
+            .AddOpenAIChatClient(
+                modelId: TestConfiguration.OpenAI.ChatModelId,
+                apiKey: TestConfiguration.OpenAI.ApiKey)
+            .Build();
+
+        // Example 1. Invoke the kernel with a prompt and display the result
+        Console.WriteLine(await kernel.InvokePromptAsync("What color is the sky?"));
+        Console.WriteLine();
+
+        // Example 2. Invoke the kernel with a templated prompt and display the result
+        KernelArguments arguments = new() { { "topic", "sea" } };
+        Console.WriteLine(await kernel.InvokePromptAsync("What color is the {{$topic}}?", arguments));
+        Console.WriteLine();
+
+        // Example 3. Invoke the kernel with a templated prompt and stream the results to the display
+        await foreach (var update in kernel.InvokePromptStreamingAsync("What color is the {{$topic}}? Provide a detailed explanation.", arguments))
+        {
+            Console.Write(update);
+        }
+
+        Console.WriteLine(string.Empty);
+
+        // Example 4. Invoke the kernel with a templated prompt and execution settings
+        arguments = new(new OpenAIPromptExecutionSettings { MaxTokens = 500, Temperature = 0.5 }) { { "topic", "dogs" } };
+        Console.WriteLine(await kernel.InvokePromptAsync("Tell me a story about {{$topic}}", arguments));
+
+        // Example 5. Invoke the kernel with a templated prompt and execution settings configured to return JSON
+#pragma warning disable SKEXP0010
+        arguments = new(new OpenAIPromptExecutionSettings { ResponseFormat = "json_object" }) { { "topic", "chocolate" } };
+        Console.WriteLine(await kernel.InvokePromptAsync("Create a recipe for a {{$topic}} cake in JSON format", arguments));
+    }
+}