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,93 @@
+// Copyright (c) Microsoft. All rights reserved.
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Agents;
+using Microsoft.SemanticKernel.Agents.Chat;
+using Microsoft.SemanticKernel.ChatCompletion;
+using Resources;
+
+namespace GettingStarted;
+
+/// <summary>
+/// Demonstrate parsing JSON response.
+/// </summary>
+public class Step05_JsonResult(ITestOutputHelper output) : BaseAgentsTest(output)
+{
+    private const int ScoreCompletionThreshold = 70;
+
+    private const string TutorName = "Tutor";
+    private const string TutorInstructions =
+        """
+        Think step-by-step and rate the user input on creativity and expressiveness from 1-100.
+
+        Respond in JSON format with the following JSON schema:
+
+        {
+            "score": "integer (1-100)",
+            "notes": "the reason for your score"
+        }
+        """;
+
+    [Theory]
+    [InlineData(true)]
+    [InlineData(false)]
+    public async Task UseKernelFunctionStrategiesWithJsonResult(bool useChatClient)
+    {
+        // Define the agents
+        ChatCompletionAgent agent =
+            new()
+            {
+                Instructions = TutorInstructions,
+                Name = TutorName,
+                Kernel = this.CreateKernelWithChatCompletion(useChatClient, out var chatClient),
+            };
+
+        // Create a chat for agent interaction.
+        AgentGroupChat chat =
+            new()
+            {
+                ExecutionSettings =
+                    new()
+                    {
+                        // Here a TerminationStrategy subclass is used that will terminate when
+                        // the response includes a score that is greater than or equal to 70.
+                        TerminationStrategy = new ThresholdTerminationStrategy()
+                    }
+            };
+
+        // Respond to user input
+        await InvokeAgentAsync("The sunset is very colorful.");
+        await InvokeAgentAsync("The sunset is setting over the mountains.");
+        await InvokeAgentAsync("The sunset is setting over the mountains and filled the sky with a deep red flame, setting the clouds ablaze.");
+
+        chatClient?.Dispose();
+
+        // Local function to invoke agent and display the conversation messages.
+        async Task InvokeAgentAsync(string input)
+        {
+            ChatMessageContent message = new(AuthorRole.User, input);
+            chat.AddChatMessage(message);
+            this.WriteAgentChatMessage(message);
+
+            await foreach (ChatMessageContent response in chat.InvokeAsync(agent))
+            {
+                this.WriteAgentChatMessage(response);
+
+                Console.WriteLine($"[IS COMPLETED: {chat.IsComplete}]");
+            }
+        }
+    }
+
+    private record struct WritingScore(int score, string notes);
+
+    private sealed class ThresholdTerminationStrategy : TerminationStrategy
+    {
+        protected override Task<bool> ShouldAgentTerminateAsync(Agent agent, IReadOnlyList<ChatMessageContent> history, CancellationToken cancellationToken)
+        {
+            string lastMessageContent = history[history.Count - 1].Content ?? string.Empty;
+
+            WritingScore? result = JsonResultTranslator.Translate<WritingScore>(lastMessageContent);
+
+            return Task.FromResult((result?.score ?? 0) >= ScoreCompletionThreshold);
+        }
+    }
+}