将 Copilot 云代理与 Jira 集成

注意

此功能当前处于公共预览版，并可能会发生更改。

          GitHub Copilot 使用 AI。 检查是否有错误 请参阅“[AUTOTITLE](/copilot/responsible-use/copilot-cloud-agent)”。

您可以在GitHub Copilot提供有关GitHub的 Jira 集成的反馈。

通过 GitHub Copilot Jira 中的集成，无需离开 Jira 工作区即可调用 Copilot云代理。在 Jira 工作项中，可以通过使用工作项标题、说明、标签和注释的上下文来启动云代理会话，并打开拉取请求。

先决条件

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

注意

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

安装

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

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

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

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

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

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

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

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

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

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

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

在 Jira 中使用GitHub Copilot应用

在你所属的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云代理特定任务的模型，请在说明 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云代理

在 Jira 中，打开或创建一个包含您希望委托给Copilot云代理的明确要求的工作项。
若要指定要在其中工作的存储库 Copilot ，请在工作项说明或批注中提及它。

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

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

如果您之前未将 GitHub 应用程序连接到 Jira 中的 GitHub 帐户，请按照提示为 GitHub 和 Atlassian 授权该应用程序。
一旦 Copilot云代理开始处理拉取请求，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 的 Jira 应用。

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

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

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

          GitHub Copilot 未响应

检查 GitHub“ 状态”页中是否有任何活动事件。
确认Copilot云代理是否有权访问存储库，可以通过测试是否能够将Copilot分配给GitHub上的某个问题。请参阅“管理对 GitHub Copilot 云代理的访问权限”。
验证 Jira 应用程序是否有权访问 GitHub Copilot 存储库。请参阅“查看和修改已安装GitHub应用”。

延伸阅读

        [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent)

        [AUTOTITLE](/copilot/concepts/agents/cloud-agent/access-management)

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp#example-atlassian)

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

将 Copilot 云代理与 Jira 集成

在本文中