From 69a64bb72213ecee49f774f02ef29d556b2e1403 Mon Sep 17 00:00:00 2001 From: Vanessa Date: Fri, 26 Jun 2026 06:52:32 +1000 Subject: [PATCH] [2026-06-25] GitHub Copilot for Jira integration [GA] (#61827) (#61828) Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com> Co-authored-by: vgrltwin --- .../integrate-cloud-agent-with-jira.md | 130 +++++++++++------- 1 file changed, 80 insertions(+), 50 deletions(-) diff --git a/content/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-jira.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-jira.md index a775507514ab..ffd8da81a2b4 100644 --- a/content/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-jira.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-jira.md @@ -15,22 +15,16 @@ category: --- > [!NOTE] -> * This feature is currently in {% data variables.release-phases.public_preview %} and subject to change. -> * {% data variables.product.prodname_copilot %} uses AI. Check for mistakes. See [AUTOTITLE](/copilot/responsible-use/copilot-cloud-agent). -> * You can provide feedback about the {% data variables.product.prodname_copilot %} for Jira integration in the [{% data variables.product.github %} survey](https://survey.alchemer.com/s3/8816096/GC4Jira). +> {% data variables.product.prodname_copilot %} uses AI. Check for mistakes. See [AUTOTITLE](/copilot/responsible-use/copilot-cloud-agent). -The {% data variables.product.prodname_copilot %} integration in Jira allows you to invoke {% data variables.copilot.copilot_cloud_agent %} without leaving your Jira workspace. From within a Jira work item you can initiate {% data variables.copilot.copilot_cloud_agent_short %} sessions and open pull requests, using the context of the work item's title, description, labels, comments, and any Atlassian custom fields such as acceptance criteria. +The {% data variables.product.prodname_copilot %} integration in Jira allows you to invoke {% data variables.copilot.copilot_cloud_agent %} without leaving your Jira workspace. From within Jira you can initiate {% data variables.copilot.copilot_cloud_agent_short %} sessions and open pull requests, using the context of the work item's title, description, labels, comments, and any Atlassian custom fields such as acceptance criteria. ## Prerequisites * You must have a {% data variables.product.github %} account with access to {% data variables.product.prodname_copilot_short %} through a paid {% data variables.product.prodname_copilot_short %} plan. -* You must have a Jira Cloud account with the following AI feature enabled for your organization: - * **Jira must be an AI-enabled app** and Rovo must be activated. See [Activate AI for apps](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) in the Atlassian documentation. +* You must have a Jira Cloud account, **Jira must be an AI-enabled app**, and Rovo must be activated for your organization. See [Activate AI for apps](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) in the Atlassian documentation. * Installation and authentication must be completed for both Jira and {% data variables.product.github %}. -> [!NOTE] -> If your Jira site is on release tracks, you should contact Atlassian Support and ask for agents to be enabled in Jira before proceeding with the installation. For more information, see [What are release tracks?](https://support.atlassian.com/organization-administration/docs/what-are-release-tracks/) in the Atlassian documentation. - ## Installation To install the {% data variables.product.prodname_copilot %} for Jira app and authorize it for your {% data variables.product.github %} organization or enterprise account, you need: @@ -43,38 +37,40 @@ This integration relies on an Atlassian Forge application and a {% data variable ### Installing the {% data variables.product.prodname_copilot %} for Jira app for {% data variables.product.prodname_dotcom_the_website %} 1. Navigate to the [{% data variables.product.prodname_copilot %} for Jira installation page](https://marketplace.atlassian.com/apps/1582455624?ref_product=copilot&ref_type=engagement&ref_style=text) on the Atlassian Marketplace. -1. Click **Get app**. -1. Select the Atlassian instance you want to install the {% data variables.product.github %} application in. -1. Click **Install**. -1. If you are not automatically redirected, go to the [{% data variables.product.prodname_copilot %} for Jira installation page](https://github.com/apps/github-copilot-for-jira?ref_product=copilot&ref_type=engagement&ref_style=text) on the {% data variables.product.prodname_marketplace %} and click **Install**. -1. In the **Install {% data variables.product.prodname_copilot %} for Jira** page, select the organization and repositories you would like to give the application access to. - * You can add additional organizations after the app is installed, see [Adding an organization to the {% data variables.product.prodname_copilot %} for Jira app](#adding-an-organization). +1. Click **Get it now**. +1. Select the Atlassian site you want to install the {% data variables.product.github %} application in. +1. Click **Review** to check the installation details, and then click **Get it now**. + + Once {% data variables.product.prodname_copilot %} for Jira is installed in your Jira site, you need to authorize the app to access your {% data variables.product.github %} organization and repositories. + +1. Click **Configure** in the confirmation message in Jira after installation. + * If you are not automatically redirected, go to the [{% data variables.product.prodname_copilot %} for Jira installation page](https://github.com/apps/github-copilot-for-jira?ref_product=copilot&ref_type=engagement&ref_style=text) on the {% data variables.product.prodname_marketplace %}. Click **Install**. +1. If you are not already logged in to {% data variables.product.prodname_dotcom %}, click the highlighted **Log in to {% data variables.product.prodname_dotcom %}** and follow the prompts to log in to your {% data variables.product.github %} account and authorize the application. + * If your organization or enterprise uses single sign-on (SSO), you may need to start an active SAML session for your organization and perform an additional authorization step. +1. Click **Install app** to give the app permission to access information on your GitHub account. +1. Choose the organization and repositories the app has access to. Your {% data variables.product.github %} organizations are enabled by default for your Jira workspace. Optionally, in the **Install {% data variables.product.prodname_copilot %} for Jira** page, _deselect_ the organization and repositories you _don't want the application to have access to_. 1. Click **Install**. +1. When installation is complete, you will see a list of connected organizations on the {% data variables.product.prodname_copilot %} for Jira app configuration page in Jira. ### Installing the {% data variables.product.prodname_copilot %} for Jira app for {% data variables.enterprise.data_residency_site %} 1. Navigate to the [{% data variables.product.prodname_copilot %} for Jira (GHEC with Data Residency) installation page](https://marketplace.atlassian.com/apps/3637796809?ref_product=copilot&ref_type=engagement&ref_style=text) on the Atlassian Marketplace. 1. To the right of the app name, click {% octicon "kebab-horizontal" aria-label="Configure" %}, and enter your `SUBDOMAIN.ghe.com` in the text box. Replace SUBDOMAIN with your enterprise's subdomain of {% data variables.enterprise.data_residency_site %}. 1. Click **Save configuration**. -1. Click **Get app**. -1. Select the Atlassian instance you want to install the {% data variables.product.github %} application in. -1. Click **Install**. -1. If you are not automatically redirected, find the {% data variables.product.prodname_copilot %} for Jira app in the list of apps available to your enterprise at `SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira`. +1. Click **Get it now**. +1. Select the Atlassian site you want to install the {% data variables.product.github %} application in. +1. Click **Review** to check the installation details, and then click **Get it now**. + + Once {% data variables.product.prodname_copilot %} for Jira is installed in your Jira site, you need to authorize the app to access your {% data variables.product.github %} organization and repositories. + +1. Click **Configure** in the confirmation message in Jira after installation. + * If you are not automatically redirected, find the {% data variables.product.prodname_copilot %} for Jira app in the list of apps available to your enterprise at `SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira`. Click **Install**. +1. If you are not already logged in to {% data variables.product.prodname_dotcom %}, click the highlighted **Log in to {% data variables.product.prodname_dotcom %}** and follow the prompts to log in to your {% data variables.product.github %} account and authorize the application. + * If your organization or enterprise uses SSO, you may need to start an active SAML session for your organization and perform an additional authorization step. +1. Click **Install app** to give the app permission to access information on your GitHub account. +1. Choose the organization and repositories the app has access to. Your {% data variables.product.github %} organizations are enabled by default for your Jira workspace. Optionally, in the **Install {% data variables.product.prodname_copilot %} for Jira** page, _deselect_ the organization and repositories you _don't want the application to have access to_. 1. Click **Install**. -1. In the **Install {% data variables.product.prodname_copilot %} for Jira** page, select the organization and repositories you would like to give the application access to. - * You can add additional organizations after the app is installed, see [Adding an organization to the {% data variables.product.prodname_copilot %} for Jira app](#adding-an-organization). -1. Click **Install**. - -## Adding an organization to the {% data variables.product.prodname_copilot %} for Jira app - -Once the {% data variables.product.prodname_copilot %} for Jira app has been installed, a Jira administrator and {% data variables.product.github %} organization owner can enable additional organizations to use the app. This allows any member of the organization to connect their {% data variables.product.github %} account to the app and start using it in Jira. - -To enable the {% data variables.product.prodname_copilot %} for Jira app for an organization: - -1. In Jira, go to the settings page for your workspace. -1. Go to the applications setting page for the {% data variables.product.prodname_copilot %} app. -1. Optionally, click **Connect More {% data variables.product.github %} Organizations** to add new organizations to the list. -1. Enable the {% data variables.product.prodname_copilot_short %} app for one or more of the listed organizations. +1. When installation is complete, you will see a list of connected organizations on the {% data variables.product.prodname_copilot %} for Jira app configuration page in Jira. ## Using the {% data variables.product.prodname_copilot %} app in Jira @@ -84,11 +80,11 @@ The first time you use {% data variables.copilot.copilot_cloud_agent %} in Jira, Only users with **write** access to a repository can trigger {% data variables.copilot.copilot_cloud_agent %} to work in that repository. -You can trigger {% data variables.copilot.copilot_cloud_agent %} in three ways: +You can trigger {% data variables.copilot.copilot_cloud_agent %} in several ways: * **Assign** {% data variables.product.prodname_copilot %} to a work item using the Assignee field. * **Mention** `@{% data variables.product.prodname_copilot %}` in a comment on a work item. -* **Add {% data variables.product.prodname_copilot_short %} to a workflow transition** so it is triggered automatically when a work item moves to a specific status. See [Collaborate on work items with AI agents](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/#Add-an-agent-to-workflow-transitions) for setup instructions. +* **Use a Jira automation.** In your Jira automation rules, select the **Use {% data variables.product.prodname_copilot %}** action and configure your flow to use a custom trigger based on Jira events, such as when a work item is created or transitioned, or a label is applied. For more information, see [Work with AI agents in Jira](https://support.atlassian.com/jira-software-cloud/docs/work-with-ai-agents-in-jira/) in the Atlassian documentation. > [!NOTE] > When you assign {% data variables.product.prodname_copilot_short %} to a Jira work item, the context the agent captures from Jira will be added to the pull request and **visible to everyone** if the repository is public. @@ -104,33 +100,40 @@ You can trigger {% data variables.copilot.copilot_cloud_agent %} in three ways: ``` 1. If you have not previously connected the {% data variables.product.github %} application in Jira to your {% data variables.product.github %} account, follow the prompts to authorize the application for both {% data variables.product.github %} and Atlassian. -1. Once {% data variables.copilot.copilot_cloud_agent %} has started working on the pull request, a comment will appear in the Jira work item. The user who initiated the agent session can view progress updates for the agent. -1. You can follow up with further instructions for {% data variables.product.prodname_copilot_short %} in a work item: - * Mention `@{% data variables.product.prodname_copilot %}` in a comment. - * Use the **Continue in Chat** button under the **Agents** heading to chat directly with {% data variables.product.prodname_copilot_short %}. +1. Once {% data variables.copilot.copilot_cloud_agent %} has started working on the pull request, a comment will appear in the chat panel in Jira. The user who initiated the agent session can view progress there. +1. You can follow up with further instructions for {% data variables.product.prodname_copilot_short %}: + * Use the **Continue in Chat** button under the **Agents** heading to chat directly with {% data variables.product.prodname_copilot_short %} to have updates made to the _current_ pull request. + * Mention `@{% data variables.product.prodname_copilot %}` in a comment on the work item to have updates made in a _new_ pull request. > [!TIP] > If you have not received confirmation of triggering {% data variables.copilot.copilot_cloud_agent %} after 1 minute, refresh the Jira work item page. -## Customizing {% data variables.copilot.copilot_cloud_agent %} in Jira +### Viewing agent activity in Jira -You can customize how {% data variables.copilot.copilot_cloud_agent %} works in your Jira workspace by specifying models, agents, custom instructions, and branching rules. +While {% data variables.copilot.copilot_cloud_agent_short %} works its activity streams live into the chat panel in Jira, so you can follow what the agent is doing without leaving your work item. The activity stream includes a link to the associated agent session on {% data variables.product.github %}. -### Specifying a model +### Directing {% data variables.product.prodname_copilot_short %} from Jira post-session + +When {% data variables.copilot.copilot_cloud_agent %} has completed a session, for example when a pull request is ready for review, you can direct {% data variables.product.prodname_copilot_short %} to continue the work: + +* In the chat panel in Jira, select the link to the associated agent session on {% data variables.product.github %}. This opens the agents panel on {% data variables.product.github %}, where you can review the session and send follow-up instructions to update the **existing** pull request. +* Add a follow-up `@{% data variables.product.prodname_copilot %}` mention or comment on the Jira work item. This starts a new session and opens a **new** pull request rather than updating the existing one. -To change the model used by {% data variables.copilot.copilot_cloud_agent %} for a specific task, include the model name in your instructions to {% data variables.product.prodname_copilot_short %}. For example, you can say `@{% data variables.product.prodname_copilot %} use Claude Sonnet 4.5`. If you do not specify a model, {% data variables.copilot.copilot_cloud_agent %} will use the default model for coding tasks, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model). +## Customizing {% data variables.copilot.copilot_cloud_agent %} in Jira + +You can customize how {% data variables.copilot.copilot_cloud_agent %} works in your Jira workspace by specifying models, agents, and custom instructions. -### Specifying a custom branch +### Specifying a model -{% data variables.copilot.copilot_cloud_agent_short_cap_c %} respects branch naming rules specified in individual Atlassian tickets. If a ticket includes specific branching conventions, {% data variables.product.prodname_copilot_short %} will read and follow them when creating pull requests, keeping your repository consistent with your existing workflow. +Specify a model when you want a task to run on a specific model rather than the default. For example, you may choose a lighter model for routine, well-scoped changes. To change the model used by {% data variables.copilot.copilot_cloud_agent %} for a particular task, include the model name in your instructions to {% data variables.product.prodname_copilot_short %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model). ### Specifying a custom agent -You can specify a custom agent from your {% data variables.product.github %} repository directly in the Jira ticket. This allows teams to tailor {% data variables.copilot.copilot_cloud_agent_short %}'s behavior to their specific needs. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents). +Specify a custom agent to tailor {% data variables.copilot.copilot_cloud_agent_short %}'s behavior to a particular workflow or repository. You can specify a custom agent from your {% data variables.product.github %} repository directly in the Jira ticket. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents). ### Using custom instructions -You can define custom instructions at the Jira workspace level that apply every time {% data variables.copilot.copilot_cloud_agent %} is triggered. Use these instructions to specify defaults such as the target repository, default branch naming rules, preferred models, or particular agents to use. This reduces repetitive configuration and increases control over the agent's behavior. +Use custom instructions to set defaults that apply to every session, such as the target repository, so {% data variables.product.prodname_copilot_short %} does not have to pause and ask you for input mid-session. You can define custom instructions at the Jira workspace level that apply every time {% data variables.copilot.copilot_cloud_agent %} is triggered. ## Usage costs @@ -138,6 +141,20 @@ You can define custom instructions at the Jira workspace level that apply every For more information, see [AUTOTITLE](/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises). +## Adding or removing an organization to the {% data variables.product.prodname_copilot %} for Jira app + +A Jira administrator and {% data variables.product.github %} organization owner can enable or disable organizations for the integration. + +> [!NOTE] +> If a new SSO-protected organization is added to the app after the initial installation, users will need to start an active SAML session for the organization in {% data variables.product.github %}, in order to trigger {% data variables.copilot.copilot_cloud_agent %} to work in the new organization's repositories from Jira. For more information, see [AUTOTITLE](/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso). + +To change access for the {% data variables.product.prodname_copilot %} for Jira app for an organization: + +1. In Jira, go to the settings page for your workspace. +1. Go to the applications setting page for the {% data variables.product.prodname_copilot %} app. +1. Optionally, click **Connect More {% data variables.product.github %} Organizations** to add new organizations to the list. +1. Enable or disable the {% data variables.product.prodname_copilot_short %} app for one or more of the listed organizations. + ## Troubleshooting If you run into problems, try the following solutions. @@ -158,13 +175,26 @@ Check that you have connected your personal account on {% data variables.product ### When chatting with {% data variables.product.prodname_copilot %}, you are prompted to sign in -To sign in to {% data variables.product.prodname_copilot %} for Jira app, follow the steps above in [You can see the {% data variables.copilot.copilot_cloud_agent %} but it is not possible to assign it to a Jira work item](#you-can-see-the-copilot-cloud-agent-but-it-is-not-possible-to-assign-it-to-a-jira-work-item) +To sign in to {% data variables.product.prodname_copilot %} for Jira app, follow the steps above in [You can see the {% data variables.copilot.copilot_cloud_agent %} but it is not possible to assign it to a Jira work item](#you-can-see-the-copilot-cloud-agent-but-it-is-not-possible-to-assign-it-to-a-jira-work-item). + +### Other users in your workspace can assign {% data variables.copilot.copilot_cloud_agent %} to a Jira work item, but you cannot + +If {% data variables.copilot.copilot_cloud_agent %} cannot see or work with your organization's resources in Jira and your organization uses SSO in {% data variables.product.github %}, you may need to reauthorize the {% data variables.product.prodname_copilot %} for Jira app for your {% data variables.product.github %} account. For more information, see [AUTOTITLE](/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso). + +To resolve this issue, follow these steps to start a new active SSO session for your organization: + +1. Go to your [organization settings](https://github.com/settings/organizations) in {% data variables.product.github %}. +1. Under "Single sign-on", find the organization you need to authenticate to and click **Sign out**, and then **Sign in**. + * If your enterprise manages SSO for your organization, signing in to one organization in the enterprise works as an SSO session for all organizations in the enterprise. +1. Return to Jira, and refresh the page you are working in. +1. Try working with {% data variables.copilot.copilot_cloud_agent %} in Jira again. ### {% data variables.product.prodname_copilot %} is not responding * Check {% data variables.product.github %}'s [Status page](https://githubstatus.com) for any active incidents. -* Verify that {% data variables.copilot.copilot_cloud_agent %} has access to the repository by testing if you can assign {% data variables.product.prodname_copilot_short %} to an issue on {% data variables.product.github %}. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/access-management). -* Verify that the {% data variables.product.prodname_copilot %} for Jira application has access to the repository. See [AUTOTITLE](/apps/using-github-apps/reviewing-and-modifying-installed-github-apps#modifying-repository-access). +* Check the [Atlassian status page](https://status.atlassian.com) for any active incidents. +* Verify that {% data variables.copilot.copilot_cloud_agent %} has access to the repository by testing if you can assign {% data variables.product.prodname_copilot_short %} to an issue on {% data variables.product.github %}. +* Verify that the {% data variables.product.prodname_copilot %} for Jira application has access to the repository. See [AUTOTITLE](/apps/using-github-apps/reviewing-and-modifying-installed-github-apps). ## Further reading