Jira Cloud データストアを設定する

公開プレビュー版: 統合検索とアクションの機能は公開プレビュー版です。この機能は、サービス固有規約の一般サービス規約セクションに記載されている「pre-GA サービス規約」の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。詳細については、リリース ステージの説明をご覧ください。

このページでは、データストアを作成して Jira Cloud を Gemini Enterprise に接続する方法について説明します。

始める前に

Jira Cloud 連携接続を設定する前に、次のことを確認してください。

• ディスカバリー エンジン編集者ロール（roles/discoveryengine.editor）を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。

  1. Google Cloud コンソールで、[IAM] ページに移動します。

     [IAM] に移動

  2. ユーザー アカウントを見つけて、編集 [編集] アイコンをクリックします。
  3. ユーザーに Discovery Engine Editor ロールを付与します。 詳細については、IAM のロールと権限をご覧ください。

• Google Gemini Enterprise でデータソースのアクセス制御を適用してデータを保護するには、ID プロバイダを構成します。

• Jira Cloud コネクタを設定するには、新しい一元化された Atlassian ユーザー管理モデルを使用する必要があります。元のモデルを使用している場合は、続行する前にユーザー管理を移行する必要があります。詳細については、サイト管理者ロールをご覧ください。

• OAuth 2.0 アプリを作成し、クライアント ID とシークレットを取得して、Jira Cloud 管理者の同意を得て最小限のアプリケーション権限を構成します。Jira インスタンスとプロジェクトに対する Jira 組織管理者のアクセス権があることを確認します。組織管理者のアクセス権を使用すると、最小限の権限を設定し、ユーザー グループにアクセス権限を付与できます。

• 省略可: 設定でメールアドレスの公開が制限されている場合でも、Jira Cloud からユーザーのメールアドレスを取得するには、Jira のサイト管理者権限で User Identity Accessor for Jira Cloud アプリをインストールし、ユーザーのメールアドレスを安全に取得するようにアプリを構成します。メールアドレスがすでに一般公開されている場合は、このアプリをインストールする必要はありません。

  注: Atlassian はユーザー インターフェース要素を更新しており、このドキュメントに記載されている一部の要素の名前が変更されています（たとえば、プロダクトはアプリに変更されています）。詳しくは、Atlassian 管理の用語が「プロダクト」から「アプリ」に変更をご覧ください。

Jira Cloud データストアを作成する

Jira Cloud データストアを作成する手順は次のとおりです。

1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

   Gemini Enterprise

2. Google Cloud プロジェクトを選択するか作成します。

   注: 統合フローにアクセスするには、プロジェクトが許可リストに登録されている必要があります。

3. ナビゲーション メニューで [データストア] をクリックします。

4. [データストアを作成] をクリックします。

5. [ソース] セクションで [Jira Cloud] を検索し、[選択] をクリックします。

6. [データ] セクションで、次の操作を行います。

   1. [コネクタモード] セクションで、接続モードとして [データの取り込み] または [フェデレーション検索] を選択します。

   2. [続行] をクリックします。

   3. [認証の設定] セクションで、選択した接続モードに基づいて認証を構成します。

      1. 次の認証情報を入力します。

         • クライアント ID
         • クライアント シークレット
         • インスタンス URI
         • インスタンス ID

         認証情報の詳細については、Jira Cloud の構成をご覧ください。

      2. [フェデレーション検索] を選択した場合は、[ログイン] をクリックして Atlassian のログインを完了します。

      3. [続行] をクリックします。

   4. [宛先] セクションに、Jira Cloud エンドポイントの URL を入力します。

   5. [続行] をクリックします。

   6. [検索するエンティティ] セクション（[フェデレーション検索] を選択した場合）または [同期するエンティティ] セクション（[データの取り込み] を選択した場合）で、次の操作を行います。

      1. 必要なエンティティをすべて選択します。
      2. [連携検索] を選択した場合は、次の手順に進みます。
      3. [データの取り込み] を選択した場合は、次の手順を行います。
         1. 省略可: 特定のプロジェクトを同期するには、次の操作を行います。
            1. [フィルタ] をクリックします。
            2. インデックスからエンティティをフィルタで除外するには、[インデックスから除外する] チェックボックスをオンにします。インデックスにエンティティが含まれるようにするには、[インデックスに含める] チェックボックスをオンにします。
            3. 鍵を入力します。鍵を入力するごとに Enter キーを押します。
            4. [保存] をクリックします。
         2. 同期スケジュールを構成するには、次の操作を行います。
            1. [同期頻度] リストで、同期の頻度を選択します。
               • エンティティ データと ID データの完全同期を個別にスケジュール設定するには、[完全同期] セクションのメニューを開き、[カスタム オプション] を選択します。
            2. [増分同期の頻度] リストで、増分同期の頻度を選択します。詳細については、同期スケジュールをご覧ください。

