极狐 GitLab

极狐GitLab Duo 附加组件

Tier: 专业版，旗舰版

Offering: JihuLab.com，私有化部署

极狐GitLab Duo 附加组件为您的专业版或旗舰版订阅扩展了 AI 原生功能。使用极狐GitLab Duo 可帮助加速开发工作流、减少重复性编码任务，并更深入地洞察您的项目。

共有三种附加组件：极狐GitLab Duo Core、Pro 和 Enterprise。

每个附加组件都提供对一组极狐GitLab Duo 功能的访问权限。

极狐GitLab Duo Core#

如果您满足以下条件，则极狐GitLab Duo Core 会自动包含在内：

  • 极狐GitLab 18.0 或更高版本。
  • 专业版或旗舰版订阅。

如果您是极狐GitLab 17.11 或更早版本的现有客户， 则必须为极狐GitLab Duo Core 开启功能。

如果您是极狐GitLab 18.0 或更高版本的新客户，极狐GitLab Duo Core 的功能会自动开启，无需进一步操作。

要查看哪些角色可以访问极狐GitLab Duo Core，请参阅极狐GitLab Duo 群组权限。

极狐GitLab Duo 自部署版本#

如果您拥有离线许可证，则极狐GitLab Duo Core 在 极狐GitLab Duo 自部署版本上不可用，因为极狐GitLab Duo Core 需要连接到极狐GitLab AI 网关。

如果您拥有在线许可证，则可以将极狐GitLab Duo Core 与极狐GitLab Duo 自部署版本结合使用。要使用极狐GitLab Duo Core，您必须为实例的代码建议选择极狐GitLab 托管的模型。

极狐GitLab Duo Core 限制#

对于专业版和旗舰版客户，极狐GitLab Duo Core 包含对代码建议的访问权限，并且在极狐GitLab 19.0 及更高版本中还包含对极狐GitLab Duo Agentic Chat 的访问权限。

您对这些功能的访问受极狐GitLab 服务条款和用量计费的约束。

极狐GitLab 将在这些限制生效前 30 天发出通知。届时，组织管理员将拥有监控和管理消耗的工具，并能够购买额外容量。

这些限制不适用于极狐GitLab Duo Pro 或 Enterprise。

极狐GitLab Duo Core 功能访问的变更#

自 2026 年 5 月 21 日起，所有极狐GitLab 版本上的极狐GitLab Duo Core 用户将无法访问 GitLab Duo Non-Agentic Chat。

相反，极狐GitLab Duo Core 用户可以使用以下极狐GitLab Duo Agent Platform 功能来回答问题并完成非 Agentic 功能原本可以完成的任务：

  • 极狐GitLab Duo Agentic Chat。
  • 内置、自定义和外部 Agent。
  • 内置和自定义任务流。
  • 极狐GitLab Duo 代码建议。

您必须拥有极狐GitLab Credits 才能使用这些功能。

有关如何使用 Agent Platform 的更多信息，请参阅：

极狐GitLab Duo Pro 和 Enterprise#

极狐GitLab Duo Pro 和 Enterprise 要求您购买席位并将其分配给团队成员。 基于席位的模式使您能够根据团队的具体需求控制功能访问和成本管理。

极狐GitLab Duo Agent Platform Self-Hosted#

Offering: 私有化部署

拥有离线许可证的客户必须购买极狐GitLab Duo Agent Platform Self-Hosted 附加组件， 才能在 Agent Platform 中使用自部署模型。

拥有此附加组件的客户根据企业许可协议（ELA）按每位客户固定费用计费，而非基于用量或席位。该附加组件适用于实例上的所有可计费用户。

拥有在线许可证的客户无需附加组件即可在 Agent Platform 中使用自部署模型，并根据用量计费。

要购买极狐GitLab Duo Agent Platform Self-Hosted，请联系 极狐GitLab 销售团队。

购买极狐GitLab Duo#

要购买极狐GitLab Duo Enterprise，请联系 极狐GitLab 销售团队。

要购买极狐GitLab Duo Pro 的席位，请使用客户门户或联系极狐GitLab 销售团队。

要使用门户：

  1. 登录极狐GitLab 客户门户。
  2. 在订阅卡片上，选择垂直省略号 ()。
  3. 选择购买极狐GitLab Duo Pro。
  4. 输入极狐GitLab Duo 的席位数。
  5. 查看购买摘要部分。
  6. 从付款方式下拉列表中选择您的付款方式。
  7. 选择购买席位。

购买额外的极狐GitLab Duo 席位#

您可以为您的群组命名空间或极狐GitLab 私有化部署实例购买额外的极狐GitLab Duo Pro 或极狐GitLab Duo Enterprise 席位。完成购买后，这些席位将添加到您订阅中极狐GitLab Duo 席位的总数中。

先决条件：

  • 您必须购买极狐GitLab Duo Pro 或极狐GitLab Duo Enterprise 附加组件。

对于 JihuLab.com#

