Copilot クラウド エージェントと Jira の統合

Jira の GitHub Copilot 統合により、Jira ワークスペースを離れることなく Copilot クラウドエージェント を呼び出すことができます。 Jira 内から、作業項目のタイトル、説明、ラベル、コメント、承諾条件などの Atlassian ユーザー設定フィールドのコンテキストを使用して、 クラウド エージェント セッションを開始し、プル要求を開くことができます。

前提条件

• 有料のGitHub プランを���じてCopilotにアクセスできるCopilot アカウントが必要です。
• Jira Cloud アカウントを持っている必要があります。 Jira は AI 対応アプリである必要があり、Rovo は組織に対してアクティブ化する必要があります。 Atlassian ドキュメントのアプリの AI のアクティブ化 を参照してください。
• Jira と GitHub の両方のインストールと認証を完了する必要があります。

Installation

Jira アプリの GitHub Copilot をインストールし、 GitHub 組織またはエンタープライズ アカウントに対して承認するには、次のものが必要です。

• Jira サイトの管理者権限。
• GitHub 所有者またはアプリ マネージャーの GitHub 組織に対するアクセス許可。

この統合は、Atlassian Forge アプリケーションと GitHub アプリケーションに依存します。 両方とも統合に必要です。 正常にインストールされると、**** リポジトリへのGitHubアクセス権を持つ Jira ワークスペースの承認されたユーザーは、Jira からエージェントをトリガーできるようになります。

GitHub Copilot 向けの GitHub.com for Jira アプリのインストール

1. Atlassian Marketplace の GitHub Copilot for Jira のインストール ページ に移動します。

2. [ 今すぐ入手] をクリックします。

3. GitHub アプリケーションをインストールする Atlassian サイトを選択します。

4. [ 確認 ] をクリックしてインストールの詳細を確認し、[ 今すぐ入手] をクリックします。

   Jira の GitHub Copilot が Jira サイトにインストールされたら、 GitHub の組織とリポジトリにアクセスするためのアプリを承認する必要があります。

5. インストール後、Jira の確認メッセージで [構成] を クリックします。

   • 自動的にリダイレクトされない場合は、GitHub Marketplaceに移動します。 [インストール] をクリックします。

6. GitHubにまだログインしていない場合は、強調表示されている [ログイン] をクリックしてGitHub し、プロンプトに従ってGitHub アカウントにログインし、アプリケーションを承認します。

   • 組織または企業でシングル サインオン (SSO) を使用している場合は、組織のアクティブな SAML セッションを開始し、追加の承認手順を実行することが必要になる場合があります。

7. [アプリのインストール] をクリックして、GitHub アカウントの情報にアクセスするためのアクセス許可をアプリに付与します。

8. アプリがアクセスできる組織とリポジトリを選択します。 お客様のGitHub組織は、Jira ワークスペースではデフォルトで有効になっています。 必要に応じて、[Jira のGitHub Copilotのインストール] ページで、_アプリケーションにアクセスさせたくない_組織とリポジトリの_選択を解除_します。

9. [インストール] をクリックします。

10. インストールが完了すると、Jira の GitHub Copilot for Jira アプリ構成ページに接続されている組織の一覧が表示されます。

GitHub Copilot 向けの GHE.com for Jira アプリのインストール

1. Atlassian Marketplace の GitHub Copilot for Jira (GHEC with Data Residency) のインストール ページ に移動します。

2. アプリ名の右側にある [ ] をクリックし、テキスト ボックスに SUBDOMAIN.ghe.com を入力します。 SUBDOMAIN を企業の GHE.com のサブドメインに置き換えます。

3. [Save configuration] をクリックします。

4. [ 今すぐ入手] をクリックします。

5. GitHub アプリケーションをインストールする Atlassian サイトを選択します。

6. [ 確認 ] をクリックしてインストールの詳細を確認し、[ 今すぐ入手] をクリックします。

   Jira の GitHub Copilot が Jira サイトにインストールされたら、 GitHub の組織とリポジトリにアクセスするためのアプリを承認する必要があります。

7. インストール後、Jira の確認メッセージで [構成] を クリックします。

   • 自動的にリダイレクトされない場合は、企業で使用できるアプリの一覧にある Jira アプリの GitHub Copilot ( SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira) を見つけます。 [インストール] をクリックします。

