将 Copilot 云代理与 Jira 集成

注意

GitHub Copilot 使用 AI。检查是否有错误请参阅“应用卡片：GitHub Copilot 智能体”。

通过 GitHub Copilot Jira 中的集成，无需离开 Jira 工作区即可调用 Copilot云代理。在 Jira 中，您可以基于工作项的标题、描述、标签、评论以及任何 Atlassian 自定义字段（如验收标准）中的上下文信息，发起云代理会话并创建拉取请求。

先决条件

您必须拥有可通过付费GitHub计划访问Copilot的Copilot账户。
必须具有 Jira Cloud 帐户， Jira 必须是支持 AI 的应用，并且必须为组织激活 Rovo。请参阅 Atlassian 文档中的为应用激活 AI。
需要同时完成 Jira 和 GitHub 的安装与身份验证。

安装

若要安装 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 for Jira 后，你需要授权该应用访问你的 GitHub 组织和存储库。
安装后，在 Jira 的确认消息中单击“ 配置 ”。
- 如果未自动重定向，请前往 GitHub Copilot 上的 GitHub MarketplaceJira 安装页面。单击“安装” 。
如果您尚未登录 GitHub，请点击高亮显示的 登录到 GitHub，并按照提示登录您的 GitHub 账户并为该应用程序授权。
- 如果您的组织或企业使用单点登录（SSO），则您可能需要为您的组织启动有效的 SAML 会话，并完成额外的授权步骤。
单击“安装应用”，授予应用访问GitHub帐户上的信息的权限。
选择应用有权访问的组织和存储库。默认情况下，已为你的 Jira 工作区启用 GitHub 组织。（可选）在 “安装 GitHub Copilot for Jira” 页面上，_取消选中_您_不希望该应用访问的_组织和代码仓库。
单击“安装” 。
安装完成后，您将在 Jira 中的 GitHub Copilot for Jira 应用配置页面上看到已连接的组织列表。

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

请导航到 Atlassian 市场上的 GitHub CopilotJira（具有数据驻留的 GHEC）安装页。
在应用名称右侧，单击，然后在文本框中输入您的SUBDOMAIN.ghe.com。将 SUBDOMAIN 替换为企业的子域 GHE.com。
单击“保存配置”。****
单击“立即获取”。
选择要在其中安装 GitHub 应用的 Atlassian 站点。
单击“查看”以检查安装详细信息，然后单击“立即获取”。

在您的 Jira 站点中安装用于 Jira 的 GitHub Copilot 后，您需要授权该应用访问您的 GitHub 组织和代码仓库。
安装后，在 Jira 的确认消息中单击“ 配置 ”。
- 如果未自动重定向，请在 GitHub Copilot 企业可用的 SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira应用列表中查找适用于 Jira 的应用。单击“安装” 。
如果您尚未登录 GitHub，请点击高亮显示的 “登录到 GitHub”，然后按照提示登录您的 GitHub 账户并授权该应用程序。
- 如果您的组织或企业使用 SSO，您可能需要为您的组织启动活动 SAML 会话，并执行额外的授权步骤。
单击“安装应用”，授予应用访问GitHub帐户上的信息的权限。
选择应用有权访问的组织和存储库。默认情况下，你的 Jira 工作区已启用 GitHub 组织。（可选）在 “安装 GitHub Copilot for Jira” 页面上，_取消选中__您不希望应用程序具有访问权限_的组织和代码库。
单击“安装” 。
安装完成后，你将在 Jira 中的 GitHub Copilot for Jira 应用配置页面上看到已连接的组织列表。

在 Jira 中使用GitHub Copilot应用

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

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

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

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

分配GitHub Copilot 使用“分配者”字段的工作项。

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

使用 Jira 自动化。 在 Jira 自动化规则中，选择 “使用 GitHub Copilot ”操作并将流配置为使用基于 Jira 事件的自定义触发器，例如创建或转换工作项或应用标签时。有关更多信息，请参阅 Atlassian 文档中的在 Jira 中使用 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 提供进一步说明：
- 使用 “继续聊天” 按钮（位于 “代理” 标题下），直接与Copilot聊天，以对_当前_拉取请求进行更新。
- 在工作项的评论中提及 @GitHub Copilot，即可通过新的拉取请求提交更新。

