将 Copilot 云代理与 Jira 集成

您可以在 Jira 中使用 GitHub 集成提供上下文并打开拉取请求，全部在您的 Jira 工作区内完成。

本文内容

注意

Jira 中的 GitHub Copilot 集成允许您在不离开 Jira 工作区的情况下调用 Copilot 云代理。您可以在 Jira 工作项内启动云代理会话并打开拉取请求，利用工作项的标题、描述、标签和评论等上下文信息。

先决条件

  • 您必须拥有通过 Copilot Pro、Copilot Pro+、Copilot Business 或 Copilot Enterprise 访问 Copilot 的 GitHub 账户。
  • 您必须拥有已为组织启用以下 AI 功能的 Jira Cloud 账户。
  • 必须完成 Jira 和 GitHub 的安装和身份验证。

注意

如果您的 Jira 站点处于发行轨道（release tracks），请联系 Atlassian 支持并请求在继续安装之前在 Jira 中启用代理。更多信息请参阅 Atlassian 文档中的 发行轨道是什么。

安装

要安装 GitHub Copilot for Jira 应用并为您的 GitHub 组织或企业账户授权，您需要

  • Jira 站点的管理员权限。
  • GitHub 组织的所有者或 GitHub App 管理员权限。

此集成依赖于 Atlassian Forge 应用和 GitHub 应用。两者缺一不可。成功安装后，具备对 GitHub 仓库写入权限的 Jira 工作区授权用户即可从 Jira 触发代理。

为 GitHub.com 安装 GitHub Copilot for Jira 应用

  1. 前往 Atlassian Marketplace 的 GitHub Copilot for Jira 安装页面。
  2. 点击 获取应用。
  3. 选择您希望在其中安装 GitHub 应用的 Atlassian 实例。
  4. 点击 安装。
  5. 如果未自动重定向，请前往 GitHub Marketplace 的 GitHub Copilot for Jira 安装页面 并点击 安装。
  6. 在 Install GitHub Copilot for Jira 页面，选择您希望授予应用访问权限的组织和仓库。
  7. 点击 安装。

为 GHE.com 安装 GitHub Copilot for Jira 应用

  1. 前往 Atlassian Marketplace 的 GitHub Copilot for Jira（带数据驻留的 GHEC）安装页面。
  2. 在应用名称右侧，点击，并在文本框中输入您的 SUBDOMAIN.ghe.com。请将 SUBDOMAIN 替换为您企业的 GHE.com 子域名。
  3. 点击 保存配置。
  4. 点击 获取应用。
  5. 选择您希望在其中安装 GitHub 应用的 Atlassian 实例。
  6. 点击 安装。
  7. 如果未自动重定向，请在 SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira 中找到可供您企业使用的 GitHub Copilot for Jira 应用。
  8. 点击 安装。
  9. 在 Install GitHub Copilot for Jira 页面，选择您希望授予应用访问权限的组织和仓库。
  10. 点击 安装。

向 GitHub Copilot for Jira 应用添加组织

应用安装后，Jira 管理员和 GitHub 组织所有者可以为其他组织启用该应用。这使得组织内的任何成员都可以将自己的 GitHub 账户连接到该应用，并在 Jira 中使用它。

为组织启用 GitHub Copilot for Jira 应用的步骤

  1. 在 Jira 中，前往您空间的设置页面。
  2. 进入 GitHub Copilot 应用的应用设置页面。
  3. 如有需要，点击 Connect More GitHub Organizations 将新组织添加到列表中。
  4. 为列表中一个或多个组织启用 Copilot 应用。

在 Jira 中使用 GitHub Copilot 应用

在您所属的 GitHub 组织中启用 Copilot 应用后，才能开始使用。

首次在 Jira 中使用 Copilot 云代理时，您需要将其连接到您的 GitHub 账户。

只有对仓库具有写入权限的用户才能触发 Copilot 云代理在该仓库中工作。

您可以通过以下三种方式触发 Copilot 云代理

  • 指派 GitHub Copilot 给工作项（使用受理人字段）。
  • 提及 @GitHub Copilot 于工作项的评论中。
  • 将 Copilot 添加到工作流转换，使其在工作项移动到特定状态时自动触发。请参阅 使用 AI 代理协作工作项获取设置说明。

若要为特定任务更改 Copilot 云代理使用的模型，请在对 Copilot 的指令中包含模型名称。例如，您可以说 @GitHub Copilot use Claude Sonnet 4.5 to create a new API endpoint for user authentication in octo-org/octorepo。若未指定模型，Copilot 云代理将使用默认的编码任务模型，详见 更改 GitHub Copilot 云代理的 AI 模型。

注意

当您将 Copilot 指派给 Jira 工作项时，代理从 Jira 捕获的上下文会被添加到拉取请求中，且如果仓库为公开，则对所有人可见。

示例：从 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 提供进一步指令

    • 在评论中提及 @GitHub Copilot。
    • 在 Agents（代理） 标题下使用 Continue in Chat（在聊天中继续） 按钮直接与 Copilot 对话。

提示

如果在 1 分钟后仍未收到触发 Copilot 云代理的确认，请刷新 Jira 工作项页面。

使用费用

Copilot 云代理使用 GitHub Actions 的分钟数以及 Copilot 高级请求。

在您每月的 GitHub Actions 与高级请求配额范围内，您可以让 Copilot 云代理执行编码任务而无需产生额外费用。

更多信息请参阅 GitHub Copilot 高级请求。

故障排除

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

看不到 Copilot 云代理，且无法将其指派给 Jira 工作项

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

  1. Jira 必须是 AI 启用的应用，参见 Atlassian 文档中的 为应用激活 AI。
  2. Beta AI 功能已启用，参见 Atlassian 文档中的 控制对 Beta AI 功能的访问。

可以看到 Copilot 云代理，但无法将其指派给 Jira 工作项

检查您是否已将 GitHub 个人账户连接到 GitHub Copilot for Jira 应用。

  1. 在 Jira 中，前往个人账户的设置页面。
  2. 在通用设置下，选择 GitHub Copilot for Jira 应用。
  3. 如果尚未使用 GitHub 登录，请按照提示登录并授权该应用。

在与 GitHub Copilot 对话时，系统会提示您登录

要登录 GitHub Copilot for Jira 应用，请参照上文 可以看到 Copilot 云代理，但无法将其指派给 Jira 工作项 中的步骤进行操作。

GitHub Copilot 未响应

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.