将 Copilot 编码代理与Jira集成

注意

此功能目前为公共预览版，可能会更改。

你可以在 GitHub 调查中提供有关 GitHub Copilot for Jira 集成的反馈。

Jira 中的 GitHub Copilot 集成允许你在不离开 Jira 工作区的情况下调用 Copilot编程助理。在 Jira 工作项中，你可以启动编码代理会话并打开 pull request，使用工作项的标题、描述、标签和评论的上下文。

先决条件

你必须有 GitHub 帐户，并可通过 Copilot Pro、Copilot Pro+、Copilot业务或 Copilot Enterprise 访问 Copilot。
必须具有为组织启用以下 AI 功能的 Jira Cloud 帐户： * Jira 必须是支持 AI 的应用 ，并且必须激活 Rovo。请参阅 Atlassian 文档中的为应用激活 AI。
- 必须启用 Beta AI 功能。请参阅 Atlassian 文档中的“控制对 beta AI 功能的访问 ”。
必须为 Jira 和 GitHub完成安装和身份验证。

安装

若要安装 GitHub Copilot 的 Jira 应用，并将其授权给 GitHub 组织或企业账户，您需要：

Jira 站点的管理员权限。
需要拥有你组织的 GitHub 所有者或 App 管理权限。

此集成依赖于 Atlassian Forge 应用程序和 GitHub 应用程序。这两者都是集成所必需的。成功安装后，授权用户如果在 Jira 工作区具有对 GitHub 存储库的写入权限，将能从 Jira 启动代理。

在 GitHub.com

上为 Jira 安装 GitHub Copilot 应用

导航到 Atlassian Marketplace 上 GitHub Copilot 的 Jira 安装页面。
单击“ 获取应用”。
选择要在其中安装 GitHub 应用程序的 Atlassian 实例。
单击“安装” 。
如果未自动重定向，请转到 GitHub Marketplace 上的 GitHub Copilot for Jira 安装页，然后单击“安装”。****
在 安装 GitHub Copilot for Jira 页面中，选择您希望授予应用程序访问权限的组织和存储库。
- 应用安装后，你可以添加额外组织，请参阅为 Jira 版 GitHub Copilot 应用添加组织。
单击“安装” 。

为 GHE.com

安装 GitHub Copilot for Jira 应用

在 Atlassian Marketplace 中导航至 Jira（GHEC 数据驻留）版 GitHub Copilot 安装页面。
在应用名称右侧，单击，在文本框中输入你的 SUBDOMAIN.ghe.com。将 SUBDOMAIN 替换为你企业在 GHE.com 的子域名。
单击“保存配置”。****
单击“ 获取应用”。
选择要在其中安装 GitHub 应用程序的 Atlassian 实例。
单击“安装” 。
如果没有自动重定向，请在可用企业应用列表中找到 Jira 版 GitHub Copilot 应用，位置为 SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira。
单击“安装” 。
在 安装 GitHub Copilot for Jira 页面中，选择您希望授予应用程序访问权限的组织和存储库。
- 应用安装后，你可以添加额外组织，请参阅为 Jira 版 GitHub Copilot 应用添加组织。
单击“安装” 。

为 Jira 版 GitHub Copilot 应用添加组织

安装了 Jira 的 GitHub Copilot 应用后，Jira 管理员和 GitHub 组织所有者可以启用其他组织来使用该应用。这样，组织的任何成员就可以将其 GitHub 帐户连接到应用，并开始在 Jira 中使用。

启用 Jira 版 GitHub Copilot 应用：

在 Jira 中，转到空间的设置页。
进入 GitHub Copilot 应用的应用设置页面
（可选）单击“ 连接更多 GitHub 组织 ”，将新组织添加到列表中。
为一个或多个列出的组织启用 Copilot 应用

在 Jira 中使用 GitHub Copilot 工具

你必须在所属的 GitHub 组织中启用该应用，才能开始使用

首次在 Jira 中使用 Copilot编程助理时，您需要将其与您的 GitHub 帐户连接。

仅具有仓库写入权限的用户可在该仓库触发 Copilot编程助理

可以通过三种方式触发 Copilot编程助理：

          使用“被分派人”字段将 GitHub Copilot **分配**给工作项。

          在对工作项的注释中**提到**`@GitHub Copilot`。

          **将 Copilot 添加到工作流转换**，以便在工作项移动到特定状态时自动触发。 有关设置说明，请参阅 [使用 AI 代理协作处理工作项](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/#Add-an-agent-to-workflow-transitions) 。

注意

将 Copilot 分配给 Jira 工作项时，智能体从 Jira 捕获的上下文会被添加到拉取请求中，若存储库公开，所有人可见。

示例：从 Jira 工作项触发 Copilot编程助理

在 Jira 中，打开或创建包含明确需求的工作项，以委派给 Copilot编程助理
如需指定仓库供 Copilot 使用，请在工作项描述或评论中提及

将 GitHub Copilot 分配到工作项，或在注释中提及 @GitHub Copilot。例如：

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

如果您以前未将 Jira 中的 GitHub 应用程序连接到您的 GitHub 帐户，请按照提示同时为 GitHub 和 Atlassian 授权该应用程序。
一旦 Copilot编程助理开始处理 pull request，Jira 工作项中会出现一条评论启动代理会话的用户可以查看代理的进度更新。
你可以在工作项中继续向 Copilot 提供指令：
- 在批注中提及 @GitHub Copilot 。
- 使用“继续聊天”按钮在“智能体”标题下直接与 Copilot 聊天。********

提示

如果在 1 分钟后未收到关于触发 Copilot编程助理的确认，请刷新 Jira 工作项页面。

使用成本

Copilot编程助理使用 GitHub Actions 分钟数和 Copilot 高级请求。

在 GitHub Actions 和高级请求的每月使用额度内，你可以要求 Copilot编程助理处理编码任务，无需支付额外费用。

有关详细信息，请参阅“GitHub Copilot付费请求”。

故障排除

如果遇到问题，请尝试以下解决方案。

你可以看到 Copilot编程助理，但无法将其分配给 Jira 工作项

在 Jira 中，检查你的组织的 Atlassian 管理设置是否如下所示。

Jira 是支持 AI 的应用，请参阅 Atlassian 文档中的激活应用的 AI。
已启用 Beta AI 功能，请参阅 Atlassian 文档中对 beta AI 功能的控制访问权限。

你可以看到 Copilot编程助理，但无法将其分配给 Jira 工作项

检查你是否已将 GitHub 上的个人帐户连接到 GitHub Copilot for Jira 应用。

在 Jira 中，转到用户帐户的个人设置页面。
在常规设置下，选择 GitHub Copilot for Jira 应用。
如果尚未使用 GitHub登录，请按照提示授权应用程序。

GitHub Copilot 没有响应

检查 GitHub的 “状态”页，了解任何活动事件。
通过测试你是否可以将 Copilot 分配给 GitHub 上的议题，验证 Copilot编程助理是否有权访问存储库。请参阅“管理对 GitHub Copilot 编码代理的访问”。
验证 Jira 版 GitHub Copilot 应用是否具有仓库访问权限请参阅“查看和修改已安装GitHub应用”。

延伸阅读

        [AUTOTITLE](/copilot/concepts/coding-agent/coding-agent)

        [AUTOTITLE](/copilot/concepts/coding-agent/enable-coding-agent)

在 Atlassian 文档中与 AI 代理协作处理工作项

在本文中