chore: import upstream snapshot with attribution

dotnet/samples/AgentFrameworkMigration/OpenAI/Step01_Basics/OpenAI_Step01_Basics.csproj

@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <NoWarn>$(NoWarn);CA1707;CA2007;VSTHRD111</NoWarn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Agents.AI.Abstractions" />
+    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\..\src\Agents\Core\Agents.Core.csproj" />
+    <ProjectReference Include="..\..\..\..\src\Agents\OpenAI\Agents.OpenAI.csproj" />
+    <ProjectReference Include="..\..\..\..\src\SemanticKernel.MetaPackage\SemanticKernel.MetaPackage.csproj" />
+  </ItemGroup>
+
+</Project>

dotnet/samples/AgentFrameworkMigration/OpenAI/Step01_Basics/Program.cs

@@ -0,0 +1,100 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.Agents.AI;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Agents;
+using Microsoft.SemanticKernel.Connectors.OpenAI;
+using OpenAI;
+using OpenAI.Chat;
+
+var apiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY") ?? throw new InvalidOperationException("OPENAI_API_KEY is not set.");
+var model = System.Environment.GetEnvironmentVariable("OPENAI_MODEL") ?? "gpt-4o";
+var userInput = "Tell me a joke about a pirate.";
+
+Console.WriteLine($"User Input: {userInput}");
+
+await SKAgentAsync();
+await SKAgent_As_AFAgentAsync();
+await AFAgentAsync();
+
+// Example of Semantic Kernel Agent code
+async Task SKAgentAsync()
+{
+    Console.WriteLine("\n=== SK Agent ===\n");
+
+    var builder = Kernel.CreateBuilder().AddOpenAIChatClient(model, apiKey);
+
+    var agent = new ChatCompletionAgent()
+    {
+        Kernel = builder.Build(),
+        Name = "Joker",
+        Instructions = "You are good at telling jokes.",
+    };
+
+    var thread = new ChatHistoryAgentThread();
+    var settings = new OpenAIPromptExecutionSettings() { MaxTokens = 1000 };
+    var agentOptions = new AgentInvokeOptions() { KernelArguments = new(settings) };
+
+    await foreach (var result in agent.InvokeAsync(userInput, thread, agentOptions))
+    {
+        Console.WriteLine(result.Message);
+    }
+
+    Console.WriteLine("---");
+    await foreach (var update in agent.InvokeStreamingAsync(userInput, thread, agentOptions))
+    {
+        Console.Write(update.Message);
+    }
+}
+
+// Example of Semantic Kernel Agent code converted as an Agent Framework Agent
+async Task SKAgent_As_AFAgentAsync()
+{
+    Console.WriteLine("\n=== SK Agent Converted as an AF Agent ===\n");
+
+    var builder = Kernel.CreateBuilder().AddOpenAIChatClient(model, apiKey);
+
+#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 agent = new ChatCompletionAgent()
+    {
+        Kernel = builder.Build(),
+        Name = "Joker",
+        Instructions = "You are good at telling jokes.",
+    }.AsAIAgent();
+
+#pragma warning restore SKEXP0110 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+
+    var thread = await agent.CreateSessionAsync();
+    var agentOptions = new ChatClientAgentRunOptions(new() { MaxOutputTokens = 1000 });
+
+    var result = await agent.RunAsync(userInput, thread, agentOptions);
+    Console.WriteLine(result);
+
+    Console.WriteLine("---");
+    await foreach (var update in agent.RunStreamingAsync(userInput, thread, agentOptions))
+    {
+        Console.Write(update);
+    }
+}
+
+// Example of a fully migrated Agent Framework Agent code
+async Task AFAgentAsync()
+{
+    Console.WriteLine("\n=== AF Agent ===\n");
+
+    var agent = new OpenAIClient(apiKey).GetChatClient(model)
+        .AsAIAgent(name: "Joker", instructions: "You are good at telling jokes.");
+
+    var thread = await agent.CreateSessionAsync();
+    var agentOptions = new ChatClientAgentRunOptions(new() { MaxOutputTokens = 1000 });
+
+    var result = await agent.RunAsync(userInput, thread, agentOptions);
+    Console.WriteLine(result);
+
+    Console.WriteLine("---");
+    await foreach (var update in agent.RunStreamingAsync(userInput, thread, agentOptions))
+    {
+        Console.Write(update);
+    }
+}

