将 Copilot 云代理与 Jira 集成

可以在 Jira 工作区中使用 GitHub 集成来提供上下文并打开拉取请求。

在本文中

注意

  • 此功能当前处于 公共预览版，并可能会发生更改。
          GitHub Copilot 使用 AI。 检查是否有错误 请参阅“[AUTOTITLE](/copilot/responsible-use/copilot-cloud-agent)”。
  • 您可以在GitHub Copilot提供有关GitHub的 Jira 集成的反馈。

通过 GitHub Copilot Jira 中的集成，无需离开 Jira 工作区即可调用 Copilot云代理 。 在 Jira 工作项中，您可以在工作项的标题、说明、标签、注释以及任何 Atlassian 自定义字段（如验收标准）的上下文中启动 云代理 会话并打开拉取请求。

先决条件

  • 必须具有GitHub帐户，有权通过Copilot、Copilot Pro、Copilot Pro+、Copilot业务或Copilot Enterprise进行访问。
  • 必须具有为组织启用以下 AI 功能的 Jira Cloud 帐户：
  • 需要同时完成 Jira 和 GitHub 的安装与身份验证。

注意

如果 Jira 站点位于发布轨道上，则应联系 Atlassian 支持部门，并要求在 Jira 中启用代理，然后再继续安装。 有关详细信息，请参阅 Atlassian 文档中的发布轨迹说明。

安装

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

  • Jira 站点的管理员权限。
  • 您的GitHub组织的所有者或GitHub应用管理器权限。

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

安装 GitHub Copilot 适用于 Jira 应用的 GitHub.com

  1. 导航到 Atlassian Marketplace 上的 Jira 安装页面GitHub Copilot。
  2. 单击“ 获取应用”。
  3. 选择要在其中安装应用程序的 GitHub Atlassian 实例。
  4. 单击“安装” 。
  5. 如果没有自动重定向，请访问上的Jira安装页，然后点击安装。
  6. 在“安装 GitHub Copilot Jira”页面中，选择您希望授予该应用程序访问权限的组织和存储库。
  7. 单击“安装” 。

安装 GitHub Copilot 适用于 Jira 应用的 GHE.com

  1. 请导航到 Atlassian 市场上的 GitHub CopilotJira（具有数据驻留的 GHEC）安装页。
  2. 在应用名称右侧，单击，然后在文本框中输入您的SUBDOMAIN.ghe.com。 将 SUBDOMAIN 替换为企业的子域 GHE.com。
  3. 单击“保存配置”。****
  4. 单击“ 获取应用”。
  5. 选择要在其中安装应用程序的 GitHub Atlassian 实例。
  6. 单击“安装” 。
  7. 如果未自动重定向，请在 GitHub Copilot 企业可用的 SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira应用列表中查找适用于 Jira 的应用。
  8. 单击“安装” 。
  9. 在“安装 GitHub Copilot Jira”页面中，选择您希望授予该应用程序访问权限的组织和存储库。
  10. 单击“安装” 。

将组织添加到 Jira 应用GitHub Copilot 中

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

若要为组织启用 GitHub Copilot Jira 应用，请执行以下操作：

  1. 在 Jira 中，转到工作区的设置页。
  2. 请进入GitHub Copilot应用的应用程序设置页面。
  3. （可选）单击“ 连接更多 GitHub 组织 ”，将新组织添加到列表中。
  4. 启用Copilot应用以支持一个或多个列出的组织。

在 Jira 中使用GitHub Copilot应用

在你所属的Copilot组织中，必须先启用GitHub应用，然后才能开始使用它。

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

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

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

  • 分配GitHub Copilot 使用“分配者”字段的工作项。
  •           在对工作项的注释中**提到**`@GitHub Copilot`。
  • 将 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. 如果您之前未将 GitHub 应用程序连接到 Jira 中的 GitHub 帐户，请按照提示为 GitHub 和 Atlassian 授权该应用程序。

  5. 一旦 Copilot云代理 开始处理拉取请求，Jira 工作项中将会出现注释。 启动代理会话的用户可以查看代理的进度更新。

  6. 您可以在工作项中提供关于 Copilot 的后续说明：

    • 在批注中提及 @GitHub Copilot 。
    • 使用“代理”标题下的 “继续聊天” 按钮直接与Copilot聊天。

提示

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

          Copilot云代理在 Jira 中自定义

可以通过指定模型、代理、自定义说明和分支规则，来自定义 Jira 工作区中 Copilot云代理 的运行方式。

指定模型

若要更改用于 Copilot云代理 特定任务的模型，请在说明 Copilot 中包含模型名称。 例如，你可以说 @GitHub Copilot use Claude Sonnet 4.5。 如果未指定模型， Copilot云代理 将使用默认模型来编码任务，请参阅 更改 GitHub Copilot 云代理的 AI 模型。

指定自定义分支

          云代理 遵循各个 Atlassian 票证中指定的分支命名规则。 如果票证包含特定的分支约定， Copilot 则会在创建拉取请求时读取并遵循这些约定，使存储库与现有工作流保持一致。

指定自定义代理

可以直接在 Jira 票证中指定 GitHub 存储库中的自定义代理。 这样，团队就可以根据自己的特定需求定制 云代理行为。 有关详细信息，请参阅“为Copilot云代理创建自定义代理”。

添加自定义指令

你可以在 Jira 工作区级别定义自定义说明，以便每次 Copilot云代理 被触发时应用。 使用这些说明可以指定默认值，例如目标存储库、默认分支命名规则、首选模型或要使用的特定代理。 这样可以减少重复的配置，并增加对代理行为的控制。

使用成本

          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 的 Jira 应用。

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

聊天 GitHub Copilot时，系统会提示你登录

若要登录到 GitHub Copilot Jira 应用，请按照上述步骤操作。您可以看到Copilot云代理 ，但无法将其分配给 Jira 工作项。

          GitHub Copilot 未响应

延伸阅读