概要

Gemini Enterprise 用の Jira Cloud コネクタを使用すると、Jira Cloud データにアクセスして、プロジェクト、問題、ユーザー情報とやり取りできます。

サポートされている Jira Cloud のバージョン

Jira Cloud コネクタは、Jira Cloud REST API のバージョン 2 をサポートしています。

サポートされているアクション

Jira Cloud コネクタが有効になっている場合、エンドユーザーは Gemini Enterprise で自然言語コマンドを使用して次の操作を行うことができます。

アクション 説明
コメントを作成する 指定された Jira の問題に新しいコメントを作成して、フィードバック、更新情報、メモを追加します。
コメントを更新 既存のコメントのテキストを編集します。
問題を作成する Jira Cloud プロジェクトに新しい問題を作成します。作成するには、概要、プロジェクト ID、問題タイプ ID を指定する必要があります。
更新に関する問題 Jira Cloud の既存の問題を更新します。問題を特定するには問題 ID を指定する必要があります。また、概要、説明、割り当て先などのさまざまなフィールドを変更できます。

これらの他に、読み取り専用の操作も利用できます。

必要なスコープ

Gemini Enterprise が Jira Cloud データストアを使用して検索とアクションを実行できるようにするには、次のスコープが必要です。

接続モード 範囲 目的
連携検索とアクション read:jira-user、read:jira-work 検索結果とユーザーの詳細をリアルタイムで取得して表示するために必要です。
write:jira-work アシスタントが作業項目を変更できるようにします（問題フィールドの更新など）。
write:comment:jira アシスタントが検索インターフェースから直接新しいコメントや返信を投稿できるようにします。
write:issue:jira 新しい問題を登録したり、既存の問題を大幅に編集したりする場合に必要です。
連携検索のみ read:jira-user、read:jira-work 問題、プロジェクト、ユーザー プロフィールを検索して表示するために必要です。
データの取り込みとアクション read:jira-work、read:user:jira、read:group:jira、read:avatar:jira 大規模なデータ取り込みとユーザー/グループ メタデータの同期に必要です。
read:issue-security-level:jira、read:issue-security-scheme:jira アクセス制御に不可欠。取り込まれたデータが Jira のセキュリティ境界を尊重することを保証します。
read:audit-log:jira 変更を追跡し、増分同期を実行して、取り込まれたデータを最新の状態に保つために使用されます。
write:jira-work 取り込まれた環境内の作業項目に対して書き込みアクションを実行するために必要です。
write:comment:jira アシスタントを使用して問題にコメントを追加するために必要です。
write:issue:jira 問題の作成または変更を有効にします。
データの取り込み read:jira-work、read:user:jira、read:group:jira、read:avatar:jira Jira のコンテンツとユーザーの関係をクロールしてインデックスに登録するために必要です。
read:issue-security-level:jira、read:issue-security-scheme:jira 取り込まれたデータを承認されたユーザーのみが検索できるように、権限をマッピングする必要があります。
read:audit-log:jira 同期エンジンが更新または削除されたアイテムを特定するために必要です。

これらのスコープを構成する方法については、最小限のアプリケーション スコープを構成するをご覧ください。

データ取り込みのレート上限

Jira Cloud コネクタは、データ取り込みのデフォルトのレート制限として 1 秒あたり 12 件のクエリ（QPS）をサポートしています。これらのレート上限は、Jira Cloud コネクタからのデータの取り込みにのみ適用されます。

制限事項

このセクションでは、Jira Cloud コネクタの使用に影響する可能性のある既知の問題と制限事項について説明します。

  • 既存の Jira Cloud データストアに VPC Service Controls の境界を適用することはできません。VPC Service Controls を適用するには、データストアを削除して再作成する必要があります。VPC Service Controls と、VPC Service Controls を有効にした後にアクションを使用する方法の詳細については、VPC Service Controls でアプリを保護するをご覧ください。

  • Jira Cloud データストアは、グローバル、米国、EU のロケーションでのみサポートされています。

  • 新しいアプリケーションを作成する場合や、既存のアプリケーションにデータストアを追加する場合は、単一のコネクタタイプに属するアクションを含むデータストアを追加することをおすすめします。たとえば、アクションが有効になっている 2 つの Jira Cloud データストアを同じアプリケーションに関連付けないでください。

Jira Cloud 取り込みコネクタには、次の制限事項があります。

  • 非構造化データの場合、メディアタイプごとに制限は異なります。詳細については、カスタム データソースのデータを準備するをご覧ください。

  • 構造化データの場合、各ドキュメントのサイズは 500 KB 以下にしてください。

  • 特定の空でないロールを持つアプリケーション ロールには、Browse project 権限やセキュリティ レベルの権限を付与できません。

  • ユーザー カスタム フィールドまたはグループ カスタム フィールドで決定されるドキュメントのアクセス許可はサポートされていません。

  • Jira Cloud では、ワークログ レベルでの制限は許可されていません。

  • Jira Cloud では、2,000 ページを超える PDF 添付ファイルはインデックスに登録されません。

  • 限定公開のコメントに追加された添付ファイルは、コメントのアクセス制限（ACL）を継承しません。

  • Jira Cloud の問題の過去 20 件のコメントのみが取得されます。

  • スプリント テーブルは取り込めません。

  • 従来のユーザー管理モデルは、Jira Cloud との統合ではサポートされていません。サポートされているのは、一元化されたユーザー管理モデルのみです。 詳細については、Atlassian 組織統合ガイドをご覧ください。

  • Jira エンティティ（問題など）をクエリする場合、コメントや添付ファイルなどの関連データは自動的に含まれません。これは、別々のエンティティとして保存され、インデックス登録されるためです。添付ファイルのコンテンツに基づいて検索し、親の問題を見つけることはできません。

次のステップ