# Copilot クラウド エージェントと Jira の統合 Jira の GitHub 統合を使用して、コンテキストを提供し、すべてのプル要求を Jira ワークスペース内から開くことができます。 > \[!NOTE] > GitHub Copilot は AI を使用します。 間違いがないか確認してください。 「[アプリケーション カード: GitHub Copilot エージェント](/ja/copilot/responsible-use/agents)」を参照してください。 Jira の GitHub Copilot 統合により、Jira ワークスペースを離れることなく Copilot cloud agent を呼び出すことができます。 Jira 内から、作業項目のタイトル、説明、ラベル、コメント、承諾条件などの Atlassian ユーザー設定フィールドのコンテキストを使用して、 cloud agent セッションを開始し、プル要求を開くことができます。 ## Prerequisites * 有料のGitHub プランを通じてCopilotにアクセスできるCopilot アカウントが必要です。 * Jira Cloud アカウントを持っている必要があります。 **Jira は AI 対応アプリである必要**があり、Rovo は組織に対してアクティブ化する必要があります。 Atlassian [ドキュメントのアプリの AI のアクティブ化](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) を参照してください。 * Jira と GitHub の両方のインストールと認証を完了する必要があります。 ## Installation Jira アプリの GitHub Copilot をインストールし、 GitHub 組織またはエンタープライズ アカウントに対して承認するには、次のものが必要です。 * Jira サイトの管理者権限。 * GitHub所有者またはアプリ マネージャーのGitHub組織に対するアクセス許可。 この統合は、Atlassian Forge アプリケーションと GitHub アプリケーションに依存します。 両方とも統合に必要です。 正常にインストールされると、\*\*\*\* リポジトリへのGitHubアクセス権を持つ Jira ワークスペースの承認されたユーザーは、Jira からエージェントをトリガーできるようになります。 ### Jira アプリの GitHub Copilot をインストールする GitHub.com 1. Atlassian Marketplace の [GitHub Copilot for Jira のインストール ページ](https://marketplace.atlassian.com/apps/1582455624?ref_product=copilot\&ref_type=engagement\&ref_style=text) に移動します。 2. \[ **今すぐ入手]** をクリックします。 3. GitHub アプリケーションをインストールする Atlassian サイトを選択します。 4. \[ **確認** ] をクリックしてインストールの詳細を確認し、\[ **今すぐ入手**] をクリックします。 Jira の GitHub Copilot が Jira サイトにインストールされたら、 GitHub の組織とリポジトリにアクセスするためのアプリを承認する必要があります。 5. インストール後、Jira の確認メッセージで **\[構成] を** クリックします。 * 自動的にリダイレクトされない場合は、GitHub Copilotに移動します。 **\[インストール]** をクリックします。 6. GitHubにまだログインしていない場合は、強調表示されている \[ログイン] をクリック**してGitHub** し、プロンプトに従ってGitHub アカウントにログインし、アプリケーションを承認します。 * 組織または企業でシングル サインオン (SSO) を使用している場合は、組織のアクティブな SAML セッションを開始し、追加の承認手順を実行することが必要になる場合があります。 7. \[**アプリのインストール**] をクリックして、GitHub アカウントの情報にアクセスするためのアクセス許可をアプリに付与します。 8. アプリがアクセスできる組織とリポジトリを選択します。 お客様のGitHub組織は、Jira ワークスペースではデフォルトで有効になっています。 必要に応じて、\[**Jira のGitHub Copilotのインストール**] ページで、\_アプリケーションにアクセスさせたくない\_組織とリポジトリの\_選択を解除\_します。 9. **\[インストール]** をクリックします。 10. インストールが完了すると、Jira の GitHub Copilot for Jira アプリ構成ページに接続されている組織の一覧が表示されます。 ### Jira アプリの GitHub Copilot をインストールする GHE.com 1. Atlassian Marketplace の [GitHub Copilot for Jira (GHEC with Data Residency) のインストール ページ](https://marketplace.atlassian.com/apps/3637796809?ref_product=copilot\&ref_type=engagement\&ref_style=text) に移動します。 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 cloud agent を初めて使用するときは、 GitHub アカウントに接続する必要があります。 リポジトリへの **書き込み** アクセス権を持つユーザーのみが、そのリポジトリで作業する Copilot cloud agent をトリガーできます。 Copilot cloud agentは、いくつかの方法でトリガーできます。 * **割り当て**GitHub Copilot 割り当て先フィールドを使用して作業項目に担当者を設定します。 * ``` 作業項目のコメントに**メンション**`@GitHub Copilot`します。 ``` * **Jira オートメーションを使用します。** Jira 自動化ルールで、\[**GitHub Copilot使用**] アクションを選択し、作業項目の作成や切り替え、ラベルの適用など、Jira イベントに基づくカスタム トリガーを使用するようにフローを構成します。 詳細については、Atlassian ドキュメント [の「Jira での AI エージェントの操作](https://support.atlassian.com/jira-software-cloud/docs/work-with-ai-agents-in-jira/) 」を参照してください。 > \[!NOTE] > Jira 作業項目に Copilot を割り当てると、エージェントが Jira からキャプチャするコンテキストがプル要求に追加され、リポジトリがパブリックである場合 **は全員に表示されます** 。 ### 例：Jira 作業項目から Copilot cloud agent をトリガーする 1. Jira で、 Copilot cloud agentに委任する明確な要件を含む作業項目を開くか作成します。 2. リポジトリ Copilot を指定するには、作業項目の説明またはコメントにメンションしてください。 3. 作業項目に `GitHub Copilot` を割り当てるか、コメント内で `@GitHub Copilot` をメンションする。 例えば次が挙げられます。 ```text @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo ``` 4. Jira の GitHub アプリケーションを GitHub アカウントに接続していない場合は、プロンプトに従って、 GitHub と Atlassian の両方のアプリケーションを承認します。 5. Copilot cloud agent がプルリクエストでの作業を開始すると、Jira のチャット パネルにコメントが表示されます。 エージェント セッションを開始したユーザーは、そこで進行状況を表示できます。 6. Copilotの詳細な手順を確認できます。 * **\[エージェント**] 見出し**の下にある \[チャットで続行**] ボタンを使用してCopilotと直接チャットし、\_現在\_の pull request に対して更新を行います。 * 作業項目のコメントに `@GitHub Copilot` メンションして、 *新しい* プル要求で更新を行います。 > \[!TIP] > 1 分後に Copilot cloud agent のトリガーの確認を受け取っていない場合は、Jira 作業項目ページを更新します。 ### Jira でのエージェント アクティビティの表示 cloud agentは、アクティビティ ストリームを Jira のチャット パネルにライブで配信するので、作業項目を離れることなくエージェントの動作に従うことができます。 アクティビティ ストリームには、 GitHubに関連付けられているエージェント セッションへのリンクが含まれています。 ### セッション後の Jira からの Copilot の誘導 Copilot cloud agentがセッションを完了したとき (たとえば、pull request がレビューの準備ができたら)、Copilotに作業を続行するように指示できます。 * Jira のチャット パネルで、 GitHubに関連付けられているエージェント セッションへのリンクを選択します。 これにより、 GitHubのエージェント パネルが開き、セッションを確認し、既存 **のプル要求** を更新するためのフォローアップ手順を送信できます。 * Jira 作業項目にフォローアップ `@GitHub Copilot` メンションまたはコメントを追加します。 これにより、新しいセッションが開始され、既存のプル要求を更新するのではなく、 **新しい** プル要求が開きます。 ## Jira での Copilot cloud agent のカスタマイズ モデル、エージェント、カスタム命令を指定することで、Jira ワークスペースでの Copilot cloud agent のしくみをカスタマイズできます。 ### モデルの指定 タスクを既定ではなく特定のモデルで実行する場合は、モデルを指定します。 たとえば、定期的で適切な範囲の変更に対して、より軽いモデルを選択できます。 特定のタスクの Copilot cloud agent によって使用されるモデルを変更するには、 Copilotする手順にモデル名を含めます。 [GitHub Copilot クラウド エージェントの AI モデルの変更](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model) を参照してください。 ### カスタム エージェントの指定 カスタム エージェントを指定して、特定のワークフローまたはリポジトリに cloud agentの動作を調整します。 GitHub リポジトリからカスタム エージェントを Jira チケットで直接指定できます。 詳細については、「[Copilot cloud agent用のカスタム エージェントの作成](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)」を参照してください。 ### カスタム指示の使用 カスタム命令を使用して、ターゲット リポジトリなど、すべてのセッションに適用される既定値を設定します。そのため、 Copilot 一時停止してセッションの途中で入力を求める必要はありません。 Copilot cloud agentがトリガーされるたびに適用されるカスタム命令は、Jira ワークスペース レベルで定義できます。 ## 使用コスト Copilot cloud agent は GitHub Actions 分と AI creditsを使用します。 詳細については、「[組織と企業の使用量ベースの課金](/ja/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises)」を参照してください。 ## Jira アプリの GitHub Copilot に組織を追加または削除する Jira 管理者と GitHub 組織の所有者は、統合のために組織を有効または無効にすることができます。 > \[!NOTE] > 初期インストール後に新しい SSO で保護された組織がアプリに追加された場合、ユーザーは、Jira から新しい組織のリポジトリでGitHubを動作させるために、Copilot cloud agentで組織のアクティブな SAML セッションを開始する必要があります。 詳細については、「[シングル サインオンでの認証について](/ja/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso)」を参照してください。 組織の Jira アプリの GitHub Copilot のアクセスを変更するには: 1. Jira で、ワークスペースの設定ページに移動します。 2. GitHub Copilot アプリのアプリケーション設定ページに移動します。 3. 必要に応じて、\[ **Connect More GitHub Organizations** ] をクリックして、新しい組織を一覧に追加します。 4. 表示されている 1 つ以上の組織の Copilot アプリを有効または無効にします。 ## Troubleshooting 問題が発生した場合は、次の解決策を試してください。 ### Copilot cloud agentが表示されず、Jira 作業項目に割り当てることはできません Jira で、組織の Atlassian Administration の設定が次のように設定されていることを確認します。 1. Jira は AI 対応アプリです。Atlassian ドキュメントの [「アプリの AI のアクティブ化](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) 」を参照してください。 ### Copilot cloud agentは表示できますが、Jira 作業項目に割り当てすることはできません。 GitHubで個人用アカウントを Jira アプリのGitHub Copilotに接続していることを確認します。 1. Jira で、個人用アカウントの設定ページに移動します。 2. 全般設定で、**Jira アプリのGitHub Copilotを**選択します。 3. GitHubでまだサインインしていない場合は、プロンプトに従ってサインインし、アプリケーションを承認します。 ### GitHub Copilotとチャットすると、サインインするように求められます GitHub Copilot for Jira アプリにサインインするには、上記の「[Copilot cloud agentを確認できますが、Jira 作業項目に割り当てすることはできません](#you-can-see-the-copilot-cloud-agent-but-it-is-not-possible-to-assign-it-to-a-jira-work-item)」の手順に従います。 ### ワークスペース内の他のユーザーは、Jira 作業項目に Copilot cloud agent を割り当てることができますが、 Copilot cloud agent Jira で組織のリソースを表示または操作できず、組織が GitHub で SSO を使用している場合は、GitHub Copilot アカウントの Jira アプリのGitHubの再認証が必要になる場合があります。 詳細については、「[シングル サインオンでの認証について](/ja/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso)」を参照してください。 この問題を解決するには、次の手順に従って、組織の新しいアクティブな SSO セッションを開始します。 1. [ ](https://github.com/settings/organizations)でGitHubに移動します。 2. \[シングル サインオン] で、認証する必要がある組織を見つけて、\[ **サインアウト**] をクリックし、\[ **サインイン**] をクリックします。 * 企業が組織の SSO を管理している場合、企業内の 1 つの組織にサインインすると、企業内のすべての組織の SSO セッションとして機能します。 3. Jira に戻り、作業中のページを更新します。 4. Jira で Copilot cloud agent をもう一度操作してみてください。 ### GitHub Copilot 応答していません * GitHubの [\[状態\] ページ](https://githubstatus.com)で、アクティブなインシデントを確認します。 * [Atlassian の状態ページで](https://status.atlassian.com)、アクティブなインシデントがないか確認します。 * Copilot cloud agentの問題にCopilotを割り当てることができるかどうかをテストして、GitHubがリポジトリにアクセスできることを確認します。 * Jira アプリケーションの GitHub Copilot がリポジトリにアクセス可能であることを確認します。 「[インストールされている GitHub Apps の確認と変更](/ja/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)」を参照してください。 ## 詳細については、次を参照してください。 * [クラウド エージェントGitHub Copilotについて](/ja/copilot/concepts/agents/cloud-agent/about-cloud-agent) * [GitHub Copilot クラウド エージェントへのアクセスの管理](/ja/copilot/concepts/agents/cloud-agent/access-management) * [リポジトリの MCP サーバーを構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#example-atlassian) * Atlassian ドキュメント[で AI エージェントと作業項目を共同作業](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/)する