.Net: Feature copilot agent plugins demosample

dotnet/samples/Demos/CopilotAgentPlugins/CopilotAgentPluginsDemoSample/DemoCommand.cs

@@ -58,8 +58,6 @@ public override async Task<int> ExecuteAsync(CommandContext context, Settings se
 
         while (true)
         {
-            const string LOAD_API_MANIFEST_PLUGIN = "Load API Manifest plugin(s)";
-            const string LOAD_ALL_API_MANIFEST_PLUGINS = "Load all available API Manifest plugins";
             const string LOAD_COPILOT_AGENT_PLUGIN = "Load Copilot Agent plugin(s)";
             const string LOAD_ALL_COPILOT_AGENT_PLUGINS = "Load all available Copilot Agent plugins";
             const string UNLOAD_ALL_PLUGINS = "Unload all plugins";
@@ -74,7 +72,7 @@ public override async Task<int> ExecuteAsync(CommandContext context, Settings se
                 new SelectionPrompt<string>()
                     .Title("SELECT AN OPTION:")
                     .PageSize(10)
-                    .AddChoices([LOAD_API_MANIFEST_PLUGIN, LOAD_ALL_API_MANIFEST_PLUGINS, LOAD_COPILOT_AGENT_PLUGIN, LOAD_ALL_COPILOT_AGENT_PLUGINS, UNLOAD_ALL_PLUGINS, SHOW_COPILOT_AGENT_MANIFEST, EXECUTE_GOAL, LIST_LOADED_PLUGINS, LIST_LOADED_PLUGINS_WITH_FUNCTIONS, LIST_LOADED_PLUGINS_WITH_FUNCTIONS_AND_PARAMETERS, EXIT]));
+                    .AddChoices([LOAD_COPILOT_AGENT_PLUGIN, LOAD_ALL_COPILOT_AGENT_PLUGINS, UNLOAD_ALL_PLUGINS, SHOW_COPILOT_AGENT_MANIFEST, EXECUTE_GOAL, LIST_LOADED_PLUGINS, LIST_LOADED_PLUGINS_WITH_FUNCTIONS, LIST_LOADED_PLUGINS_WITH_FUNCTIONS_AND_PARAMETERS, EXIT]));
 
             switch (selection)
             {

dotnet/samples/Demos/CopilotAgentPlugins/README.md

@@ -0,0 +1,168 @@
+---
+page_type: sample
+languages:
+- dotnet
+products:
+- copilot
+- ms-graph
+- semantic-kernel
+- microsoft-365
+description: The CopilotAgentPluginDemoSample create hand rolled plugins for use in a Semantic Kernel project. The plugins allow for CRUD operations using Microsoft Graph APIs, so that developers can send prompts that will AutoInvokeFunctions to Microsoft365 data, services, and resources.
+extensions:
+  contentType: samples
+  technologies:
+  - Kiota
+  - Semantic Kernel
+  - Microsoft Graph
+  services:
+  - Azure AD
+  - Microsoft 365
+  createdDate: 2/12/2025 4:50:18 AM
+---
+# Copilot Agent Plugins Sample for Semantic Kernel
+
+Sample created and managed by [Fabian G. Williams](https://github.com/fabianwilliams), Principal Product Manager, Microsoft.  We believe that Copilot Agent Plugins (CAPs) empowers developers to effortlessly build AI-driven solutions by transforming natural language into seamless CRUD actions using Microsoft Graph and Semantic Kernel, thus revolutionizing the way we **developers** interact with Microsoft 365 data and innovate.
+
+## Watch the Videos
+
+### Why use Copilot Agent Plugins?
+[![Watch the video](https://img.youtube.com/vi/la1UDNn3eP4/0.jpg)](https://aka.ms/m365caps-videointro)
+
+### Live Demo of CAPs in Action
+[![Watch the video](https://img.youtube.com/vi/-D3KdiPySxw/0.jpg)](https://aka.ms/m365caps-videodemo)
+
+## CAPS Public Roadmap
+
+Our timelines may be subject to changes, at this time our current GA release cycles are
+
+![A screenshot of the CAPs Public Roadmap ](images/CAPs_PublicRoadmap.png)
+
+What to get going? Start your journey below! 
+
+## Use the CopilotAgentPluginDemoSample application to use and create Plugins for Gen AI experiences in Microsoft 365
+
+### Prerequisites
+
+- A Entra ID/ AAD administrator account capable of registering an Application. You can get a development tenant for free by joining the [Microsoft 365 Developer Program](https://developer.microsoft.com/microsoft-365/dev-program).
+- [Visual Studio Code](https://code.visualstudio.com/)
+- [Semantic Kernel](https://github.com/microsoft/semantic-kernel).
+
+### How the sample application works
+
+The sample has the following features:
+
+- This is a Console Application. The user will open a terminal and issue a command "dotnet run demo" or "dotnet run demo --debug" for debug mode. 
+- The user will then be presented with options to leverage platforms of "AzureOpenAI", "OpenAI", or locally with "Ollama" where the LLM is hosted.
+- The user will then determine which Plugins they would like to load for this sample. As of this writing there are 4 available, Contacts, Messages, Calendar, and DriveItems.
+- Once loaded the user will then have options to inspect the Manifest, Plugins, or run a prompt using the "Execute a Goal" option.
+- The user will enter a prompt that satisfies one or more of the plugins they loaded.
+- If a Auth token is not present, the user will be prompted to sign in with their Microsoft 365 account. This demonstrates how to use delegated authentication to run on a user's behalf.
+- The users prompt is reasoned over and a result is returned with a description of the actions taken or data retrieved. This demonstrates how to use app can reason over Microsoft 365 data and synthesize a response or take an action on the users behalf.
+- The user then has the option to issue another prompt load additional plugins, or exit the application.
+
+## Setting up the sample
+
+1. Register a Microsoft Identity platform application, and give it the right permissions.
+1. Create an applications.Development.json file that fits with the pattern in the sample applications.json file that is included in the sample
+
+### Register a Microsoft Identity platform application
+
+#### Choose the tenant where you want to create your app
+
+1. Sign in to the [Azure Active Directory admin center](https://aad.portal.azure.com) using either a work or school account.
+1. If your account is present in more than one Azure AD tenant:
+    1. Select your profile from the menu on the top right corner of the page, and then **Switch directory**.
+    1. Change your session to the Azure AD tenant where you want to create your application.
+
+#### Register the app
+
+This sample for demonstration purposes uses a [Device Code Authentication flow](https://learn.microsoft.com/en-us/entra/identity-platform/msal-authentication-flows#device-code), however you may choose an Authentication Flow that suits your specific scenario. You will need to adjust the Authentication class "BearerAuthenticationProviderWithCancellationToken.cs" if you do so, in order for the sample to work as-is. 
+
+1. Select **Azure Active Directory** in the left-hand navigation, then select [App registrations](https://go.microsoft.com/fwlink/?linkid=2083908) under **Manage**.
+
+    ![A screenshot of the App registrations ](images/aad-portal-app-registrations.png)
+
+1. In creating a  **New Application**.Ensure the below values are set appropriately according to your Authentication Flow. The below is for device code.
+
+    - Provide an appropriate name for your sample and copy down the **Application(client)ID** as well as the  **Directory(tenant)ID** and save them for later.
+
+    ![A screenshot of the Register an application page](images/ApplicationOverViewScreenClientIDetc.png)
+
+    - Set **Supported account types** to **Accounts in this organizational directory only**. This ensures that your App only will authenticate users from this tenant only.
+    - Under **Redirect URI**, ensure the value is set to `http://localhost`.
+
+    ![A screenshot of the RedirectURI an application page](images/AppRegistration_Authentication_localhostredirecturi.png)
+
+1. In **Certificates & secrets** under **Manage**. Select the **New client secret** button. Enter a value in **Description** and select one of the options for **Expires** and select **Add**.
+
+1. Copy the **Value** of the new secret **before** you leave this page. It will never be displayed again. Save the value for later.
+
+    ![A screenshot of a new secret in the Client secrets list](images/AppRegistration_AppSecret.png)
+
+1. Under **API permissions** under **Manage**.
+
+1. In the list of pages for the app, select **API permissions**, then select **Add a permission**.
+
+1. In this sample we selected the delegated permissions you see below. In order for the hand rolled plugins to work, at a minimum you will need to ensure that the Mail, Calendar, Files, and Contacts are selected as shown, with at least Read Permissions.
+
+1. Make sure that the **Microsoft APIs** tab is selected, then select **Microsoft Graph**.
+
+1. Select **Application permissions**, then find and enable your desired permissions.
+
+    > **Note:** To create subscriptions for other resources you need to select different permissions as documented [here](https://docs.microsoft.com/graph/api/subscription-post-subscriptions#permissions)
+
+1. Select **Grant admin consent for `name of your organization`** and **Yes**. This grants consent to the permissions of the application registration you just created to the current organization.
+
+    ![A screenshot of a new secret in the Client secrets list](images/AppRegistration_APIPermissions.png)
+
+
+### Update appsettings Development File
+
+1. Rename the [appsettings.json](CopilotAgentPluginsDemoSample/appsettings.json) file to `appsettings.Development.json`. Open the file in Visual Studio code or any text editor.
+
+1. Update the following values.
+
+    - `TenantId`: set to the tenant ID from your app registration
+    - `ClientId`: set to the client ID from your app registration
+    - `ClientSecret`: set to the client secret from your app registration
+    - `RedirectUri`: set to the http://localhost
+    - `OpenAI`: if you are using OpenAI as your LLM provider ensure that the
+    - `ApiKey` : is filled out
+    - `ModelId` : is filled out
+    - `AzureOpenAI` : if you are using AzureOpenAI as your LLM provider ensure that the
+    - `ChatModelId` : is filled out
+    - `ChatDeploymentName` : is filled out
+    - `Endpoint` : is filled out
+    - `ApiKey` : is filled out
+
+### Start the application
+
+Open the repository with Visual Studio Code. Open a **New Terminal** and type.
+
+To run without Debug Mode type:
+
+```shell
+dotnet run demo
+```
+
+To run with Debug Mode type:
+
+```shell
+dotnet run demo --debug
+```
+
+Then follow the instructions provided.
+
+## Troubleshooting
+
+See the dedicated [troubleshooting page](./TROUBLESHOOTING.md).
+
+## Questions and comments
+
+We'd love to get your feedback about the Copilot Agent Plugins sample for Semantic Kernel. You can send your questions and suggestions to us in the [Issues](https://github.com/microsoft/semantic-kernel/issues) section of this repository.
+
+Questions about Microsoft Graph in general should be posted to [Microsoft Q&A](https://docs.microsoft.com/answers/products/graph). Make sure that your questions or comments are tagged with the relevant Microsoft Graph tag.
+
+## Additional resources
+
+- [Microsoft Graph documentation](https://docs.microsoft.com/graph)

dotnet/samples/Demos/CopilotAgentPlugins/TROUBLESHOOTING.md

@@ -0,0 +1,11 @@
+# Troubleshooting
+
+This document covers some of the common issues you may encounter when running this sample.
+
+## You get a 403 Forbidden response when you attempt to create a subscription
+
+Make sure that your app registration includes the required permission for Microsoft Graph (as described in the [Register the app](README.md#register-the-app) section). 
+
+## You get a build error when you issue dotnet run demo command
+
+Ensure that you have copied the appsettings.json file into a new or renamed appsettings.Development.json file as directed in the [Update appsettings.Development.json](README.md#update-appsettings-development-file)