{"meta":{"title":"将 Copilot 云代理与 Jira 集成","intro":"你可以在 Jira 中使用 GitHub 集成，以便在 Jira 工作区内提供上下文并打开拉取请求。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/zh/enterprise-cloud@latest/copilot/how-tos","title":"操作方法"},{"href":"/zh/enterprise-cloud@latest/copilot/how-tos/copilot-integrations","title":"Copilot集成"},{"href":"/zh/enterprise-cloud@latest/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-jira","title":"将云代理与 Jira 集成"}],"documentType":"article"},"body":"# 将 Copilot 云代理与 Jira 集成\n\n你可以在 Jira 中使用 GitHub 集成，以便在 Jira 工作区内提供上下文并打开拉取请求。\n\n> \\[!NOTE]\n> GitHub Copilot 使用 AI。 检查是否有错误 请参阅“[应用卡片：GitHub Copilot 智能体](/zh/enterprise-cloud@latest/copilot/responsible-use/agents)”。\n\n通过 GitHub Copilot Jira 中的集成，无需离开 Jira 工作区即可调用 Copilot cloud agent 。 在 Jira 中，您可以基于工作项的标题、描述、标签、评论以及任何 Atlassian 自定义字段（如验收标准）中的上下文信息，发起 cloud agent 会话并创建拉取请求。\n\n## 先决条件\n\n* 你必须拥有一个 GitHub 帐户，通过 Copilot 付费计划才能访问 Copilot。\n* 必须具有 Jira Cloud 帐户， **Jira 必须是支持 AI 的应用**，并且必须为组织激活 Rovo。 请参阅 Atlassian 文档中的 [为应用激活 AI](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products)。\n* 需要同时完成 Jira 和 GitHub 的安装与身份验证。\n\n## 安装\n\n要安装适用于 Jira 的 GitHub Copilot 应用并向其授予访问你的 GitHub 组织或企业帐户的权限，你需要满足以下条件：\n\n* Jira 站点的管理员权限。\n* 你的 GitHub 组织的所有者或 GitHub 应用管理器权限。\n\n此集成依赖于 Atlassian Forge 应用程序和 GitHub 应用程序。 这两者都是集成所必需的。 成功安装后，具有 **存储库写入** 访问权限 GitHub 的 Jira 工作区的授权用户将能够从 Jira 触发代理。\n\n### 为 GitHub Copilot 安装适用于 Jira 的 GitHub.com 应用\n\n1. 导航到 Atlassian Marketplace 上的 Jira 安装页面[GitHub Copilot](https://marketplace.atlassian.com/apps/1582455624?ref_product=copilot\\&ref_type=engagement\\&ref_style=text)。\n\n2. 单击“**立即获取”。**\n\n3. 选择要在其中安装 GitHub 应用程序的 Atlassian 站点。\n\n4. 单击“**查看**”以检查安装详细信息，然后单击“**立即获取”。**\n\n 在你的 Jira 站点中安装 GitHub Copilot for Jira 后，你需要授权该应用访问你的 GitHub 组织和存储库。\n\n5. 安装后，在 Jira 的确认消息中单击“ **配置** ”。\n * 如果未自动重定向，请前往 GitHub Copilot 上的 GitHub Marketplace。 单击“安装”。\\*\\*\\*\\*\n\n6. 如果你尚未登录到 GitHub，请单击高亮显示的**登录到 GitHub**，按照提示登录你的 GitHub 帐户并为该应用程序授权。\n * 如果您的组织或企业使用单点登录（SSO），则您可能需要为您的组织启动有效的 SAML 会话，并完成额外的授权步骤。\n\n7. 单击“**安装应用**”，授予应用访问GitHub帐户上的信息的权限。\n\n8. 选择应用有权访问的组织和存储库。 默认情况下，已为你的 Jira 工作区启用 GitHub 组织。 （可选）在 **“安装 GitHub Copilot for Jira”** 页面上，\\_取消选中\\_您\\_不希望该应用访问的\\_组织和代码仓库。\n\n9. 单击“安装”。\\*\\*\\*\\*\n\n10. 安装完成后，您将在 Jira 中的 GitHub Copilot for Jira 应用配置页面上看到已连接的组织列表。\n\n### 为 GitHub Copilot 安装适用于 Jira 的 GHE.com 应用\n\n1. 请导航到 Atlassian Marketplace 上的适用于 Jira 的 [GitHub Copilot（具有数据驻留的 GHEC）安装页](https://marketplace.atlassian.com/apps/3637796809?ref_product=copilot\\&ref_type=engagement\\&ref_style=text)。\n\n2. 在应用名称右侧，单击，然后在文本框中输入您的`SUBDOMAIN.ghe.com`。 将 SUBDOMAIN 替换为企业的子域 GHE.com。\n\n3. 单击“保存配置”。\\*\\*\\*\\*\n\n4. 单击“**立即获取”。**\n\n5. 选择要在其中安装 GitHub 应用程序的 Atlassian 站点。\n\n6. 单击“**查看**”以检查安装详细信息，然后单击“**立即获取”。**\n\n 在你的 Jira 站点中安装 GitHub Copilot for Jira 后，你需要授权该应用访问你的 GitHub 组织和存储库。\n\n7. 安装后，在 Jira 的确认消息中单击“ **配置** ”。\n * 如果未自动重定向，请在你的企业的可用应用列表中找到适用于 Jira 的 GitHub Copilot 应用，位置为 `SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira`。 单击“安装”。\\*\\*\\*\\*\n\n8. 如果你尚未登录到 GitHub，请单击高亮显示的**登录到 GitHub**，按照提示登录你的 GitHub 帐户并为该应用程序授权。\n * 如果您的组织或企业使用 SSO，您可能需要为您的组织启动活动 SAML 会话，并执行额外的授权步骤。\n\n9. 单击“**安装应用**”，授予应用访问GitHub帐户上的信息的权限。\n\n10. 选择应用有权访问的组织和存储库。 默认情况下，已为你的 Jira 工作区启用 GitHub 组织。 （可选）在 **“安装 GitHub Copilot for Jira”** 页面上，\\_取消选中\\_您\\_不希望该应用访问的\\_组织和代码仓库。\n\n11. 单击“安装”。\\*\\*\\*\\*\n\n12. 安装完成后，您将在 Jira 中的 GitHub Copilot for Jira 应用配置页面上看到已连接的组织列表。\n\n## 在 Jira 中使用GitHub Copilot应用\n\n在你所属的Copilot组织中，必须先启用GitHub应用，然后才能开始使用它。\n\n首次在 Jira 中使用 Copilot cloud agent 时，需要将其连接到帐户 GitHub 。\n\n只有对存储库具有 **写入** 访问权限的用户才能触发 Copilot cloud agent 该存储库中的工作。\n\n可以通过多种方式触发 Copilot cloud agent ：\n\n* ```\n **将**GitHub Copilot 分配给使用“分配者”字段的工作项。\n ```\n* ```\n 在对工作项的注释中**提到**`@GitHub Copilot`。\n ```\n* **使用 Jira 自动化。** 在 Jira 自动化规则中，选择 **“使用 GitHub Copilot** ”操作并将流配置为使用基于 Jira 事件的自定义触发器，例如创建或转换工作项或应用标签时。 有关更多信息，请参阅 Atlassian 文档中的 [在 Jira 中使用 AI 代理](https://support.atlassian.com/jira-software-cloud/docs/work-with-ai-agents-in-jira/)。\n\n> \\[!NOTE]\n> 分配给 Copilot Jira 工作项时，代理从 Jira 捕获的上下文将添加到拉取请求中，如果存储库是公共的，则 **每个人都可以看到** 。\n\n### 示例：从 Jira 工作项触发Copilot cloud agent\n\n1. 在 Jira 中，打开或创建一个包含您希望委托给Copilot cloud agent的明确要求的工作项。\n\n2. 若要指定要在其中工作的存储库 Copilot ，请在工作项说明或批注中提及它。\n\n3. 将 `GitHub Copilot` 分配到工作项，或在注释中提及 `@GitHub Copilot`。 例如：\n\n ```text\n @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo\n ```\n\n4. 如果您之前未将 GitHub 应用程序连接到 Jira 中的 GitHub 帐户，请按照提示为 GitHub 和 Atlassian 授权该应用程序。\n\n5. 一旦 Copilot cloud agent 开始处理拉取请求，Jira 的聊天面板中就会显示一条评论。 启动代理会话的用户可以查看该会话的进度。\n\n6. 你可以向 Copilot 提供后续指令：\n * 使用 **“继续聊天”** 按钮（位于 **“代理”** 标题下），直接与Copilot聊天，以对\\_当前\\_拉取请求进行更新。\n * 在工作项的评论中提及 `@GitHub Copilot`，即可通过\\_新的\\_拉取请求提交更新。\n\n> \\[!TIP]\n> 如果在 1 分钟后未收到触发 Copilot cloud agent 的确认，请刷新 Jira 工作项页。\n\n### 在 Jira 中查看代理活动\n\n当 cloud agent 运行时，它会将其活动流实时显示在 Jira 的聊天面板中，因此你无需离开当前工作项，就能跟踪智能体正在执行的操作。 活动流包含指向关联代理会话 GitHub的链接。\n\n### 在会话完成后从 Jira 向 Copilot 发出指令\n\n当 Copilot cloud agent 完成一个会话后，例如在拉取请求可供评审时，你可以指示 Copilot 继续这项工作：\n\n* 在 Jira 的聊天面板中，选择指向 GitHub 上关联代理会话的链接。 这会打开代理面板 GitHub，你可以在其中查看会话并发送后续说明以更新 **现有** 拉取请求。\n* 在 Jira 工作项上添加后续 `@GitHub Copilot` 提及或评论。 这会启动一个新会话并打开 **新的** 拉取请求，而不是更新现有请求。\n\n## Copilot cloud agent在 Jira 中自定义\n\n您可以通过指定模型、代理和自定义指令，自定义 Copilot cloud agent 在 Jira 工作区中的运行方式。\n\n### 指定模型\n\n如果希望任务在特定模型上运行而不是默认值，请指定模型。 例如，对于常规且范围明确的更改，您可以选择较轻量的模型。 若要更改用于 Copilot cloud agent 特定任务的模型，请在说明 Copilot中包含模型名称，请参阅 [更改 GitHub Copilot 云代理的 AI 模型](/zh/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)。\n\n### 指定自定义代理\n\n指定自定义代理以定制 cloud agent特定工作流或存储库的行为。 可以直接在 Jira 票证中指定 GitHub 存储库中的自定义代理。 有关详细信息，请参阅“[为Copilot cloud agent创建自定义代理](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)”。\n\n### 添加自定义指令\n\n使用自定义指令设置适用于每个会话的默认选项，例如目标仓库，这样 Copilot 就不必在会话中途停下来向你询问信息。 你可以在 Jira 工作区级别定义自定义指令，以便每次 Copilot cloud agent 被触发时应用。\n\n## 使用成本\n\nCopilot cloud agent 使用 GitHub Actions 分钟额度和 AI credits。\n\n有关详细信息，请参阅“[Usage-based billing for organizations and enterprises](/zh/enterprise-cloud@latest/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises)”。\n\n## 对适用于 Jira 的 GitHub Copilot 应用添加或移除组织\n\nJira 管理员和组织 GitHub 所有者可以启用或禁用组织进行集成。\n\n> \\[!NOTE]\n> 如果在初始安装后向应用中添加了新的受 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)”。\n\n若要更改组织的 Jira 应用的访问权限 GitHub Copilot ，请执行以下操作：\n\n1. 在 Jira 中，转到工作区的设置页。\n2. 请进入GitHub Copilot应用的应用程序设置页面。\n3. （可选）单击“ **连接更多 GitHub 组织** ”，将新组织添加到列表中。\n4. 为所列的一个或多个组织启用或禁用 Copilot 应用。\n\n## 故障排除\n\n如果遇到问题，请尝试以下解决方案。\n\n### 你看不到 Copilot cloud agent ，并且无法将其分配给 Jira 工作项\n\n在 Jira 中，检查你的组织的 Atlassian 管理设置是否如下所示。\n\n1. Jira 是支持 AI 的应用，请参阅 Atlassian 文档中的 [激活应用的 AI](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products)。\n\n### 您可以看到 Copilot cloud agent，但无法将其分配给 Jira 工作项。\n\n检查你是否已将 GitHub 上的个人帐户关联到适用于 Jira 的 GitHub Copilot 应用。\n\n1. 在 Jira 中，转到个人帐户的设置页面。\n2. 在常规设置下，选择 **GitHub Copilot Jira** 应用。\n3. 如果尚未登录 GitHub，请按照提示登录并授权应用程序。\n\n### 聊天 GitHub Copilot时，系统会提示你登录\n\n要登录到适用于 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)中的上述步骤操作。\n\n### 工作区中的其他用户可以将 Copilot cloud agent 分配给 Jira 工作项，但你不能\n\n如果 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)”。\n\n若要解决此问题，请按照以下步骤为组织启动新的活动 SSO 会话：\n\n1. 转到你的[组织设置](https://github.com/settings/organizations)。GitHub\n2. 在“单一登录”下，找到需要进行身份验证的组织并单击 **“注销**”，然后 **登录**。\n * 如果你的企业为组织管理 SSO，则在企业中的一个组织登录即作为该企业所有组织的 SSO 会话。\n3. 返回到 Jira，并刷新正在使用的页面。\n4. 再次尝试在 Jira 中使用 Copilot cloud agent。\n\n### GitHub Copilot 未响应\n\n* 检查 GitHub“ [状态”页](https://githubstatus.com) 中是否有任何活动事件。\n* 检查 [Atlassian 状态页](https://status.atlassian.com) 中是否有任何活动事件。\n* 确认Copilot cloud agent是否有权访问存储库，可以通过测试是否能够将Copilot分配给GitHub上的某个问题。\n* 验证 Jira 应用程序是否有权访问 GitHub Copilot 存储库。 请参阅“[查看和修改已安装GitHub应用](/zh/enterprise-cloud@latest/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)”。\n\n## 延伸阅读\n\n* [关于 GitHub Copilot 云代理](/zh/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/about-cloud-agent)\n* [管理对 GitHub Copilot 云代理的访问权限](/zh/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/access-management)\n* [为存储库配置 MCP 服务器](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#example-atlassian)\n* 在 Atlassian 文档中[与 AI 代理协作处理工作项](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/)"}