提示

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

在 Jira 中查看代理活动

当云代理运行时，它会将其活动流实时显示在 Jira 的聊天面板中，因此你无需离开当前工作项，就能跟踪智能体正在执行的操作。活动流包含指向关联代理会话 GitHub的链接。

Jira 会话结束后重定向到 Copilot

当 Copilot云代理完成一个会话后，例如在拉取请求可供审查时，你可以指示 Copilot 继续这项工作：

在 Jira 的聊天面板中，选择指向 GitHub 上关联代理会话的链接。这会打开代理面板 GitHub，你可以在其中查看会话并发送后续说明以更新现有拉取请求。
在 Jira 工作项上添加后续 @GitHub Copilot 提及或注释。这会启动一个新会话并打开新的拉取请求，而不是更新现有请求。

Copilot云代理在 Jira 中自定义

您可以通过指定模型、代理和自定义指令，自定义 Copilot云代理在 Jira 工作区中的运行方式。

指定模型

如果希望任务在特定模型上运行而不是默认值，请指定模型。例如，对于常规且范围明确的更改，您可以选择较轻量的模型。若要更改用于 Copilot云代理特定任务的模型，请在说明 Copilot中包含模型名称，请参阅更改 GitHub Copilot 云代理的 AI 模型。

指定自定义代理

指定自定义代理以定制云代理特定工作流或存储库的行为。可以直接在 Jira 票证中指定 GitHub 存储库中的自定义代理。有关详细信息，请参阅“为Copilot云代理创建自定义代理”。

添加自定义指令

使用自定义指令设置适用于每个会话的默认选项，例如目标仓库，这样 Copilot 就不必在会话中途停下来向你询问信息。你可以在 Jira 工作区级别定义自定义说明，以便每次 Copilot云代理被触发时应用。

使用成本

Copilot云代理使用 GitHub Actions 分钟数和 AI credits。

有关详细信息，请参阅“组织和企业的基于使用情况的计费”。

向适用于 Jira 的 GitHub Copilot 应用添加或移除组织

Jira 管理员和组织 GitHub 所有者可以启用或禁用组织进行集成。

注意

如果在初始安装后向应用中添加了新的受 SSO 保护的组织，用户将需要在 GitHub 中为该组织启动一个有效的 SAML 会话，以使 Copilot云代理能够从 Jira 在该新组织的仓库中工作。有关详细信息，请参阅“关于使用单一登录进行身份验证”。

若要更改组织的 Jira 应用的访问权限 GitHub Copilot ，请执行以下操作：

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

故障排除

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

你看不到 Copilot云代理，并且无法将其分配给 Jira 工作项

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

Jira 是支持 AI 的应用，请参阅 Atlassian 文档中的激活应用的 AI。

您可以看到 Copilot云代理，但无法将其分配给 Jira 工作项。

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

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

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

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

工作区中的其他用户可以将 Copilot云代理分配给 Jira 工作项，但你不能

如果 Copilot云代理无法在 Jira 中查看或使用贵组织的资源，而您的组织在 GitHub 中使用 SSO，则您可能需要为您的 GitHub Copilot 帐户重新授权用于 Jira 的 GitHub 应用。有关详细信息，请参阅“关于使用单一登录进行身份验证”。

若要解决此问题，请按照以下步骤为组织启动新的活动 SSO 会话：

转到你的组织设置。GitHub
在“单一登录”下，找到需要进行身份验证的组织并单击 “注销”，然后登录。
- 如果您的企业为组织管理 SSO，则登录企业中的一个组织可以作为整个企业中所有组织的 SSO 会话。
返回到 Jira，并刷新正在使用的页面。
再次尝试在 Jira 中使用 Copilot云代理。

GitHub Copilot 未响应

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

谁可以使用此功能？

在本文中