semantic-kernel/samples/dotnet/MsGraphPluginsExample

Graph API Plugin Example

Important

This sample will be removed in a future release. If you are looking for samples that demonstrate how to use Semantic Kernel, please refer to the sample folders in the root python and dotnet folders.

This example program demonstrates how to use the Microsoft Graph API plugins with the Semantic Kernel.

Setup

1. Create an appsettings.Development.json file next to appsettings.json.
   • The appsettings.Development.json file should be ignored by git and will not be checked in by default.
2. Set your API Keys
   • This example can use either Azure OpenAI or OpenAI models for summarization.
   • In your appsettings.Development.json fill out the OpenAI and/or AzureOpenAI sections with a unique service id and your API key (you can use any service id, it's only a string that allows to distinguish multiple services).
3. If you have not already, register an application with the Microsoft identity platform.
   • Select Mobile and desktop applications as platform type, and the Redirect URI will be http://localhost
   • It is recommended you use the Personal Microsoft accounts account type for this sample.
   • Make sure the API permissions include the scopes outines in your appsettings.json (e.g. Mail.Send, ...).
4. Update the MsGraph sections in your appsettings.json with your application registrations IDs and parameters.
5. Update the OneDrivePathToFile to point to a text file that exists in your OneDrive.
   • This file will be used as content to summarize in the example.

Example appsettings.Development.json:

{
  "MsGraph": {
    "ClientId": "YOUR_APPLICATION_CLIENTID",
    "RedirectUri": "http://localhost"
  },
  "OneDrivePathToFile": "Documents/MyFile.txt",
  "OpenAI": {
    "ServiceId": "gpt-3.5-turbo",
    "ApiKey": "YOUR_OPENAPI_KEY"
  },
  "AzureOpenAI": {
    "ServiceId": "gpt-35-turbo",
    "DeploymentName": "gpt-35-turbo",
    "Endpoint": "YOUR_AZURE_OPENAI_ENDPOINT (e.g. https://contoso.openai.azure.com/",
    "ApiKey": "YOUR_AZURE_OPENAPI_KEY"
  }
}