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,144 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Azure.AI.Agents.Persistent;
+using Azure.AI.Projects;
+using Azure.Identity;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Agents.AzureAI;
+
+#pragma warning disable SKEXP0110 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+
+var azureEndpoint = Environment.GetEnvironmentVariable("AZURE_FOUNDRY_PROJECT_ENDPOINT") ?? throw new InvalidOperationException("AZURE_FOUNDRY_PROJECT_ENDPOINT is not set.");
+var deploymentName = System.Environment.GetEnvironmentVariable("AZURE_FOUNDRY_PROJECT_DEPLOYMENT_NAME") ?? "gpt-4o";
+var userInput = "Tell me a joke about a pirate.";
+
+Console.WriteLine($"User Input: {userInput}");
+
+await SKAgentAsync();
+await SKAgent_As_AFAgentAsync();
+await AFAgentAsync();
+
+async Task SKAgentAsync()
+{
+    Console.WriteLine("\n=== SK Agent ===\n");
+
+    var serviceCollection = new ServiceCollection();
+    serviceCollection.AddSingleton((sp) => AzureAIAgent.CreateAgentsClient(azureEndpoint, new AzureCliCredential()));
+    serviceCollection.AddTransient<AzureAIAgent>((sp) =>
+    {
+        var azureAgentClient = sp.GetRequiredService<PersistentAgentsClient>();
+
+        Console.Write("Creating agent in the cloud...");
+
+        PersistentAgent definition = azureAgentClient.Administration
+            .CreateAgent(deploymentName,
+                name: "GenerateStory",
+                instructions: "You are good at telling jokes.");
+
+        Console.Write("Done\n");
+
+        return new(definition, azureAgentClient);
+    });
+    serviceCollection.AddKernel();
+
+    await using ServiceProvider serviceProvider = serviceCollection.BuildServiceProvider();
+    var agent = serviceProvider.GetRequiredService<AzureAIAgent>();
+
+    var thread = new AzureAIAgentThread(agent.Client);
+
+    var result = await agent.InvokeAsync(userInput).FirstAsync();
+    Console.WriteLine(result.Message);
+
+    Console.WriteLine("---");
+    await foreach (ChatMessageContent update in agent.InvokeAsync(userInput, thread))
+    {
+        Console.Write(update);
+    }
+
+    // Clean up
+    await thread.DeleteAsync();
+    await agent.Client.Administration.DeleteAgentAsync(agent.Id);
+}
+
+async Task SKAgent_As_AFAgentAsync()
+{
+    Console.WriteLine("\n=== SK Agent Converted as an AF Agent ===\n");
+
+    var serviceCollection = new ServiceCollection();
+    serviceCollection.AddSingleton((sp) => AzureAIAgent.CreateAgentsClient(azureEndpoint, new AzureCliCredential()));
+    serviceCollection.AddTransient<AzureAIAgent>((sp) =>
+    {
+        var azureAgentClient = sp.GetRequiredService<PersistentAgentsClient>();
+
+        Console.Write("Creating agent in the cloud...");
+
+        PersistentAgent definition = azureAgentClient.Administration
+            .CreateAgent(deploymentName,
+                name: "GenerateStory",
+                instructions: "You are good at telling jokes.");
+
+        Console.Write("Done\n");
+
+        return new(definition, azureAgentClient);
+    });
+    serviceCollection.AddKernel();
+
+    await using ServiceProvider serviceProvider = serviceCollection.BuildServiceProvider();
+    var skAgent = serviceProvider.GetRequiredService<AzureAIAgent>();
+
+    var agent = skAgent.AsAIAgent();
+
+    var thread = await agent.CreateSessionAsync();
+
+    var result = await agent.RunAsync(userInput, thread);
+    Console.WriteLine(result);
+
+    Console.WriteLine("---");
+    await foreach (var update in agent.RunStreamingAsync(userInput, thread))
+    {
+        Console.Write(update);
+    }
+
+    // Clean up
+    var azureAgentClient = serviceProvider.GetRequiredService<PersistentAgentsClient>();
+    if (thread is ChatClientAgentSession chatSession)
+    {
+        await azureAgentClient.Threads.DeleteThreadAsync(chatSession.ConversationId);
+    }
+    await azureAgentClient.Administration.DeleteAgentAsync(agent.Id);
+}
+
+async Task AFAgentAsync()
+{
+    Console.WriteLine("\n=== AF Agent ===\n");
+
+    var serviceCollection = new ServiceCollection();
+    serviceCollection.AddSingleton((sp) => new AIProjectClient(new Uri(azureEndpoint), new AzureCliCredential()));
+    serviceCollection.AddTransient<AIAgent>((sp) =>
+    {
+        var client = sp.GetRequiredService<AIProjectClient>();
+        return client.AsAIAgent(
+                deploymentName,
+                instructions: "You are good at telling jokes.",
+                name: "GenerateStory");
+    });
+
+    await using ServiceProvider serviceProvider = serviceCollection.BuildServiceProvider();
+    var agent = serviceProvider.GetRequiredService<AIAgent>();
+
+    var session = await agent.CreateSessionAsync();
+
+    var result = await agent.RunAsync(userInput, session);
+    Console.WriteLine(result);
+
+    Console.WriteLine("---");
+    await foreach (var update in agent.RunStreamingAsync(userInput, session))
+    {
+        Console.Write(update);
+    }
+
+    // No cleanup needed - non-hosted path doesn't create server-side resources.
+}