Atlassian Jira Cloud Copilot コネクタをデプロイする

Atlassian Jira Cloud Microsoft 365 Copilot コネクタを使用すると、organizationで Jira の問題のインデックスを作成できます。 Jira サイトからコネクタとインデックス コンテンツを構成した後、ユーザーは Microsoft Search と Microsoft 365 Copilot エクスペリエンスでそれらのアイテムを検索できます。

この記事では、Atlassian Jira Cloud コネクタをデプロイしてカスタマイズする手順について説明します。

Jira Cloud サービスの構成情報については、「 コネクタ インジェスト用に Jira Cloud サービスを設定する」を参照してください。

前提条件

Atlassian Jira Cloud コネクタをデプロイする前に、organizationで Jira Cloud 環境が構成されていることを確認してください。 次の表は、Jira Cloud 環境を構成し、コネクタをデプロイする手順をまとめたものです。

コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。

• organizationの Microsoft 365 テナントの検索管理者である必要があります。
• organizationの Jira Cloud インスタンス URL がわかっていることを確認します。 Jira データに接続するには、organizationの Jira インスタンス URL が必要です。
• Jira に接続し、Atlassian Jira Cloud Copilot コネクタが定期的に問題を更新できるようにするには、次のアクセス許可が付与されたサービス アカウントが必要です。

コネクタをデプロイする

organizationの Atlassian Jira Cloud コネクタを追加するには、

1. Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
2. [ コネクタ ] タブに移動し、左側のウィンドウで [ ギャラリー] を選択します。
3. 使用可能なコネクタの一覧から、[ Atlassian Jira Cloud] を選択します。

表示名を設定する

表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 表示名は信頼されたコンテンツも示し、コンテンツ ソース フィルターとして使用されます。

既定の Atlassian Jira Cloud の表示名をそのまま使用することも、organizationのユーザーが認識する表示名を使用するように値をカスタマイズすることもできます。

コネクタの表示名と説明の詳細については、「Microsoft 365 Copilot コネクタ コンテンツを使用した Copilot 検出の強化」を参照してください。

インスタンス URL の設定

Jira クラウド データに接続するには、organizationの Jira インスタンス URL が必要です。 organizationの Jira インスタンス URL は、通常、次のようになります: https://<your-organization-domain>.atlassian.net。

インスタンスがまだない場合は、「 Atlassian Jira 」を参照してテスト インスタンスを作成します。

認証の種類を選択する

Jira から問題を認証して同期するには、次のサポートされている認証方法のいずれかを選択します。

• 基本認証 - 基本 認証を使用して認証するアカウントのユーザー名 (通常は電子メール ID) と API トークンを入力します。API トークンを生成する方法については、「 Atlassian アカウントの API トークンを管理する」を参照してください。

• Atlassian Jira OAuth 2.0 (推奨) - 認証に Jira OAuth を使用するには:

  1. Atlassian Jira にアプリを登録して、Microsoft Search アプリとMicrosoft 365 Copilotがインスタンスにアクセスできるようにします。 詳細については、「 OAuth 2.0 を有効にする」を参照してください。
  2. Atlassian Jira 管理者アカウントで Atlassian Developer コンソール にサインインします。
  3. [ 作成 ] を選択し、[ OAuth 2.0 integration]\(OAuth 2.0 統合\) を選択します。
  4. アプリケーションに適切な名前を指定し、新しいアプリを作成します。
  5. 左側のナビゲーション ウィンドウから [ アクセス許可] に移動します。 [Add for Jira API]\(Jira API の追加\) を選択し、[構成] を選択します。 [ 詳細なアクセス許可] で、必要なスコープを追加します。
  6. 左側のナビゲーション ウィンドウから [承認] に移動し、コールバック URL を追加します。
     1. Microsoft 365 Enterpriseの場合:https://gcs.office.com/v1.0/admin/oauth/callback
     2. Microsoft 365 Government の場合: https://gcsgcc.office.com/v1.0/admin/oauth/callback
  7. 保存] を選択します。
  8. 左側のウィンドウの [設定] に移動して、クライアント ID とシークレットを取得します。 [クライアント ID] と [シークレット] を使用して、接続設定の手順を完了します。

ロールアウト

制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。 詳細については、「Microsoft 365 Copilot コネクタの段階的ロールアウト」を参照してください。

