.Net: Feat: adds support for Copilot Agent Plugins in dotnet and other fixes.

dotnet/docs/EXPERIMENTS.md

@@ -60,7 +60,7 @@ You can use the following diagnostic IDs to ignore warnings or errors for a part
 | SKEXP0040 | Markdown functions |
 | SKEXP0040 | OpenAPI functions |
 | SKEXP0040 | OpenAPI function extensions - API Manifest |
-| SKEXP0040 | OpenAPI function extensions - Microsoft Manifest |
+| SKEXP0040 | OpenAPI function extensions - Copilot Agent Plugin |
 | SKEXP0040 | Prompty Format support |
 | | | | | | | |
 | SKEXP0050 | Core plugins |

dotnet/samples/Concepts/Concepts.csproj

@@ -106,10 +106,10 @@
     </None>
   </ItemGroup>
   <ItemGroup>
-    <None Include="Resources\Plugins\MicrosoftManifestPlugins\**\*.json">
+    <None Include="Resources\Plugins\CopilotAgentPlugins\**\*.json">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
-    <None Include="Resources\Plugins\MicrosoftManifestPlugins\**\*.yml">
+    <None Include="Resources\Plugins\CopilotAgentPlugins\**\*.yml">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
     <Content Include="Resources\Plugins\RepairServicePlugin\repair-service.json">

dotnet/samples/Concepts/Plugins/MicrosoftManifestBasedPlugins.cs → dotnet/samples/Concepts/Plugins/CopilotAgentBasedPlugins.cs

@@ -8,13 +8,13 @@
 
 namespace Plugins;
 /// <summary>
-/// These examples demonstrate how to use MicrosoftManifest plugins to call Microsoft Graph and NASA APIs.
-/// Microsoft Manifest plugins are created from the OpenAPI document and the manifest file.
+/// These examples demonstrate how to use CopilotAgent plugins to call Microsoft Graph and NASA APIs.
+/// Copilot Agent Plugin plugins are created from the OpenAPI document and the manifest file.
 /// The manifest file contains the API dependencies and their execution parameters.
 /// The manifest file also contains the authentication information for the APIs, however this is not used by the extension method and MUST be setup separately at the moment, which the example demonstrates.
 ///
 /// Important stages being demonstrated:
-/// 1. Load MicrosoftManifest plugins
+/// 1. Load CopilotAgent plugins
 /// 2. Configure authentication for the APIs
 /// 3. Call functions from the loaded plugins
 ///
@@ -50,7 +50,7 @@ namespace Plugins;
 ///
 /// </summary>
 /// <param name="output">The output helper to use to the test can emit status information</param>