dotnet/samples/AgentFrameworkMigration/OpenAI/Step02_ToolCall/OpenAI_Step02_ToolCall.csproj

@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <NoWarn>$(NoWarn);CA1707;CA2007;VSTHRD111</NoWarn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Agents.AI.Abstractions" />
+    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\..\src\Agents\Core\Agents.Core.csproj" />
+    <ProjectReference Include="..\..\..\..\src\Agents\OpenAI\Agents.OpenAI.csproj" />
+    <ProjectReference Include="..\..\..\..\src\SemanticKernel.MetaPackage\SemanticKernel.MetaPackage.csproj" />
+  </ItemGroup>
+
+</Project>

dotnet/samples/AgentFrameworkMigration/OpenAI/Step02_ToolCall/Program.cs

@@ -0,0 +1,98 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System.ComponentModel;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Agents;
+using OpenAI;
+using OpenAI.Chat;
+
+var apiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY") ?? throw new InvalidOperationException("OPENAI_API_KEY is not set.");
+var model = System.Environment.GetEnvironmentVariable("OPENAI_MODEL") ?? "gpt-4o";
+var userInput = "What is the weather like in Amsterdam?";
+
+Console.WriteLine($"User Input: {userInput}");
+
+[KernelFunction]
+[Description("Get the weather for a given location.")]
+static string GetWeather([Description("The location to get the weather for.")] string location)
+    => $"The weather in {location} is cloudy with a high of 15°C.";
+
+await SKAgentAsync();
+await SKAgent_As_AFAgentAsync();
+await AFAgentAsync();
+
+async Task SKAgentAsync()
+{
+    var builder = Kernel.CreateBuilder().AddOpenAIChatClient(model, apiKey);
+
+    ChatCompletionAgent agent = new()
+    {
+        Instructions = "You are a helpful assistant",
+        Kernel = builder.Build(),
+        Arguments = new KernelArguments(new PromptExecutionSettings() { FunctionChoiceBehavior = FunctionChoiceBehavior.Auto() }),
+    };
+
+    // Initialize plugin and add to the agent's Kernel (same as direct Kernel usage).
+    agent.Kernel.Plugins.Add(KernelPluginFactory.CreateFromFunctions("KernelPluginName", [KernelFunctionFactory.CreateFromMethod(GetWeather)]));
+
+    Console.WriteLine("\n=== SK Agent Response ===\n");
+
+    await foreach (var item in agent.InvokeAsync(userInput))
+    {
+        Console.Write(item.Message);
+    }
+}
+
+// Example of Semantic Kernel Agent code converted as an Agent Framework Agent
+async Task SKAgent_As_AFAgentAsync()
+{
+    Console.WriteLine("\n=== SK Agent Converted as an AF Agent ===\n");
+
+    var builder = Kernel.CreateBuilder().AddOpenAIChatClient(model, apiKey);
+
+    ChatCompletionAgent skAgent = new()
+    {
+        Instructions = "You are a helpful assistant",
+        Kernel = builder.Build(),
+        Arguments = new KernelArguments(new PromptExecutionSettings() { FunctionChoiceBehavior = FunctionChoiceBehavior.Auto() }),
+    };
+
+    // Initialize plugin and add to the agent's Kernel (same as direct Kernel usage).
+    skAgent.Kernel.Plugins.Add(KernelPluginFactory.CreateFromFunctions("KernelPluginName", [KernelFunctionFactory.CreateFromMethod(GetWeather)]));
+
+#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 agent = skAgent.AsAIAgent();
+#pragma warning restore SKEXP0110 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+
+    var thread = await agent.CreateSessionAsync();
+    var agentOptions = new ChatClientAgentRunOptions(new() { MaxOutputTokens = 1000 });
+
+    var result = await agent.RunAsync(userInput, thread, agentOptions);
+    Console.WriteLine(result);
+
+    Console.WriteLine("---");
+    await foreach (var update in agent.RunStreamingAsync(userInput, thread, agentOptions))
+    {
+        Console.Write(update);
+    }
+
+    Console.WriteLine("\n---\n");
+    await foreach (var item in skAgent.InvokeAsync(userInput))
+    {
+        Console.Write(item.Message);
+    }
+}
+
+async Task AFAgentAsync()
+{
+    var agent = new OpenAIClient(apiKey).GetChatClient(model).AsAIAgent(
+        instructions: "You are a helpful assistant",
+        tools: [AIFunctionFactory.Create(GetWeather)]);
+
+    Console.WriteLine("\n=== AF Agent Response ===\n");
+
+    var result = await agent.RunAsync(userInput);
+    Console.WriteLine(result);
+}

