.Net - Agent Samples Restructure

dotnet/samples/Concepts/AgentSyntax/AgentSyntax.csproj

@@ -48,4 +48,8 @@
     </EmbeddedResource>
     <None Remove="Resources\*" />
   </ItemGroup>
+  <ItemGroup>
+    <Folder Include="MixedAgents\" />
+    <Folder Include="OpenAIAssistant\" />
+  </ItemGroup>
 </Project>

dotnet/samples/Concepts/AgentSyntax/BaseTest.cs

@@ -1,5 +1,4 @@
 // Copyright (c) Microsoft. All rights reserved.
-
 using System.Reflection;
 using Configuration;
 using Microsoft.Extensions.Configuration;

dotnet/samples/Concepts/AgentSyntax/Example01_Agent.cs → dotnet/samples/Concepts/AgentSyntax/Getting_Started/Step1_Agent.cs

@@ -1,18 +1,19 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Threading.Tasks;
+using Examples;
 using Microsoft.SemanticKernel;
 using Microsoft.SemanticKernel.Agents;
 using Microsoft.SemanticKernel.ChatCompletion;
 using Xunit;
 using Xunit.Abstractions;
 
-namespace Examples;
+namespace GettingStarted;
 
 /// <summary>
 /// Demonstrate creation of <see cref="ChatCompletionAgent"/> and
 /// eliciting its response to three explicit user messages.
 /// </summary>