8. GitHubにまだログインしていない場合は、強調表示されている [ログイン] をクリックしてGitHub し、プロンプトに従ってGitHub アカウントにログインし、アプリケーションを承認します。

   • 組織または企業で SSO を使用している場合は、組織のアクティブな SAML セッションを開始し、追加の承認手順を実行することが必要になる場合があります。

9. [アプリのインストール] をクリックして、GitHub アカウントの情報にアクセスするためのアクセス許可をアプリに付与します。

10. アプリがアクセスできる組織とリポジトリを選択します。 お客様のGitHub組織は、Jira ワークスペースでは既定で有効になっています。 必要に応じて、[Jira のGitHub Copilotのインストール] ページで、_アプリケーションにアクセスさせたくない_組織とリポジトリの_選択を解除_します。

11. [インストール] をクリックします。

12. インストールが完了すると、Jira の GitHub Copilot for Jira アプリ構成ページに接続されている組織の一覧が表示されます。

Jira で GitHub Copilot アプリを使用する

Copilot アプリの使用を開始するには、メンバーであるGitHub組織でアプリを有効にする必要があります。

Jira で Copilot クラウドエージェント を初めて使用するときは、 GitHub アカウントに接続する必要があります。

リポジトリへの 書き込み アクセス権を持つユーザーのみが、そのリポジトリで作業する Copilot クラウドエージェント をトリガーできます。

Copilot クラウドエージェントは、いくつかの方法でトリガーできます。

• 割り当てGitHub Copilot 割り当て先フィールドを使用して作業項目に担当者を設定します。

•           作業項目のコメントに**メンション**`@GitHub Copilot`します。
  

• Jira オートメーションを使用します。 Jira 自動化ルールで、[GitHub Copilot使用] アクションを選択し、作業項目の作成や切り替え、ラベルの適用など、Jira イベントに基づくカスタム トリガーを使用するようにフローを構成します。 詳細については、Atlassian ドキュメント の「Jira での AI エージェントの操作 」を参照してください。

例：Jira 作業項目から Copilot クラウドエージェント をトリガーする

1. Jira で、 Copilot クラウドエージェントに委任する明確な要件を含む作業項目を開くか作成します。

2. Copilot が作業するリポジトリを指定するには、作業項目の説明またはコメントにメンションしてください。

3. 作業項目に GitHub Copilot を割り当てるか、コメント内で @GitHub Copilot をメンションする。 例えば次が挙げられます。

   @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo
   

4. Jira の GitHub アプリケーションを GitHub アカウントに接続していない場合は、プロンプトに従って、 GitHub と Atlassian の両方のアプリケーションを承認します。

5. Copilot クラウドエージェント がプルリクエストでの作業を開始すると、Jira のチャット パネルにコメントが表示されます。 エージェント セッションを開始したユーザーは、そこで進行状況を表示できます。

6. Copilotの詳細な手順を確認できます。

   • [エージェント] 見出しの下にある [チャットで続行] ボタンを使用してCopilotと直接チャットし、_現在_の pull request に対して更新を行います。
   • 作業項目のコメントに @GitHub Copilot メンションして、 新しい プル要求で更新を行います。

Jira でのエージェント アクティビティの表示

クラウド エージェントは、アクティビティ ストリームを Jira のチャット パネルにライブで配信するので、作業項目を離れることなくエージェントの動作に従うことができます。 アクティビティ ストリームには、 GitHubに関連付けられているエージェント セッションへのリンクが含まれています。

セッション後の Jira からの Copilot の誘導

Copilot クラウドエージェントがセッションを完了したとき (たとえば、pull request がレビューの準備ができたら)、Copilotに作業を続行するように指示できます。

• Jira のチャット パネルで、 GitHubに関連付けられているエージェント セッションへのリンクを選択します。 これにより、 GitHubのエージェント パネルが開き、セッションを確認し、既存 のプル要求 を更新するためのフォローアップ手順を送信できます。
• Jira 作業項目にフォローアップ @GitHub Copilot メンションまたはコメントを追加します。 これにより、新しいセッションが開始され、既存のプル要求を更新するのではなく、 新しい プル要求が開きます。

Jira での Copilot クラウドエージェント のカスタマイズ

モデル、エージェント、カスタム命令を指定することで、Jira ワークスペースでの Copilot クラウドエージェント のしくみをカスタマイズできます。

モデルの指定

タスクを既定ではなく特定のモデルで実行する場合は、モデルを指定します。 たとえば、定期的で適切な範囲の変更に対して、より軽いモデルを選択できます。 特定のタスクの Copilot クラウドエージェント によって使用されるモデルを変更するには、 Copilotする手順にモデル名を含めます。 GitHub Copilot クラウド エージェントの AI モデルの変更 を参照してください。