先决条件：

  • 您必须拥有所有者角色。
  1. 在顶部栏中，选择搜索或跳转到并找到您的群组。
  2. 在左侧边栏中，选择设置 > 极狐GitLab Duo。
  3. 在席位利用率旁边，选择分配席位。
  4. 选择购买席位。
  5. 在客户门户的添加额外席位字段中，输入席位数。该数量 不能高于与您的群组命名空间关联的订阅中的席位数。
  6. 在账单信息部分，从下拉列表中选择付款方式。
  7. 选中隐私政策和服务条款复选框。
  8. 选择购买席位。
  9. 选择极狐GitLab SaaS 选项卡并刷新页面。

对于极狐GitLab 私有化部署#

先决条件：

  • 您必须是管理员。
  1. 登录极狐GitLab 客户门户。
  2. 在订阅卡片的极狐GitLab Duo Pro 部分，选择添加席位。
  3. 输入席位数。该数量不能高于订阅中的席位数。
  4. 查看购买摘要部分。
  5. 从付款方式下拉列表中选择您的付款方式。
  6. 选择购买席位。

分配极狐GitLab Duo 席位#

先决条件：

  • 您必须购买极狐GitLab Duo Pro 或 Enterprise 附加组件，或拥有有效的极狐GitLab Duo 试用版。
  • 对于极狐GitLab 私有化部署：
    • 极狐GitLab Duo Pro 附加组件可用。
    • 极狐GitLab Duo Enterprise 附加组件仅在极狐GitLab 17.3 及更高版本中可用。

购买极狐GitLab Duo Pro 或 Enterprise 后，您可以将席位分配给用户，以授予对附加组件的访问权限。

对于 JihuLab.com#

先决条件：

  • 您必须拥有所有者角色。
  • 用户必须至少拥有访客角色。

要在任何项目或群组中使用极狐GitLab Duo 功能，您必须将用户分配到至少一个顶级群组中的席位。

  1. 在顶部栏中，选择搜索或跳转到并找到您的群组。
  2. 在左侧边栏中，选择设置 > 极狐GitLab Duo。
  3. 在席位利用率旁边，选择分配席位。
  4. 在用户右侧，打开开关以分配极狐GitLab Duo 席位。

用户将收到一封确认电子邮件。

对于极狐GitLab 私有化部署#

先决条件：

  • 您必须是管理员。
  • 用户不得被屏蔽、封禁或停用。
  1. 在右上角，选择管理员。
  2. 在左侧边栏中，选择极狐GitLab Duo。
    • 如果极狐GitLab Duo 菜单项不可用，请在购买后同步您的订阅：
      1. 在左侧边栏中，选择订阅。
      2. 在订阅详情中，在上次同步右侧，选择 同步订阅 ()。
  3. 在席位利用率旁边，选择分配席位。
  4. 在用户右侧，打开开关以分配极狐GitLab Duo 席位。

用户将收到一封确认电子邮件。

  • 要禁用此电子邮件，请将 sm_duo_seat_assignment_email 功能标志设置为 false。 此标志默认启用。

分配席位后，请确保已为您的极狐GitLab 私有化部署实例设置极狐GitLab Duo。

批量分配和移除极狐GitLab Duo 席位#

您可以为多个用户批量分配或移除席位。

SAML 群组同步#

JihuLab.com 群组可以使用 SAML 群组同步来管理极狐GitLab Duo 席位分配。

对于 JihuLab.com#

  1. 在顶部栏中，选择搜索或跳转到并找到您的群组。
  2. 在左侧边栏中，选择设置 > 极狐GitLab Duo。
  3. 在右下角，您可以调整页面显示以显示 50 或 100 个条目，以增加可供选择的用户数量。
  4. 选择要分配或移除席位的用户：
    • 要选择多个用户，请在每个用户左侧选中复选框。
    • 要全选，请选中表格顶部的复选框。
  5. 分配或移除席位：
    • 要分配席位，请选择分配席位，然后选择分配席位进行确认。
    • 要从席位中移除用户，请选择移除席位，然后选择移除席位进行确认。

对于极狐GitLab 私有化部署#

先决条件：

  • 您必须是管理员。
  • 您必须拥有极狐GitLab 17.5 或更高版本。
  1. 在右上角，选择管理员。
  2. 在左侧边栏中，选择极狐GitLab Duo。
  3. 在右下角，您可以调整页面显示以显示 50 或 100 个条目，以增加可供选择的用户数量。
  4. 选择要分配或移除席位的用户：
    • 要选择多个用户，请在每个用户左侧选中复选框。
    • 要全选，请选中表格顶部的复选框。
  5. 分配或移除席位：
    • 要分配席位，请选择分配席位，然后选择分配席位进行确认。
    • 要从席位中移除用户，请选择移除席位，然后选择移除席位进行确认。
  6. 在用户右侧，打开开关以分配极狐GitLab Duo 席位。

极狐GitLab 私有化部署实例的管理员还可以使用 Rake 任务来批量分配或移除席位。