7. [続行] をクリックします。

8. [アクション] セクションで、次の操作を行います。

   1. [フェデレーション検索] を選択した場合:
      1. [有効にする Jira Cloud アクションを選択] で、カテゴリからアクションを選択して、コネクタで有効にします。

   2. [データの取り込み] を選択した場合:

      1. [認証の設定] セクションで、選択した接続モードに基づいて認証を構成します。

      2. 次の認証情報を入力します。

         • クライアント ID
         • Client Secret
         • インスタンス URI
         • インスタンス ID

         認証情報の詳細については、Jira Cloud の構成をご覧ください。

      3. [ログイン] をクリックして Jira Cloud にログインし、アカウントを確認します。

      4. [続行] をクリックします。

      5. [有効にする Jira Cloud アクションを選択] で、カテゴリからアクションを選択して、コネクタで有効にします。

      注: このステップでアクションの追加をスキップした場合は、アクションを追加するために新しいデータストアを作成する必要があります。アクションのリストを表示するには、アクションを表示するをご覧ください。

9. [構成] セクションで、次の操作を行います。

   1. [マルチリージョン] リストから、データコネクタのロケーションを選択します。
   2. [データコネクタ名] フィールドに、コネクタの名前を入力します。
   3. ロケーションとして US または EU を選択した場合は、暗号化設定を行います。
      • 省略可: 単一リージョンの鍵を構成していない場合は、[設定ページに移動] をクリックして構成します。詳細については、サードパーティ コネクタの単一リージョンの鍵を登録するをご覧ください。
      • [Google管理の暗号鍵] または [Cloud KMS 鍵] を選択します。
      • [Cloud KMS 鍵] を選択した場合:
        • [鍵管理のタイプ] リストで、適切なタイプを選択します。
        • [Cloud KMS 鍵] リストで、鍵を選択します。
      詳細については、顧客管理の暗号鍵をご覧ください。

10. [続行] をクリックします。

11. [お支払い] セクションで、[全般的な料金] または [構成可能な料金] を選択します。詳細については、プロジェクトの課金ステータスを確認するとライセンスをご覧ください。

12. [作成] をクリックします。Gemini Enterprise によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

[データストア] ページで、データストア名をクリックしてステータスを確認します。データストアの状態が [作成中] から [アクティブ] に変わると、Jira Cloud コネクタを使用できるようになります。

Jira Cloud で作成された取り込みコネクタの場合、同期が開始されると、データストアの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、[アクティブ] に変わり、データストアが完全に構成されたことを示します。データ量によっては、取り込みに数時間かかることがあります。

データストアを作成したら、アプリを作成し、Jira Cloud データストアに接続して、クエリを実行する前に Gemini Enterprise が Jira Cloud にアクセスできるように承認します。

データの取り込みのリアルタイム同期を有効にする

プレビュー版 - Real-time sync

この機能は、 サービス固有の規約の対象となります。 pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

リアルタイム同期では、ドキュメント エンティティのみが同期され、ID エンティティに関連するデータは同期されません。次の表に、リアルタイム同期でサポートされているドキュメント イベントを示します。

Jira エンティティ	作成	更新	削除	権限の変更
問題
ワークログ
プロジェクト
コメント
添付ファイル