カスタム エージェントの指定

カスタム エージェントを指定して、特定のワークフローまたはリポジトリに クラウド エージェントの動作を調整します。 GitHub リポジトリからカスタム エージェントを Jira チケットで直接指定できます。 詳細については、「Copilot クラウドエージェント用のカスタム エージェントの作成」を参照してください。

カスタム指示の使用

カスタム命令を使用して、ターゲット リポジトリなど、すべてのセッションに適用される既定値を設定します。そのため、 Copilot 一時停止してセッションの途中で入力を求める必要はありません。 Copilot クラウドエージェントがトリガーされるたびに適用されるカスタム命令は、Jira ワークスペース レベルで定義できます。

使用コスト

Copilot クラウドエージェント は GitHub Actions 分と AI credits を使用します。

詳細については、「組織と企業の使用量ベースの課金」を参照してください。

Jira アプリの GitHub Copilot に組織を追加または削除する

Jira 管理者と GitHub 組織の所有者は、統合のために組織を有効または無効にすることができます。

組織の Jira アプリの GitHub Copilot のアクセスを変更するには:

1. Jira で、ワークスペースの設定ページに移動します。
2. GitHub Copilot アプリのアプリケーション設定ページに移動します。
3. 必要に応じて、[ Connect More GitHub Organizations ] をクリックして、新しい組織を一覧に追加します。
4. 表示されている 1 つ以上の組織の Copilot アプリを有効または無効にします。

Troubleshooting

問題が発生した場合は、次の解決策を試してください。

Copilot クラウドエージェントが表示されず、Jira 作業項目に割り当てることはできません

Jira で、組織の Atlassian Administration の設定が次のように設定されていることを確認します。

1. Jira は AI 対応アプリです。Atlassian ドキュメントの 「アプリの AI のアクティブ化 」を参照してください。

Copilot クラウドエージェントは表示できますが、Jira 作業項目に割り当てすることはできません。

GitHubで個人用アカウントを Jira アプリのGitHub Copilotに接続していることを確認します。

1. Jira で、個人用アカウントの設定ページに移動します。
2. 全般設定で、Jira アプリのGitHub Copilotを選択します。
3. GitHubでまだサインインしていない場合は、プロンプトに従ってサインインし、アプリケーションを承認します。

GitHub Copilotとチャットすると、サインインするように求められます

GitHub Copilot for Jira アプリにサインインするには、上記の「Copilot クラウドエージェントを確認できますが、Jira 作業項目に割り当てすることはできません」の手順に従います。

ワークスペース内の他のユーザーは、Jira 作業項目に Copilot クラウドエージェント を割り当てることができますが、

Copilot クラウドエージェント Jira で組織のリソースを表示または操作できず、組織が GitHub で SSO を使用している場合は、GitHub Copilot アカウントの Jira アプリのGitHubの再認証が必要になる場合があります。 詳細については、「シングル サインオンでの認証について」を参照してください。

この問題を解決するには、次の手順に従って、組織の新しいアクティブな SSO セッションを開始します。

1. でGitHubに移動します。
2. [シングル サインオン] で、認証する必要がある組織を見つけて、[ サインアウト] をクリックし、[ サインイン] をクリックします。
   • 企業が組織の SSO を管理している場合、企業内の 1 つの組織にサインインすると、企業内のすべての組織の SSO セッションとして機能します。
3. Jira に戻り、作業中のページを更新します。
4. Jira で Copilot クラウドエージェント をもう一度操作してみてください。

GitHub Copilot 応答していません

• GitHubの [状態] ページで、アクティブなインシデントを確認します。
• Atlassian の状態ページで、アクティブなインシデントがないか確認します。
• Copilot クラウドエージェントの問題にCopilotを割り当てることができるかどうかをテストして、GitHubがリポジトリにアクセスできることを確認します。
• Jira アプリケーションの GitHub Copilot がリポジトリにアクセス可能であることを確認します。 「インストールされている GitHub Apps の確認と変更」を参照してください。

詳細については、次を参照してください。

• クラウド エージェントGitHub Copilotについて
• GitHub Copilot クラウド エージェントへのアクセスの管理
• リポジトリの MCP サーバーを構成する
• Atlassian ドキュメントで AI エージェントと作業項目を共同作業する