# 将 Copilot 云代理与 Jira 集成

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

> \[!NOTE]
> GitHub Copilot 使用 AI。 检查是否有错误 请参阅“[应用卡片：GitHub Copilot 智能体](/zh/copilot/responsible-use/agents)”。

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

## 先决条件

* 你必须拥有一个 GitHub 帐户，通过 Copilot 付费计划才能访问 Copilot。
* 必须具有 Jira Cloud 帐户， **Jira 必须是支持 AI 的应用**，并且必须为组织激活 Rovo。 请参阅 Atlassian 文档中的 [为应用激活 AI](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products)。
* 需要同时完成 Jira 和 GitHub 的安装与身份验证。

## 安装

要安装适用于 Jira 的 GitHub Copilot 应用并向其授予访问你的 GitHub 组织或企业帐户的权限，你需要满足以下条件：

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

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

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

1. 导航到 Atlassian Marketplace 上的 Jira 安装页面[GitHub Copilot](https://marketplace.atlassian.com/apps/1582455624?ref_product=copilot\&ref_type=engagement\&ref_style=text)。

2. 单击“**立即获取”。**

3. 选择要在其中安装 GitHub 应用程序的 Atlassian 站点。

4. 单击“**查看**”以检查安装详细信息，然后单击“**立即获取”。**

   在你的 Jira 站点中安装 GitHub Copilot for Jira 后，你需要授权该应用访问你的 GitHub 组织和存储库。

5. 安装后，在 Jira 的确认消息中单击“ **配置** ”。
   * 如果未自动重定向，请前往 GitHub Copilot 上的 GitHub Marketplace。 单击“安装”。\*\*\*\*

6. 如果你尚未登录到 GitHub，请单击高亮显示的**登录到 GitHub**，按照提示登录你的 GitHub 帐户并为该应用程序授权。
   * 如果您的组织或企业使用单点登录（SSO），则您可能需要为您的组织启动有效的 SAML 会话，并完成额外的授权步骤。

7. 单击“**安装应用**”，授予应用访问GitHub帐户上的信息的权限。

8. 选择应用有权访问的组织和存储库。 默认情况下，已为你的 Jira 工作区启用 GitHub 组织。 （可选）在 **“安装 GitHub Copilot for Jira”** 页面上，\_取消选中\_您\_不希望该应用访问的\_组织和代码仓库。

9. 单击“安装”。\*\*\*\*

10. 安装完成后，您将在 Jira 中的 GitHub Copilot for Jira 应用配置页面上看到已连接的组织列表。

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

1. 请导航到 Atlassian Marketplace 上的适用于 Jira 的 [GitHub Copilot（具有数据驻留的 GHEC）安装页](https://marketplace.atlassian.com/apps/3637796809?ref_product=copilot\&ref_type=engagement\&ref_style=text)。

2. 在应用名称右侧，单击<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Configure" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>，然后在文本框中输入您的`SUBDOMAIN.ghe.com`。 将 SUBDOMAIN 替换为企业的子域 GHE.com。

3. 单击“保存配置”。\*\*\*\*

4. 单击“**立即获取”。**

5. 选择要在其中安装 GitHub 应用程序的 Atlassian 站点。

6. 单击“**查看**”以检查安装详细信息，然后单击“**立即获取”。**

   在你的 Jira 站点中安装 GitHub Copilot for Jira 后，你需要授权该应用访问你的 GitHub 组织和存储库。

7. 安装后，在 Jira 的确认消息中单击“ **配置** ”。
   * 如果未自动重定向，请在你的企业的可用应用列表中找到适用于 Jira 的 GitHub Copilot 应用，位置为 `SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira`。 单击“安装”。\*\*\*\*

8. 如果你尚未登录到 GitHub，请单击高亮显示的**登录到 GitHub**，按照提示登录你的 GitHub 帐户并为该应用程序授权。
   * 如果您的组织或企业使用 SSO，您可能需要为您的组织启动活动 SAML 会话，并执行额外的授权步骤。

9. 单击“**安装应用**”，授予应用访问GitHub帐户上的信息的权限。

10. 选择应用有权访问的组织和存储库。 默认情况下，已为你的 Jira 工作区启用 GitHub 组织。 （可选）在 **“安装 GitHub Copilot for Jira”** 页面上，\_取消选中\_您\_不希望该应用访问的\_组织和代码仓库。

11. 单击“安装”。\*\*\*\*

12. 安装完成后，您将在 Jira 中的 GitHub Copilot for Jira 应用配置页面上看到已连接的组织列表。

## 在 Jira 中使用GitHub Copilot应用

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

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

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

可以通过多种方式触发 Copilot cloud agent ：

* ```
            **将**GitHub Copilot 分配给使用“分配者”字段的工作项。
  ```
* ```
            在对工作项的注释中**提到**`@GitHub Copilot`。
  ```
* **使用 Jira 自动化。** 在 Jira 自动化规则中，选择 **“使用 GitHub Copilot** ”操作并将流配置为使用基于 Jira 事件的自定义触发器，例如创建或转换工作项或应用标签时。 有关更多信息，请参阅 Atlassian 文档中的 [在 Jira 中使用 AI 代理](https://support.atlassian.com/jira-software-cloud/docs/work-with-ai-agents-in-jira/)。

> \[!NOTE]
> 分配给 Copilot Jira 工作项时，代理从 Jira 捕获的上下文将添加到拉取请求中，如果存储库是公共的，则 **每个人都可以看到** 。

### 示例：从 Jira 工作项触发Copilot cloud agent

1. 在 Jira 中，打开或创建一个包含您希望委托给Copilot cloud agent的明确要求的工作项。

2. 若要指定要在其中工作的存储库 Copilot ，请在工作项说明或批注中提及它。

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

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

4. 如果您之前未将 GitHub 应用程序连接到 Jira 中的 GitHub 帐户，请按照提示为 GitHub 和 Atlassian 授权该应用程序。

5. 一旦 Copilot cloud agent 开始处理拉取请求，Jira 的聊天面板中就会显示一条评论。 启动代理会话的用户可以查看该会话的进度。

6. 你可以向 Copilot 提供后续指令：
   * 使用 **“继续聊天”** 按钮（位于 **“代理”** 标题下），直接与Copilot聊天，以对\_当前\_拉取请求进行更新。
   * 在工作项的评论中提及 `@GitHub Copilot`，即可通过\_新的\_拉取请求提交更新。

> \[!TIP]
> 如果在 1 分钟后未收到触发 Copilot cloud agent 的确认，请刷新 Jira 工作项页。

### 在 Jira 中查看代理活动

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

### 在会话完成后从 Jira 向 Copilot 发出指令

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

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

## Copilot cloud agent在 Jira 中自定义

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

### 指定模型

如果希望任务在特定模型上运行而不是默认值，请指定模型。 例如，对于常规且范围明确的更改，您可以选择较轻量的模型。 若要更改用于 Copilot cloud agent 特定任务的模型，请在说明 Copilot中包含模型名称，请参阅 [更改 GitHub Copilot 云代理的 AI 模型](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)。

### 指定自定义代理

指定自定义代理以定制 cloud agent特定工作流或存储库的行为。 可以直接在 Jira 票证中指定 GitHub 存储库中的自定义代理。 有关详细信息，请参阅“[为Copilot cloud agent创建自定义代理](/zh/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)”。

### 添加自定义指令

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

## 使用成本

Copilot cloud agent 使用 GitHub Actions 分钟额度和 AI credits。

有关详细信息，请参阅“[组织和企业的基于使用情况的计费](/zh/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises)”。

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

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

> \[!NOTE]
> 如果在初始安装后向应用中添加了新的受 SSO 保护的组织，用户将需要在 GitHub 中为该组织启动一个有效的 SAML 会话，以使 Copilot cloud agent 能够从 Jira 在该新组织的仓库中工作。 有关详细信息，请参阅“[关于使用单一登录进行身份验证](/zh/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso)”。

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

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

## 故障排除

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

### 你看不到 Copilot cloud agent ，并且无法将其分配给 Jira 工作项

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

1. Jira 是支持 AI 的应用，请参阅 Atlassian 文档中的 [激活应用的 AI](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products)。

### 您可以看到 Copilot cloud agent，但无法将其分配给 Jira 工作项。

检查你是否已将 GitHub 上的个人帐户关联到适用于 Jira 的 GitHub Copilot 应用。

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

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

要登录到适用于 Jira 的 GitHub Copilot 应用，请按照[可以看到 Copilot cloud agent，但无法将其分配给 Jira 工作项](#you-can-see-the-copilot-cloud-agent-but-it-is-not-possible-to-assign-it-to-a-jira-work-item)中的上述步骤操作。

### 工作区中的其他用户可以将 Copilot cloud agent 分配给 Jira 工作项，但你不能

如果 Copilot cloud agent 无法查看或使用你的组织在 Jira 中的资源，而你的组织在 GitHub 中使用 SSO，则可能需要为你的 GitHub Copilot 帐户重新授权适用于 Jira 的 GitHub 应用。 有关详细信息，请参阅“[关于使用单一登录进行身份验证](/zh/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso)”。

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

1. 转到你的[组织设置](https://github.com/settings/organizations)。GitHub
2. 在“单一登录”下，找到需要进行身份验证的组织并单击 **“注销**”，然后 **登录**。
   * 如果你的企业为组织管理 SSO，则在企业中的一个组织登录即作为该企业所有组织的 SSO 会话。
3. 返回到 Jira，并刷新正在使用的页面。
4. 再次尝试在 Jira 中使用 Copilot cloud agent。

### GitHub Copilot 未响应

* 检查 GitHub“ [状态”页](https://githubstatus.com) 中是否有任何活动事件。
* 检查 [Atlassian 状态页](https://status.atlassian.com) 中是否有任何活动事件。
* 确认Copilot cloud agent是否有权访问存储库，可以通过测试是否能够将Copilot分配给GitHub上的某个问题。
* 验证 Jira 应用程序是否有权访问 GitHub Copilot 存储库。 请参阅“[查看和修改已安装GitHub应用](/zh/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)”。

## 延伸阅读

* [关于 GitHub Copilot 云代理](/zh/copilot/concepts/agents/cloud-agent/about-cloud-agent)
* [管理对 GitHub Copilot 云代理的访问权限](/zh/copilot/concepts/agents/cloud-agent/access-management)
* [为存储库配置 MCP 服务器](/zh/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#example-atlassian)
* 在 Atlassian 文档中[与 AI 代理协作处理工作项](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/)