[ 作成] を 選択して接続をデプロイします。 Atlassian Jira Cloud Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。

コネクタの既定値を次に示します。

Users

• アクセス許可: データ ソース内のコンテンツにアクセスできるユーザーのみ。
• マップ ID: Microsoft Entra ID を使用してマップされたデータ ソース ID。

Content

• サイト プロジェクト: すべてのプロジェクトにインデックスが作成されます。
• フィルター データ: すべての問題にインデックスが作成されます。 時間フィルターまたは JQL 条件は適用されません。
• プロパティの管理: 既定のプロパティとそのスキーマをチェックするには、「コンテンツ設定のカスタマイズ」を参照してください。

Sync

• 増分クロール: 頻度: 15 分ごと
• フル クロール: 頻度: 毎日

接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。

設定のカスタマイズ (省略可能)

Atlassian Jira Cloud コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。

ユーザー設定をカスタマイズする

アクセス許可

Atlassian Jira Cloud Copilot コネクタでは、このデータ ソースへのアクセス権を持つすべてのユーザーまたはユーザーにのみ表示される検索アクセス許可がサポートされています。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースにアクセスできるユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示されます。 Atlassian Jira では、サイト レベルのグループとプロジェクト ロールを含むプロジェクト権限スキームを使用してセキュリティアクセス許可が定義されます。 問題レベルのセキュリティは、問題レベルのアクセス許可スキームを使用して定義することもできます。

ID のマッピング

Microsoft Entra IDを使用してデータ ソース ID をマッピングする既定の方法は、Jira ユーザーの電子メール ID を、Microsoft Entra IDのユーザーのユーザー プリンシパル名 (UPN) または電子メール アドレスと同じにすることです。 既定のマッピングがorganizationに対して機能しない場合は、カスタム マッピング式を指定できます。 詳細については、「Azure以外の AD ID をマップする」を参照してください。

• Jira ユーザーの電子メール ID が Microsoft Entra ID のユーザーの UPN と同じである場合は、Microsoft Entra ID オプションを選択します。
• Jira ユーザーの電子メール ID が Entra ID の UPN およびユーザーの電子メールと異なる場合は、[非Microsoft Entra ID] オプションを選択します。

コンテンツ設定をカスタマイズする

プロジェクトの選択とデータのフィルター処理

• サイト プロジェクト: 接続に対して、Jira サイト全体または特定のプロジェクトのみにインデックスを付けることができます。
  • Jira サイト全体にインデックスを付ける場合、サイト上のすべてのプロジェクトの Jira の問題にインデックスが作成されます。 新しいプロジェクトと問題は、作成後の次のクロール中にインデックスが作成されます。
  • 個々のプロジェクトを選択すると、選択したプロジェクトの Jira Issue のみがインデックス付けされます。

• データのフィルター処理: 次の 2 つの方法でインデックスが作成された Jira の問題をフィルター処理できます。
  • 問題が 変更された期間を指定します。 このオプションは、現在のクロールに基づいて ローリングベース で選択された期間内に作成または変更された Jira の問題にのみインデックスを付けます。
  • JQL フィルターを使用して、 issueType in (Bug, Improvement)を使用して特定の Jira の問題の種類にのみインデックスを付けます。

プロパティの管理

使用可能なプロパティを Jira データ ソースに追加または削除し、スキーマをプロパティに割り当てます (プロパティが検索可能、クエリ可能、取得可能、またはリファイン可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加できます。 次の表に、既定で選択されているプロパティの一覧を示します。

データのプレビュー

プレビュー結果ボタンを使用して、選択したプロパティとクエリ フィルターのサンプル値を確認します。

同期間隔をカスタマイズする

更新間隔によって、データ ソースと Atlassian Jira Cloud Copilot コネクタ インデックスの間でデータが同期される頻度が決まります。 次の 2 種類の更新間隔を示します。

• 増分クロール: 15 分ごとに
• フル クロール: 毎日

更新間隔の既定値を変更できます。 詳細については、「 同期設定のガイドライン」を参照してください。

関連コンテンツ

• Atlassian Jira Cloud コネクタの概要
• Atlassian Jira Cloud コネクタに関する問題のトラブルシューティング
• Microsoft 365 管理センターで Copilot コネクタを設定する