Jira Cloud データソース コネクタのリアルタイム同期を有効にする手順は次のとおりです。

Webhook URL を生成する

1. [Gemini Enterprise] ページに移動し、ナビゲーション メニューで [データストア] をクリックします。
2. Jira Cloud データストアを選択します。

3. [リアルタイム同期] 行で、[表示 / 編集] をクリックします。

4. [リアルタイム同期パラメータの表示と編集] ダイアログで、次の操作を行います。

   1. リアルタイム同期を有効にするには、[リアルタイム同期を有効にする] 切り替えボタンをクリックします。
   2. [クライアント シークレット] フィールドに値を入力してコピーします。この値は、Jira 管理コンソールで Webhook を作成するときに再度必要になります。
   3. [保存] をクリックします。

5. [リアルタイム同期] のステータスが Running に変わったら、[表示 / 編集] をクリックします。

6. [リアルタイム同期パラメータの表示と編集] ダイアログで、次の操作を行います。

   1. [Webhook URL] の値をコピーします。
   2. [閉じる] をクリックします。

Webhook を作成する

1. Jira 管理コンソールにログインします。
2. [Settings] をクリックし、[System] を選択します。
3. [System settings] ペインで、[Webhook] を選択します。
4. [Create a webhook] をクリックします。Webhook については、Webhook をご覧ください。
5. Webhook の名前を入力します。
6. [Status] として Enabled を選択します。
7. [URL] フィールドに、Gemini Enterprise からコピーした URL を貼り付け、/{issue.id} を追加します。

8. [シークレット] フィールドに、Gemini Enterprise で Webhook URL を生成したときに入力したのと同じ値を入力します。

   注: Jira で Webhook を構成する際にデータの整合性を確認してエラーを防ぐには、データストアで同期が有効になっているエンティティのみを選択します。

9. [Issue related events] セクションで、次のオプションを選択します。

   エンティティ	作成日時	更新済み	削除済み
   問題	はい	はい	はい
   ワークログ	はい	はい	はい
   コメント	はい	はい	はい
   添付ファイル	はい	いいえ	はい

10. [プロジェクト関連のイベント] セクションで、プロジェクト エンティティの [作成済み]、[更新済み]、[削除済み] のチェックボックスをオンにします。

11. [作成] をクリックします。

データの取り扱いとクエリの実行

このセクションでは、Gemini Enterprise がクエリを管理する方法と、フェデレーション データストアの使用によるプライバシーへの潜在的な影響について説明します。

クエリ実行

Jira Cloud を承認し、Gemini Enterprise に検索クエリを送信すると、次のようになります。

• Gemini Enterprise は、検索クエリを Atlassian API に直接送信します。
• Gemini Enterprise は、結果を他の接続されたデータソースからの結果と統合して、包括的な検索結果を表示します。

データの取り扱い

サードパーティのフェデレーション検索を使用する場合、次のデータ処理ルールが適用されます。

• クエリ文字列がサードパーティの検索バックエンド（Atlassian API）に送信されます。
• これらのサードパーティは、クエリをユーザーの ID に関連付ける場合があります。
• 複数のフェデレーション検索データソースが有効になっている場合、クエリはそれらすべてに送信されることがあります。
• データがサードパーティ システムに到達すると、そのシステムの利用規約とプライバシー ポリシーが適用されます。

注: 精度を高めるため、クエリが Jira Cloud に送信される前に、LLM がクエリを書き換えることがあります。この書き換えられたクエリには、セッションのクエリ履歴の情報が組み込まれることがあります。その結果、クエリ履歴の一部が Atlassian API に送信されるクエリに含まれることもあります。

次のステップ

• Jira Cloud データのクエリを行うためのユーザー インターフェースを提供するには、アプリを作成し、Jira Cloud データストアに接続します。
• アクションのリストを表示するには、アクションを表示するをご覧ください。
• アプリが設定された後に検索結果がどのように表示されるかをプレビューするには、検索結果を取得するをご覧ください。
• データストアのアラートを有効にするには、サードパーティのデータストアのアラートを構成するをご覧ください。