Jira plugin open api

samples/dotnet/kernel-syntax-examples/Example22_OpenApiSkill.cs → samples/dotnet/kernel-syntax-examples/Example22_OpenApiSkill_AzureKeyVault.cs

@@ -9,7 +9,7 @@
 using RepoUtils;
 
 // ReSharper disable once InconsistentNaming
-public static class Example22_OpenApiSkill
+public static class Example22_OpenApiSkill_AzureKeyVault
 {
     public static async Task RunAsync()
     {

samples/dotnet/kernel-syntax-examples/Example22_OpenApiSkill_Jira.cs

@@ -0,0 +1,76 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Net.Http.Headers;
+using System.Text;
+using System.Threading.Tasks;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Connectors.WebApi.Rest;
+using Microsoft.SemanticKernel.Orchestration;
+using Microsoft.SemanticKernel.Skills.OpenAPI.Authentication;
+using Microsoft.SemanticKernel.Skills.OpenAPI.Skills;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+using RepoUtils;
+
+public static class Example22_OpenApiSkill_Jira
+{
+    public static async Task RunAsync()
+    {
+        var kernel = new KernelBuilder().WithLogger(ConsoleLogger.Log).Build();
+        var contextVariables = new ContextVariables();
+
+        // Change <your-domain> to a jira instance you have access to with your authentication credentials
+        string serverUrl = "https://<your-domain>.atlassian.net/rest/api/latest/";
+        contextVariables.Set("server-url", serverUrl);
+
+        IDictionary<string, ISKFunction> jiraSkills;
+        var tokenProvider = new BasicAuthenticationProvider(() =>
+        {
+            string s = Env.Var("MY_EMAIL_ADDRESS") + ":" + Env.Var("JIRA_API_KEY");
+            return Task.FromResult(s);
+        });
+
+        // The bool useLocalFile can be used to toggle the ingestion method for the openapi schema between a file path and a URL
+        bool useLocalFile = true;
+        if (useLocalFile)
+        {
+            var apiSkillFile = "./../../../Skills/JiraSkill/openapi.json";
+            jiraSkills = await kernel.ImportOpenApiSkillFromFileAsync("jiraSkills", apiSkillFile, tokenProvider.AuthenticateRequestAsync);
+        }
+        else
+        {
+            var apiSkillRawFileURL = new Uri("https://raw.githubusercontent.com/microsoft/PowerPlatformConnectors/dev/certified-connectors/JIRA/apiDefinition.swagger.json");
+            jiraSkills = await kernel.ImportOpenApiSkillFromUrlAsync("jiraSkills", apiSkillRawFileURL, null, tokenProvider.AuthenticateRequestAsync);
+        }
+
+        // GetIssue Skill
+        {
+            //Set Properties for the Get Issue operation in the openAPI.swagger.json 
+            contextVariables.Set("issueKey", "SKTES-2");
+
+            //Run operation via the semantic kernel
+            var result = await kernel.RunAsync(contextVariables, jiraSkills["GetIssue"]);
+
+            Console.WriteLine("\n\n\n");
+            var formattedContent = JsonConvert.SerializeObject(JsonConvert.DeserializeObject(result.Result), Formatting.Indented);
+            Console.WriteLine("GetIssue jiraSkills response: \n{0}", formattedContent);
+        }
+
+        // AddComment Skill
+        {
+            //Set Properties for the AddComment operation in the openAPI.swagger.json 
+            contextVariables.Set("issueKey", "SKTES-1");
+            contextVariables.Set("body", "Here is a rad comment");
+
+            //Run operation via the semantic kernel
+            var result = await kernel.RunAsync(contextVariables, jiraSkills["AddComment"]);
+
+            Console.WriteLine("\n\n\n");
+            var formattedContent = JsonConvert.SerializeObject(JsonConvert.DeserializeObject(result.Result), Formatting.Indented);
+            Console.WriteLine("AddComment jiraSkills response: \n{0}", formattedContent);
+        }
+    }
+}

samples/dotnet/kernel-syntax-examples/Program.cs

@@ -71,7 +71,10 @@ public static async Task Main()
         await Example21_ChatGptPlugins.RunAsync();
         Console.WriteLine("== DONE ==");
 
-        await Example22_OpenApiSkill.RunAsync();
+        await Example22_OpenApiSkill_AzureKeyVault.RunAsync();
+        Console.WriteLine("== DONE ==");
+
+        await Example22_OpenApiSkill_Jira.RunAsync();
         Console.WriteLine("== DONE ==");
 
         await Example23_ReadOnlyMemoryStore.RunAsync();