使用 LDAP 配置管理极狐GitLab Duo 席位#

您可以根据 LDAP 群组成员身份，为启用了 LDAP 的用户自动分配和移除极狐GitLab Duo 席位。

要启用此功能，您必须在 LDAP 设置中配置 duo_add_on_groups 属性。

配置 duo_add_on_groups 后，它将成为启用了 LDAP 的用户之间极狐GitLab Duo 席位管理的唯一事实来源。有关更多信息，请参阅席位分配工作流。

此自动化流程可确保根据您组织的 LDAP 群组结构高效分配极狐GitLab Duo 席位。有关更多信息，请参阅使用 LDAP 管理极狐GitLab Duo 附加组件席位。

查看已分配的极狐GitLab Duo 用户#

先决条件：

  • 您必须购买极狐GitLab Duo Pro 或 Enterprise 附加组件，或拥有有效的极狐GitLab Duo 试用版。

购买极狐GitLab Duo Pro 或 Enterprise 后，您可以将席位分配给用户，以 授予对附加组件的访问权限。然后，您可以查看已分配的极狐GitLab Duo 用户的详细信息。

极狐GitLab Duo 席位利用率页面为每个用户显示以下信息：

  • 用户的全名和用户名
  • 席位分配状态
  • 公开电子邮件地址：用户在其公开个人资料上显示的电子邮件。
  • 最近极狐GitLab 活动：用户上次在极狐GitLab 中执行任何操作的日期。
  • 最近极狐GitLab Duo 活动：用户上次使用极狐GitLab Duo 功能的日期。在任何极狐GitLab Duo 活动时刷新。

这些字段使用 GraphQL API中 AddOnUser 类型的数据。

对于 JihuLab.com#

先决条件：

  • 您必须拥有所有者角色。
  1. 在顶部栏中，选择搜索或跳转到并找到您的群组。
  2. 在左侧边栏中，选择设置 > 极狐GitLab Duo。
  3. 在席位利用率旁边，选择分配席位。
  4. 在筛选栏中，选择已分配席位和是。
  5. 用户列表将仅筛选出已分配极狐GitLab Duo 席位的用户。

对于极狐GitLab 私有化部署#

先决条件：

  • 您必须是管理员。
  • 您必须拥有极狐GitLab 17.5 或更高版本。
  1. 在右上角，选择管理员。
  2. 在左侧边栏中，选择极狐GitLab Duo。
    • 如果极狐GitLab Duo 菜单项不可用，请在购买后同步您的订阅：
      1. 在左侧边栏中，选择订阅。
      2. 在订阅详情中，在上次同步右侧，选择 同步订阅 ()。
  3. 在席位利用率旁边，选择分配席位。
  4. 要按已分配极狐GitLab Duo 席位的用户进行筛选，请在筛选用户栏中选择已分配席位，然后选择是。
  5. 用户列表将仅筛选出已分配极狐GitLab Duo 席位的用户。

自动移除席位#

极狐GitLab Duo 附加组件席位会自动移除，以确保只有符合条件的用户才能访问。这发生在以下情况：

  • 席位超额
  • 被屏蔽、封禁和停用的用户

订阅到期时#

如果包含极狐GitLab Duo 附加组件的订阅到期，席位分配将保留 28 天。如果在此 28 天窗口期内续订了订阅，或购买了包含极狐GitLab Duo 的新订阅，用户将被自动重新分配。否则，席位分配将被移除，用户必须重新分配。

席位超额时#

如果您购买的极狐GitLab Duo 附加组件席位数量减少，席位分配将自动移除以匹配订阅中可用的席位数量。

例如：

  • 您拥有一个 50 席位的极狐GitLab Duo Pro 订阅，所有席位均已分配。
  • 您续订了 30 个席位的订阅。超出订阅的 20 个用户将自动从极狐GitLab Duo Pro 席位分配中移除。
  • 如果在续订前只有 20 个用户被分配了极狐GitLab Duo Pro 席位，则不会移除任何席位。

席位将根据以下标准按顺序选择移除：

  1. 尚未使用代码建议的用户，按最近分配时间排序。
  2. 已使用代码建议的用户，按最近一次使用代码建议的时间由早到晚排序（最久未使用者优先移除）。

用户被屏蔽、封禁和停用时#

CronJob 每天一到两次审查极狐GitLab Duo 席位分配。如果已分配极狐GitLab Duo 席位的用户被屏蔽、封禁或停用，其对极狐GitLab Duo 功能的访问权限将被自动移除。

席位被移除后，将变为可用状态，并可重新分配给新用户。

故障排除#

无法使用 UI 为您的用户分配席位#

在用量配额页面上，如果您同时遇到以下两种情况，将无法使用 UI 为您的用户分配席位：

  • 席位选项卡无法加载。

  • 显示以下错误消息：

    plaintext
    An error occurred while loading billable members list.

作为变通方法，您可以使用此代码片段中的 GraphQL 查询来为用户分配席位。