dotnet/samples/AgentFrameworkMigration/OpenAI/Step03_DependencyInjection/OpenAI_Step03_DependencyInjection.csproj

@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <NoWarn>$(NoWarn);CA1707;CA2007;VSTHRD111</NoWarn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Agents.AI.Abstractions" />
+    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\..\src\Agents\Core\Agents.Core.csproj" />
+    <ProjectReference Include="..\..\..\..\src\Agents\OpenAI\Agents.OpenAI.csproj" />
+    <ProjectReference Include="..\..\..\..\src\SemanticKernel.MetaPackage\SemanticKernel.MetaPackage.csproj" />
+  </ItemGroup>
+
+</Project>

dotnet/samples/AgentFrameworkMigration/OpenAI/Step03_DependencyInjection/Program.cs

@@ -0,0 +1,81 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Agents;
+using OpenAI;
+using OpenAI.Chat;
+
+var apiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY") ?? throw new InvalidOperationException("OPENAI_API_KEY is not set.");
+var model = System.Environment.GetEnvironmentVariable("OPENAI_MODEL") ?? "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.AddKernel().AddOpenAIChatClient(model, apiKey);
+    serviceCollection.AddTransient((sp) => new ChatCompletionAgent()
+    {
+        Kernel = sp.GetRequiredService<Kernel>(),
+        Name = "Joker",
+        Instructions = "You are good at telling jokes."
+    });
+
+    await using ServiceProvider serviceProvider = serviceCollection.BuildServiceProvider();
+    var agent = serviceProvider.GetRequiredService<ChatCompletionAgent>();
+
+    await foreach (var item in agent.InvokeAsync(userInput))
+    {
+        Console.WriteLine(item.Message);
+    }
+}
+
+// Example of Semantic Kernel Agent code converted as an Agent Framework Agent
+async Task SKAgent_As_AFAgentAsync()
+{
+    Console.WriteLine("\n=== SK Agent Converted as an AF Agent ===\n");
+
+    var serviceCollection = new ServiceCollection();
+    serviceCollection.AddKernel().AddOpenAIChatClient(model, apiKey);
+#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.
+
+    serviceCollection.AddTransient<AIAgent>((sp) => new ChatCompletionAgent()
+    {
+        Kernel = sp.GetRequiredService<Kernel>(),
+        Name = "Joker",
+        Instructions = "You are good at telling jokes."
+    }.AsAIAgent());
+
+#pragma warning restore SKEXP0110 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.
+
+    await using ServiceProvider serviceProvider = serviceCollection.BuildServiceProvider();
+    var agent = serviceProvider.GetRequiredService<AIAgent>();
+
+    var result = await agent.RunAsync(userInput);
+    Console.WriteLine(result);
+}
+
+async Task AFAgentAsync()
+{
+    Console.WriteLine("\n=== AF Agent ===\n");
+
+    var serviceCollection = new ServiceCollection();
+    serviceCollection.AddTransient<AIAgent>((sp) => new OpenAIClient(apiKey)
+        .GetChatClient(model)
+        .AsAIAgent(name: "Joker", instructions: "You are good at telling jokes."));
+
+    await using ServiceProvider serviceProvider = serviceCollection.BuildServiceProvider();
+    var agent = serviceProvider.GetRequiredService<AIAgent>();
+
+    var result = await agent.RunAsync(userInput);
+    Console.WriteLine(result);
+}