目录
一、Jira与Azure OpenAI介绍
二、Jira和Azure OpenAI的REST API对接
三、利用Chats插件实现对话的过程
四、总结
Jira是一款由澳大利亚公司Atlassian开发的项目管理工具,主要用于追踪问题、管理需求、构建报告和管理故障等事项。Jira被广泛应用于软件开发、敏捷项目管理、IT服务管理和业务流程管理等领域。Jira支持插件扩展,可扩展不同类型的项目管理工作。
Azure OpenAI是由微软提供的基于云计算的自然语言处理平台。这个平台通过领先的NLP模型和工具,为各种用户提供了一系列功能,包括但不限于语音转文本、文本翻译、自动摘要、实体识别、情感分析和语义分析等。这些功能都是由最先进的AI技术驱动的,旨在提高人工智能与人类之间的交互流畅程度,并为企业提供高效的智能化解决方案。
Jira的插件扩展功能提供了一个很好的平台,允许开发人员创建自定义功能插件来扩展Jira的功能。因此,如果想要将Azure OpenAI集成到Jira中,我们可以利用Jira插件系统开发一个插件,插件通过REST API与Azure OpenAI交互,并响应用户的提问。
在Jira和Azure OpenAI集成前,我们需要创建Azure账户并申请一个Azure OpenAI资源,申请完成后可以获得一个有效的API密钥。
然后我们选取一个AI模型(本文以GPT-35-turbo为例),创建并发布成功后就可以使用了。
本文通过调用Azure OpenAI服务提供的Chat completions接口,向OpenAI模型发出自然语言查询,并获得模型的自动完成功能,实现了一个简单的例子。
具体流程为:将用户提出的问题封装成报文,向Chat completions 接口发送POST请求,Azure OpenAI模型会自动完成语句并返回一个答案。
private String doChatCompletions(String content) {
if (StringUtils.isEmpty(content)) {
return "";
}
String resourceName = "aoai-5";
String deploymentId = "jiraChatGpt";
String apiKey = "YOUR_API_KEY";
String chatCompletions = AzureOpenAiUtil.chatCompletions(resourceName, deploymentId, apiKey, content);
return getChatCompletionsContent(chatCompletions);
}
/**
* Create completions for chat messages with the ChatGPT and GPT-4 models.
* @param resourceName
* @param deploymentId
* @param apiKey
* @param content
* @return
*/
public static String chatCompletions(String resourceName, String deploymentId, String apiKey, String content) {
String url = getUrl(resourceName, CHAT_COMPLETIONS_URL, deploymentId, API_VERSION_2023_03_15_PREVIEW);
List jsonObjectList = new ArrayList<>();
JSONObject jsonMessages = new JSONObject();
JSONObject jsonObject = new JSONObject();
try {
jsonObject.put("role", "user");
jsonObject.put("content", content);
jsonObjectList.add(jsonObject);
jsonMessages.put("messages", jsonObjectList);
} catch (JSONException e) {
LOG.warn(e);
}
return sendPostRequest(apiKey, url, jsonMessages.toString());
}
Chats是一款Jira插件,可用于在Jira用户之间进行聊天。使用Chats插件,在Jira用户之间创建或加入一个聊天窗口,这样用户可以快速交换信息和协作。
如果将Azure OpenAI集成到Chats中,则可以将OpenAI自动完成的语句转换为聊天消息,并在聊天过程中进行实时转发,实现自动化对话。
为了演示如何将Azure OpenAI集成到Jira的Chats插件中,我基于Jira和Azure OpenAI开发了一个样例插件,插件将使用上一节封装的Chat completions接口和Azure OpenAI模型进行对话。
Chats插件对话的实质是在Issue上添加评论,这里利用Jira自带的WebHooks监听器,监听创建评论(Comment created)事件来触发Azure OpenAI接口的调用流程。
最后将Chat completions接口返回的语句,添加到Issue的评论里,实现聊天对话过程。
public Long createComment(String issueKey, String postBody) throws IOException,JSONException {
HashMap map = new HashMap<>();
map.put("Authorization", "Basic " + BASE64.encodeToString(Const.JIRAUSER.getBytes(StandardCharsets.UTF_8)));
String url = Const.JIRAURL + "/rest/api/2/issue/" + issueKey + "/comment";
String comment = RestApiUtil.sendPostRequest(url, postBody, map);
JSONObject commentObj = new JSONObject(comment);
return commentObj.getLong("id");
}
PS:防止死循环,忽略AI身份admin用户的评论。
本文介绍了如何将Jira和Azure OpenAI集成,以实现自然语言处理功能。通过Jira插件和Azure OpenAI 的REST API将Azure OpenAI集成到Jira中,利用Jira的WebHooks监听器和Chats插件实现自动化对话的过程。
希望这篇文章能够帮助大家更好地了解Jira和Azure OpenAI,并帮助大家在实践中使用这两款产品。
作者:李其仿 | 资深后端开发工程师
版权声明:本文由神州数码云基地团队整理撰写,若转载请注明出处。
公众号搜索神州数码云基地,了解更多AI相关技术干货。