Amazon Q Business ApplicationとJiraを連携してみた

# はじめに
re:Invent 2023で登場したAmazon Q Business Applicationについて、Adamの基調講演内でデモが紹介されました。その映像の中で、チャット上でチケットの作成を要求するとJiraの設定画面が表示されていました。

本記事では、Amazon Qのプラグインの機能を利用し、Jiraと連携する方法を紹介します。

# 設定方法
今回は既存のアプリケーションにJiraを連携させます。アプリケーションの作成方法は[こちら](https://qiita.com/Neville/items/8bc10b1b7a29faae1c6b)の投稿を参考にしてください。

## 1. Jiraの設定
JiraはFreeプランを利用しました。Googleアカウントは連携せず、メールアドレスを設定し登録しています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/6878d596-8c22-9876-6f5a-90c74857436e.png)

初期登録完了後、任意のプロジェクトを作成し、URL「https://xxx.attrassian.net (xxx部分は設定により異なる)」の情報をメモしてください。

Amazon Qの設定では上記URLに加え、APIトークンの情報が必要となります。
以下ATTLASOANアカウントの設定ページより作成します。

https://id.atlassian.com/manage-profile/security/api-tokens

「Create API token」を押下します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/7bf3bfe4-ea25-6ed1-405b-b6d3651aa8ed.png)


ラベルは判別可能な任意の値を入力し、「Create」を押下してください。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/4b521384-fae5-e5b9-1e76-8272ed11891a.png)


API tokenが表示されますので、コピーしてメモ帳などに張り付けてください。画面を消すと、確認することができなくなるため、再作成が必要です。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/3e651b0c-bcb2-fa77-f116-ba202a8b693c.png)



## 2. Amazon Qの設定

AWSマネジメントコンソール上で、Amazon Qの設定画面を開きます。「Applications」より作成したアプリケーションを選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/ee772f91-3580-cdfa-ff04-807e5a8285a9.png)


左ペインより「Plugins」を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/32dadcf4-8bcc-33fc-821f-249be82980c3.png)

「Add Plugin」を押下します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/cf3b92c1-b2af-a5c8-019b-874f05e5ccc7.png)

2023年12月末時点で、以下の4つのサービスが選択可能です。
* ServiceNow：インシデント作成が可能
* Jira：イシュー作成が可能
* Salesforce：ケース作成が可能
* Zendesk：チケット作成が可能

今回はJiraを選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/69ecb63e-3cc5-f68b-9cf7-a1ac0afadaf4.png)


「Service access」は、「Create and use a new service role」を選択します。URLは先ほどメモしたJiraのURLを入力してください。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/e2889166-a9c0-488b-38c2-efc730404d43.png)


「Authentication」でJiraのログイン情報を入力します。「Choose an option」で「Create and add new secret」を選択し、AWS Secrets Managerのシークレットを設定します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/a065a2e2-251d-0a90-d921-e38547674217.png)

「Secret name」は、「QBusiness-Jira-」から始まるよう設定します。「Jira username」は、Jiraアカウントのユーザ名(メールアドレス)を入力します。「API token」は先ほどコピーしたJiraのトークンを入力します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/0a651c78-d9c6-d4f5-2986-d0357833b55e.png)

作成したシークレットを選択したら、「Add」を押下し設定は完了です。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/6e7ee56c-2229-f43d-ac78-50ef321dda59.png)


## 3. 動作確認
「Preview web experience」を押下し、Jiraと連携されているか確認しましょう。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/56501efd-b6cf-6406-8dc5-9706054dd04d.png)


「I want to create issue」と入力すると、イシューの起票画面が開きます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/38fe92ca-2d38-8252-edb5-e6bfd768c40f.png)

プロジェクト、サマリー、連絡先のメールアドレスを入力し、「Create」を押下します。今回はFreeプランのため、優先度を設定するとエラーとなります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/b927e05f-ccb9-4c03-a2ae-865babe191f1.png)


イシューの作成が完了したと返答があるため、記載されているURLにアクセスします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/99bf3a4d-f03c-81ff-78e2-26147d9b9f57.png)

確かにJira上でイシューが作成されていました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3665293/c3b1f1e2-0d39-4565-eb3f-59c0d93c6e5a.png)

# 最後に
現在はイシューの作成のみ可能で、他の操作は対応していないため、利用はかなり限定的になります。今後のアップデートにより、さらに利便性が向上することを期待します。