-public class Example01_Agent(ITestOutputHelper output) : BaseTest(output)
+public class Step1_Agent(ITestOutputHelper output) : BaseTest(output)
 {
     private const string ParrotName = "Parrot";
     private const string ParrotInstructions = "Repeat the user message in the voice of a pirate and then end with a parrot sound.";

dotnet/samples/Concepts/AgentSyntax/Example02_Plugins.cs → dotnet/samples/Concepts/AgentSyntax/Getting_Started/Step2_Plugins.cs

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft. All rights reserved.
 using System.Threading.Tasks;
+using Examples;
 using Microsoft.SemanticKernel;
 using Microsoft.SemanticKernel.Agents;
 using Microsoft.SemanticKernel.ChatCompletion;
@@ -8,13 +9,13 @@
 using Xunit;
 using Xunit.Abstractions;
 
-namespace Examples;
+namespace GettingStarted;
 
 /// <summary>
 /// Demonstrate creation of <see cref="ChatCompletionAgent"/> with a <see cref="KernelPlugin"/>,
 /// and then eliciting its response to explicit user messages.
 /// </summary>
-public class Example02_Plugins(ITestOutputHelper output) : BaseTest(output)
+public class Step2_Plugins(ITestOutputHelper output) : BaseTest(output)
 {
     private const string HostName = "Host";
     private const string HostInstructions = "Answer questions about the menu.";

dotnet/samples/Concepts/AgentSyntax/Example03_Chat.cs → dotnet/samples/Concepts/AgentSyntax/Getting_Started/Step3_Chat.cs

@@ -3,21 +3,22 @@
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
+using Examples;
 using Microsoft.SemanticKernel;
 using Microsoft.SemanticKernel.Agents;
 using Microsoft.SemanticKernel.Agents.Chat;
 using Microsoft.SemanticKernel.ChatCompletion;
 using Xunit;
 using Xunit.Abstractions;
 
-namespace Examples;
+namespace GettingStarted;
 
 /// <summary>
 /// Demonstrate creation of <see cref="AgentChat"/> with <see cref="AgentGroupChatSettings"/>
 /// that inform how chat proceeds with regards to: Agent selection, chat continuation, and maximum
 /// number of agent interactions.
 /// </summary>
-public class Example03_Chat(ITestOutputHelper output) : BaseTest(output)
+public class Step3_Chat(ITestOutputHelper output) : BaseTest(output)
 {
     private const string ReviewerName = "ArtDirector";
     private const string ReviewerInstructions =

dotnet/samples/Concepts/AgentSyntax/Example16_MixedChat.cs → dotnet/samples/Concepts/AgentSyntax/MixedChat_Agents.cs

@@ -12,12 +12,11 @@
 using Xunit.Abstractions;
 
 namespace Examples;
-
 /// <summary>
 /// Demonstrate that two different agent types are able to participate in the same conversation.
 /// In this case a <see cref="ChatCompletionAgent"/> and <see cref="OpenAIAssistantAgent"/> participate.
 /// </summary>
-public class Example16_MixedChat(ITestOutputHelper output) : BaseTest(output)
+public class MixedChat_Agents(ITestOutputHelper output) : BaseTest(output)
 {
     private const string ReviewerName = "ArtDirector";
     private const string ReviewerInstructions =

dotnet/samples/Concepts/AgentSyntax/Example12_OpenAIAssistant_Plugins.cs → dotnet/samples/Concepts/AgentSyntax/OpenAIAssistant_Agent.cs

@@ -9,16 +9,16 @@
 using Xunit.Abstractions;
 
 namespace Examples;
-
 /// <summary>
-/// Demonstrate creation of <see cref="OpenAIAssistantAgent"/> with a <see cref="KernelPlugin"/>,
-/// and then eliciting its response to explicit user messages.
+/// Demonstrate creation of <see cref="OpenAIAssistantAgent"/> and
+/// eliciting its response to three explicit user messages.
 /// </summary>
 /// <remarks>
-/// This example demonstrates that outside of initialization (and cleanup), plugin
-/// usage for <see cref="OpenAIAssistantAgent"/> is no different from <see cref="ChatCompletionAgent"/>.
+/// This example demonstrates that outside of initialization (and cleanup), using
+/// <see cref="OpenAIAssistantAgent"/> is no different from <see cref="ChatCompletionAgent"/>
+/// even with with a <see cref="KernelPlugin"/>.
 /// </remarks>
-public class Example12_OpenAIAssistant_Plugins(ITestOutputHelper output) : BaseTest(output)
+public class OpenAIAssistant_Agent(ITestOutputHelper output) : BaseTest(output)
 {
     private const string HostName = "Host";
     private const string HostInstructions = "Answer questions about the menu.";

dotnet/samples/Concepts/AgentSyntax/Example15_OpenAIAssistant_ChartMaker.cs → dotnet/samples/Concepts/AgentSyntax/OpenAIAssistant_ChartMaker.cs

@@ -9,12 +9,11 @@
 using Xunit.Abstractions;
 
 namespace Examples;
-
 /// <summary>
 /// Demonstrate using code-interpreter with <see cref="OpenAIAssistantAgent"/> to
 /// produce image content displays the requested charts.
 /// </summary>
-public class Example15_OpenAIAssistant_ChartMaker(ITestOutputHelper output) : BaseTest(output)
+public class OpenAIAssistant_ChartMaker(ITestOutputHelper output) : BaseTest(output)
 {
     /// <summary>
     /// Target Open AI services.

dotnet/samples/Concepts/AgentSyntax/Example13_OpenAIAssistant_CodeInterpreter.cs → dotnet/samples/Concepts/AgentSyntax/OpenAIAssistant_CodeInterpreter.cs

@@ -8,11 +8,10 @@
 using Xunit.Abstractions;
 
 namespace Examples;
-
 /// <summary>
 /// Demonstrate using code-interpreter on <see cref="OpenAIAssistantAgent"/> .
 /// </summary>
-public class Example13_OpenAIAssistant_CodeInterpreter(ITestOutputHelper output) : BaseTest(output)
+public class OpenAIAssistant_CodeInterpreter(ITestOutputHelper output) : BaseTest(output)
 {
     [Fact]
     public async Task RunAsync()

dotnet/samples/Concepts/AgentSyntax/Example14_OpenAIAssistant_Retrieval.cs → dotnet/samples/Concepts/AgentSyntax/OpenAIAssistant_Retrieval.cs

@@ -11,11 +11,10 @@
 using Xunit.Abstractions;
 
 namespace Examples;
-
 /// <summary>
 /// Demonstrate using retrieval on <see cref="OpenAIAssistantAgent"/> .
 /// </summary>
-public class Example14_OpenAIAssistant_Retrieval(ITestOutputHelper output) : BaseTest(output)
+public class OpenAIAssistant_Retrieval(ITestOutputHelper output) : BaseTest(output)
 {
     /// <summary>
     /// Retrieval tool not supported on Azure OpenAI.