Skip to main content

Integración del agente de codificación Copilot con Jira

Puede usar la integración de GitHub en Jira para proporcionar contexto y abrir solicitudes de incorporación de cambios, todo directamente desde su área de trabajo de Jira.

Nota:

The GitHub Copilot integration in Jira allows you to invoke Copilot cloud agent without leaving your Jira workspace. From within a Jira work item you can initiate cloud agent sessions and open pull requests, using the context of the work item's title, description, labels, and comments.

Prerequisites

  • You must have a GitHub account with access to Copilot through Copilot Pro, Copilot Pro+, Copilot Business, or Copilot Enterprise.
  • You must have a Jira Cloud account with the following AI features enabled for your organization:
  • Installation and authentication must be completed for both Jira and GitHub.

Nota:

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? in the Atlassian documentation.

Installation

To install the GitHub Copilot for Jira app and authorize it for your GitHub organization or enterprise account, you need:

  • Administrator permission for your Jira site.
  • Owner or GitHub App manager permissions for your GitHub organization.

This integration relies on an Atlassian Forge application and a GitHub application. Both are required for the integration. Once successfully installed, authorized users of the Jira workspace with write access to a GitHub repository will be able to trigger the agent from Jira.

Installing the GitHub Copilot for Jira app for GitHub.com

  1. Navigate to the GitHub Copilot for Jira installation page on the Atlassian Marketplace.
  2. Click Get app.
  3. Select the Atlassian instance you want to install the GitHub application in.
  4. Click Install.
  5. If you are not automatically redirected, go to the GitHub Copilot for Jira installation page on the GitHub Marketplace and click Install.
  6. In the Install GitHub Copilot for Jira page, select the organization and repositories you would like to give the application access to.
  7. Click Install.

Installing the GitHub Copilot for Jira app for GHE.com

  1. Navigate to the GitHub Copilot for Jira (GHEC with Data Residency) installation page on the Atlassian Marketplace.
  2. To the right of the app name, click , and enter your SUBDOMAIN.ghe.com in the text box. Replace SUBDOMAIN with your enterprise's subdomain of GHE.com.
  3. Click Save configuration.
  4. Click Get app.
  5. Select the Atlassian instance you want to install the GitHub application in.
  6. Click Install.
  7. If you are not automatically redirected, find the GitHub Copilot for Jira app in the list of apps available to your enterprise at SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira.
  8. Click Install.
  9. In the Install GitHub Copilot for Jira page, select the organization and repositories you would like to give the application access to.
  10. Click Install.

Adding an organization to the GitHub Copilot for Jira app

Once the GitHub Copilot for Jira app has been installed, a Jira administrator and GitHub organization owner can enable additional organizations to use the app. This allows any member of the organization to connect their GitHub account to the app and start using it in Jira.

To enable the GitHub Copilot for Jira app for an organization:

  1. In Jira, go to the settings page for your space.
  2. Go to the applications setting page for the GitHub Copilot app.
  3. Optionally, click Connect More GitHub Organizations to add new organizations to the list.
  4. Enable the Copilot app for one or more of the listed organizations.

Using the GitHub Copilot app in Jira

The Copilot app must be enabled for a GitHub organization you are a member of, before you can start using it.

The first time you use Copilot cloud agent in Jira, you will need to connect it to your GitHub account.

Only users with write access to a repository can trigger Copilot cloud agent to work in that repository.

You can trigger Copilot cloud agent in three ways:

  • Assign GitHub Copilot to a work item using the Assignee field.
  • Mention @GitHub Copilot in a comment on a work item.
  • Add Copilot 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 for setup instructions.

To change the model used by Copilot cloud agent for a specific task, include the model name in your instructions to Copilot. For example, you can say @GitHub Copilot use Claude Sonnet 4.5 to create a new API endpoint for user authentication in octo-org/octorepo. If you do not specify a model, Copilot cloud agent will use the default model for coding tasks, see Changing the AI model for GitHub Copilot cloud agent.

Nota:

When you assign Copilot 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.

Example: Triggering Copilot cloud agent from a Jira work item

  1. In Jira, open or create a work item that contains clear requirements you want to delegate to Copilot cloud agent.

  2. To specify a repository you want Copilot to work in, mention it in the work item description or in a comment.

  3. Assign GitHub Copilot to the work item, or mention @GitHub Copilot in a comment. For example:

    @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo
    
  4. If you have not previously connected the GitHub application in Jira to your GitHub account, follow the prompts to authorize the application for both GitHub and Atlassian.

  5. Once 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.

  6. You can follow up with further instructions for Copilot in a work item:

    • Mention @GitHub Copilot in a comment.
    • Use the Continue in Chat button under the Agents heading to chat directly with Copilot.

Sugerencia

If you have not received confirmation of triggering Copilot cloud agent after 1 minute, refresh the Jira work item page.

Usage costs

Copilot cloud agent uses GitHub Actions minutes and Copilot premium requests.

Within your monthly usage allowance for GitHub Actions and premium requests, you can ask Copilot cloud agent to work on coding tasks without incurring any additional costs.

For more information, see GitHub Copilot premium requests.

Troubleshooting

If you run into problems, try the following solutions.

You can't see the Copilot cloud agent and it is not possible to assign it to a Jira work item

In Jira, check your Atlassian Administration settings for your organization are set as follows.

  1. Jira is an AI-enabled app, see Activate AI for apps in the Atlassian documentation.
  2. Beta AI features are enabled, see Control access to beta AI features in the Atlassian documentation.

You can see the Copilot cloud agent but it is not possible to assign it to a Jira work item

Check that you have connected your personal account on GitHub to the GitHub Copilot for Jira app.

  1. In Jira, go to the settings page for your personal account.
  2. Under your general settings, select the GitHub Copilot for Jira app.
  3. If you are not already signed in with GitHub, follow the prompts to sign in and authorize the application.

When chatting with GitHub Copilot, you are prompted to sign in

To sign in to GitHub Copilot for Jira app, follow the steps above in You can see the Copilot cloud agent but it is not possible to assign it to a Jira work item

GitHub Copilot is not responding

Further reading