-public class MicrosoftManifestBasedPlugins(ITestOutputHelper output) : BaseTest(output)
+public class CopilotAgentBasedPlugins(ITestOutputHelper output) : BaseTest(output)
 {
     public static readonly IEnumerable<object[]> s_parameters =
     [
@@ -67,11 +67,11 @@ public class MicrosoftManifestBasedPlugins(ITestOutputHelper output) : BaseTest(
         ["AstronomyPlugin", "apod", new KernelArguments { { "_date", "2022-02-02" } }, "AstronomyPlugin"],
     ];
     [Theory, MemberData(nameof(s_parameters))]
-    public async Task RunMicrosoftManifestPluginAsync(string pluginToTest, string functionToTest, KernelArguments? arguments, params string[] pluginsToLoad)
+    public async Task RunCopilotAgentPluginAsync(string pluginToTest, string functionToTest, KernelArguments? arguments, params string[] pluginsToLoad)
     {
         WriteSampleHeadingToConsole(pluginToTest, functionToTest, arguments, pluginsToLoad);
         var kernel = new Kernel();
-        await AddMicrosoftManifestPluginsAsync(kernel, pluginsToLoad);
+        await AddCopilotAgentPluginsAsync(kernel, pluginsToLoad);
 
         var result = await kernel.InvokeAsync(pluginToTest, functionToTest, arguments);
         Console.WriteLine("--------------------");
@@ -82,12 +82,12 @@ public async Task RunMicrosoftManifestPluginAsync(string pluginToTest, string fu
     private void WriteSampleHeadingToConsole(string pluginToTest, string functionToTest, KernelArguments? arguments, params string[] pluginsToLoad)
     {
         Console.WriteLine();
-        Console.WriteLine("======== [MicrosoftManifest Plugins Sample] ========");
+        Console.WriteLine("======== [CopilotAgent Plugins Sample] ========");
         Console.WriteLine($"======== Loading Plugins: {string.Join(" ", pluginsToLoad)} ========");
         Console.WriteLine($"======== Calling Plugin Function: {pluginToTest}.{functionToTest} with parameters {arguments?.Select(x => x.Key + " = " + x.Value).Aggregate((x, y) => x + ", " + y)} ========");
         Console.WriteLine();
     }
-    private async Task AddMicrosoftManifestPluginsAsync(Kernel kernel, params string[] pluginNames)
+    private async Task AddCopilotAgentPluginsAsync(Kernel kernel, params string[] pluginNames)
     {
 #pragma warning disable SKEXP0050
         if (TestConfiguration.MSGraph.Scopes is null)
@@ -123,22 +123,22 @@ private async Task AddMicrosoftManifestPluginsAsync(Kernel kernel, params string
                 request.RequestUri = uriBuilder.Uri;
             });
 
-        var apiManifestPluginParameters = new MicrosoftManifestPluginParameters
+        var apiManifestPluginParameters = new CopilotAgentPluginParameters
         {
             FunctionExecutionParameters = new()
             {
                 { "https://graph.microsoft.com/v1.0", graphOpenApiFunctionExecutionParameters },
                 { "https://api.nasa.gov/planetary", nasaOpenApiFunctionExecutionParameters }
             }
         };
-        var manifestLookupDirectory = Path.Combine(Directory.GetCurrentDirectory(), "..", "..", "..", "Resources", "Plugins", "MicrosoftManifestPlugins");
+        var manifestLookupDirectory = Path.Combine(Directory.GetCurrentDirectory(), "..", "..", "..", "Resources", "Plugins", "CopilotAgentPlugins");
 
         foreach (var pluginName in pluginNames)
         {
             try
             {
 #pragma warning disable CA1308 // Normalize strings to uppercase
-                await kernel.ImportPluginFromMicrosoftManifestAsync(
+                await kernel.ImportPluginFromCopilotAgentPluginAsync(
                     pluginName,
                     Path.Combine(manifestLookupDirectory, pluginName, $"{pluginName[..^6].ToLowerInvariant()}-apiplugin.json"),
                     apiManifestPluginParameters)

dotnet/samples/Concepts/README.md

@@ -168,7 +168,7 @@ dotnet test -l "console;verbosity=detailed" --filter "FullyQualifiedName=ChatCom
 - [GroundednessChecks](https://github.com/microsoft/semantic-kernel/blob/main/dotnet/samples/Concepts/Plugins/GroundednessChecks.cs)
 - [ImportPluginFromGrpc](https://github.com/microsoft/semantic-kernel/blob/main/dotnet/samples/Concepts/Plugins/ImportPluginFromGrpc.cs)
 - [TransformPlugin](https://github.com/microsoft/semantic-kernel/blob/main/dotnet/samples/Concepts/Plugins/TransformPlugin.cs)
-- [MicrosoftManifestBasedPlugins](https://github.com/microsoft/semantic-kernel/blob/main/dotnet/samples/Concepts/Plugins/MicrosoftManifestBasedPlugins.cs)
+- [CopilotAgentBasedPlugins](https://github.com/microsoft/semantic-kernel/blob/main/dotnet/samples/Concepts/Plugins/CopilotAgentBasedPlugins.cs)
 
 ### PromptTemplates - Using [`Templates`](https://github.com/microsoft/semantic-kernel/blob/main/dotnet/src/SemanticKernel.Abstractions/PromptTemplate/IPromptTemplate.cs) with parametrization for `Prompt` rendering
 

dotnet/samples/Concepts/Resources/Plugins/MicrosoftManifestPlugins/README.md → dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins/README.md

@@ -1,52 +1,52 @@
-# Microsoft Manifest Plugins
+# Copilot Agent Plugins
 
 ## Generation
 
 These plugins have been generated thanks to [kiota](https://aka.ms/kiota) and can be regenerated if needed.
 
 ```shell
-cd dotnet/samples/Concepts/Resources/Plugins/MicrosoftManifestPlugins
+cd dotnet/samples/Concepts/Resources/Plugins/CopilotAgentPlugins
 ```
 
 ### Calendar plugin
 
 Microsoft Graph calendar events listing API for the current user.
 
 ```shell
-kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/calendar/events#GET -o MicrosoftManifestPlugins/CalendarPlugin
+kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/calendar/events#GET -o CopilotAgentPlugins/CalendarPlugin
 ```
 
 ### Contacts plugin
 
 Microsoft Graph contacts listing API for the current user.
 
 ```shell
-kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/contacts#GET -o MicrosoftManifestPlugins/ContactsPlugin
+kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/contacts#GET -o CopilotAgentPlugins/ContactsPlugin
 ```
 
 ### DriveItem plugin
 
 Microsoft Graph download a drive item for the current user.
 
 ```shell
-kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /drive/root/children/{driveItem-id}/content#GET -o MicrosoftManifestPlugins/DriveItemPlugin
+kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /drive/root/children/{driveItem-id}/content#GET -o CopilotAgentPlugins/DriveItemPlugin
 ```
 
 ### Messages plugin
 
 Microsoft Graph list message and create a draft message for the current user.
 
 ```shell
-kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/messages#GET -i /me/messages#POST -o MicrosoftManifestPlugins/MessagesPlugin
+kiota plugin add -t APIPlugin -d https://aka.ms/graph/v1.0/openapi.yaml -i /me/messages#GET -i /me/messages#POST -o CopilotAgentPlugins/MessagesPlugin
 ```
 
 ### Astronomy plugin
 
 NASA Astronomy Picture of the day endpoint mixed with Microsoft Graph messages to demonstrate a plugin with multiple APIs.
 
 ```shell
-kiota plugin add -t APIPlugin -d ..\OpenAPI\NASA\apod.yaml -i /apod#GET -o MicrosoftManifestPlugins/AstronomyPlugin
-cp MicrosoftManifestPlugins/MessagesPlugin/messages-openapi.yml MicrosoftManifestPlugins/AstronomyPlugin
+kiota plugin add -t APIPlugin -d ../OpenAPI/NASA/apod.yaml -i /apod#GET -o CopilotAgentPlugins/AstronomyPlugin
+cp CopilotAgentPlugins/MessagesPlugin/messages-openapi.yml CopilotAgentPlugins/AstronomyPlugin
 ```
 
 Add this snippet under runtimes

dotnet/src/Functions/Functions.OpenApi.Extensions/Extensions/MicrosoftManifestKernelExtensions.cs → dotnet/src/Functions/Functions.OpenApi.Extensions/Extensions/CopilotAgentPluginKernelExtensions.cs

@@ -21,43 +21,43 @@ namespace Microsoft.SemanticKernel;
 /// <summary>
 /// Provides extension methods for the <see cref="Kernel"/> class related to OpenAPI functionality.
 /// </summary>
-public static class MicrosoftManifestKernelExtensions
+public static class CopilotAgentPluginKernelExtensions
 {
     /// <summary>
-    /// Imports a plugin from an Microsoft manifest asynchronously.
+    /// Imports a plugin from an Copilot Agent Plugin asynchronously.
     /// </summary>
     /// <param name="kernel">The kernel instance.</param>
     /// <param name="pluginName">The name of the plugin.</param>
-    /// <param name="filePath">The file path of the Microsoft manifest.</param>
+    /// <param name="filePath">The file path of the Copilot Agent Plugin.</param>
     /// <param name="pluginParameters">Optional parameters for the plugin setup.</param>
     /// <param name="cancellationToken">Optional cancellation token.</param>
     /// <returns>The imported plugin.</returns>
-    public static async Task<KernelPlugin> ImportPluginFromMicrosoftManifestAsync(
+    public static async Task<KernelPlugin> ImportPluginFromCopilotAgentPluginAsync(
         this Kernel kernel,
         string pluginName,
         string filePath,
-        MicrosoftManifestPluginParameters? pluginParameters = null,
+        CopilotAgentPluginParameters? pluginParameters = null,
         CancellationToken cancellationToken = default)
     {
-        KernelPlugin plugin = await kernel.CreatePluginFromMicrosoftManifestAsync(pluginName, filePath, pluginParameters, cancellationToken).ConfigureAwait(false);
+        KernelPlugin plugin = await kernel.CreatePluginFromCopilotAgentPluginAsync(pluginName, filePath, pluginParameters, cancellationToken).ConfigureAwait(false);
         kernel.Plugins.Add(plugin);
         return plugin;
     }
 
     /// <summary>
-    /// Creates a kernel plugin from an Microsoft manifest file asynchronously.
+    /// Creates a kernel plugin from an Copilot Agent Plugin file asynchronously.
     /// </summary>
     /// <param name="kernel">The kernel instance.</param>
     /// <param name="pluginName">The name of the plugin.</param>
-    /// <param name="filePath">The file path of the Microsoft manifest.</param>
+    /// <param name="filePath">The file path of the Copilot Agent Plugin.</param>
     /// <param name="pluginParameters">Optional parameters for the plugin setup.</param>
     /// <param name="cancellationToken">Optional cancellation token.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains the created kernel plugin.</returns>
-    public static async Task<KernelPlugin> CreatePluginFromMicrosoftManifestAsync(
+    public static async Task<KernelPlugin> CreatePluginFromCopilotAgentPluginAsync(
         this Kernel kernel,
         string pluginName,
         string filePath,
-        MicrosoftManifestPluginParameters? pluginParameters = null,
+        CopilotAgentPluginParameters? pluginParameters = null,
         CancellationToken cancellationToken = default)
     {
         Verify.NotNull(kernel);
@@ -69,15 +69,15 @@ public static async Task<KernelPlugin> CreatePluginFromMicrosoftManifestAsync(
 
         if (!File.Exists(filePath))
         {
-            throw new FileNotFoundException($"MicrosoftManifest file not found: {filePath}");
+            throw new FileNotFoundException($"CopilotAgent file not found: {filePath}");
         }
 
         var loggerFactory = kernel.LoggerFactory;
-        var logger = loggerFactory.CreateLogger(typeof(MicrosoftManifestKernelExtensions)) ?? NullLogger.Instance;
-        using var microsoftManifestFileJsonContents = DocumentLoader.LoadDocumentFromFilePathAsStream(filePath,
+        var logger = loggerFactory.CreateLogger(typeof(CopilotAgentPluginKernelExtensions)) ?? NullLogger.Instance;
+        using var CopilotAgentFileJsonContents = DocumentLoader.LoadDocumentFromFilePathAsStream(filePath,
             logger);
 
-        var results = await PluginManifestDocument.LoadAsync(microsoftManifestFileJsonContents, new ReaderOptions
+        var results = await PluginManifestDocument.LoadAsync(CopilotAgentFileJsonContents, new ReaderOptions
         {
             ValidationRules = new() // Disable validation rules
         }).ConfigureAwait(false);

dotnet/src/Functions/Functions.OpenApi.Extensions/Extensions/MicrosoftManifestPluginParameters.cs → dotnet/src/Functions/Functions.OpenApi.Extensions/Extensions/CopilotAgentPluginParameters.cs

@@ -5,9 +5,9 @@
 namespace Microsoft.SemanticKernel.Plugins.OpenApi.Extensions;
 
 /// <summary>
-/// Microsoft manifest plugin parameters.
+/// Copilot Agent Plugin plugin parameters.
 /// </summary>
-public sealed class MicrosoftManifestPluginParameters
+public sealed class CopilotAgentPluginParameters
 {
     /// <summary>
     /// Gets the HTTP client to be used in plugin initialization phase.