.NET Port Agent Orchestration (#107)

* Checkpoint * Checkpoint * Namespaces * Namespace * Cleanup * Namespace order * Fix sync * Formatting * Formatting * Namespace * Namespace order * Code convention * Naming * Naming * Text handling * Text handling * Namespace * Namespace order * Namespace ordering * Test * ValueTask * net472 * Test fix * Fix namespace (net472) * Namespace * Fix conditional namespace * Fix type expression * Compatibility and cleanup * Sample compatibility * Sample compat * Test compat * modifier order * Simply http-stub * Formating fix for unit-test * Fix test * Real fix * Test clean-up * Update dotnet/src/Microsoft.Agents.Orchestration/Handoff/HandoffOrchestration.cs Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Fix build errors after merging --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Stephen Toub <stoub@microsoft.com>
2026-06-16 21:04:09 +08:00 · 2025-07-08 10:04:34 -07:00
parent 35c938fb5b
commit 7c8ec5ec19
71 changed files with 5675 additions and 131 deletions
@@ -0,0 +1,70 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System.Text.Json;
+using Microsoft.Agents.Orchestration;
+using Microsoft.Agents.Orchestration.Concurrent;
+using Microsoft.Agents.Orchestration.Transforms;
+using Microsoft.Extensions.AI.Agents;
+using Microsoft.SemanticKernel.Agents.Runtime.InProcess;
+using Microsoft.Shared.Samples;
+
+namespace Orchestration;
+
+/// <summary>
+/// Demonstrates how to use the <see cref="ConcurrentOrchestration"/> with structured output.
+/// </summary>
+public class ConcurrentOrchestration_With_StructuredOutput(ITestOutputHelper output) : OrchestrationSample(output)
+{
+    private static readonly JsonSerializerOptions s_options = new() { WriteIndented = true };
+
+    [Fact]
+    public async Task RunOrchestrationAsync()
+    {
+        // Define the agents
+        ChatClientAgent agent1 =
+            this.CreateAgent(
+                instructions: "You are an expert in identifying themes in articles. Given an article, identify the main themes.",
+                description: "An expert in identifying themes in articles");
+        ChatClientAgent agent2 =
+            this.CreateAgent(
+                instructions: "You are an expert in sentiment analysis. Given an article, identify the sentiment.",
+                description: "An expert in sentiment analysis");
+        ChatClientAgent agent3 =
+            this.CreateAgent(
+                instructions: "You are an expert in entity recognition. Given an article, extract the entities.",
+                description: "An expert in entity recognition");
+
+        // Define the orchestration with transform
+        StructuredOutputTransform<Analysis> outputTransform = new(this.CreateChatClient());
+        ConcurrentOrchestration<string, Analysis> orchestration =
+            new(agent1, agent2, agent3)
+            {
+                LoggerFactory = this.LoggerFactory,
+                ResultTransform = outputTransform.TransformAsync,
+            };
+
+        // Start the runtime
+        await using InProcessRuntime runtime = new();
+        await runtime.StartAsync();
+
+        // Run the orchestration
+        const string resourceId = "Hamlet_full_play_summary.txt";
+        string input = Resources.Read(resourceId);
+        Console.WriteLine($"\n# INPUT: @{resourceId}\n");
+        OrchestrationResult<Analysis> result = await orchestration.InvokeAsync(input, runtime);
+
+        Analysis output = await result.GetValueAsync(TimeSpan.FromSeconds(ResultTimeoutInSeconds * 2));
+        Console.WriteLine($"\n# RESULT:\n{JsonSerializer.Serialize(output, s_options)}");
+
+        await runtime.RunUntilIdleAsync();
+    }
+
+#pragma warning disable CA1812 // Avoid uninstantiated internal classes
+    private sealed class Analysis
+    {
+        public IList<string> Themes { get; set; } = [];
+        public IList<string> Sentiments { get; set; } = [];
+        public IList<string> Entities { get; set; } = [];
+    }
+#pragma warning restore CA1812 // Avoid uninstantiated internal classes
+}