Help us learn about your current experience with the documentation. Take the survey.

GitLab Duo 附加组件

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

GitLab Duo 附加组件通过 AI 原生功能扩展您的 Premium 或 Ultimate 订阅。 使用 GitLab Duo 来帮助加速开发工作流程，减少重复编码任务， 并在您的项目中获得更深入的洞察。

提供三种附加组件：GitLab Duo Core、Pro 和 Enterprise。

每种附加组件都可以访问 一组 GitLab Duo 功能。

GitLab Duo Core

如果您拥有以下条件，GitLab Duo Core 将自动包含：

  • GitLab 18.0 或更高版本。
  • Premium 或 Ultimate 订阅。

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

如果您是来自 GitLab 17.11 或更早版本的现有客户，您必须 开启 IDE 功能 才能在您的 IDE 中开始使用 GitLab Duo。无需进一步操作。

被分配以下角色的用户可以访问 GitLab Duo Core：

  • Reporter
  • Developer
  • Maintainer
  • Owner

GitLab Duo Core 限制

使用限制，以及 GitLab 服务条款， 适用于 Premium 和 Ultimate 客户对包含的 Code Suggestions 和 GitLab Duo Chat 功能的使用。

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

功能 每个用户每月请求数
Code Suggestions 2,000
GitLab Duo Chat 100

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

GitLab Duo Pro 和 Enterprise

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

购买 GitLab Duo

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

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

要使用门户：

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

购买额外的 GitLab Duo 席位

您可以为您的组命名空间或 GitLab Self-Managed 实例购买额外的 GitLab Duo Pro 或 GitLab Duo Enterprise 席位。完成购买后，这些席位将添加到您订阅中的 GitLab Duo 席位总数中。

先决条件：

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

对于 GitLab.com

先决条件：

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

对于 GitLab Self-Managed 和 GitLab Dedicated

先决条件：

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

分配 GitLab Duo 席位

先决条件：

  • 您必须购买 GitLab Duo Pro 或 Enterprise 附加组件，或拥有活动的 GitLab Duo 试用。
  • 对于 GitLab Self-Managed 和 GitLab Dedicated：
    • GitLab Duo Pro 附加组件在 GitLab 16.8 及更高版本中可用。
    • GitLab Duo Enterprise 附加组件仅在 GitLab 17.3 及更高版本中可用。

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

对于 GitLab.com

先决条件：

  • 您必须拥有 Owner 角色。

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

  1. 在左侧边栏，选择 搜索或跳转至 并找到您的组。
  2. 选择 设置 > GitLab Duo。
  3. 在 席位使用情况 旁边，选择 分配席位。
  4. 在用户右侧，打开开关以分配 GitLab Duo 席位。

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

对于 GitLab Self-Managed

先决条件：

  • 您必须是管理员。
  1. 在左侧边栏底部，选择 管理员。
  2. 选择 GitLab Duo。
    • 如果 GitLab Duo 菜单项不可用，请在购买后同步您的订阅：
      1. 在左侧边栏，选择 订阅。
      2. 在 订阅详情 中，在 上次同步 右侧，选择 同步订阅（ retry ）。
  3. 在 席位使用情况 旁边，选择 分配席位。
  4. 在用户右侧，打开开关以分配 GitLab Duo 席位。

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

分配席位后， 确保为您的 GitLab Self-Managed 实例设置 GitLab Duo。

批量分配和移除 GitLab Duo 席位

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

SAML 组同步

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

对于 GitLab.com

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

对于 GitLab Self-Managed

先决条件：

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

GitLab Self-Managed 实例的管理员还可以使用 Rake 任务 来批量分配或移除席位。

使用 LDAP 配置管理 GitLab Duo 席位

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

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

当配置了 duo_add_on_groups 时，它成为 LDAP 启用用户中 Duo 席位管理的单一事实来源。 有关更多信息，请参阅 席位分配工作流程。

此自动化过程确保根据您组织的 LDAP 组结构高效分配 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 类型的数据。

对于 GitLab.com

先决条件：

  • 您必须拥有 Owner 角色。
  1. 在左侧边栏，选择 搜索或跳转至 并找到您的组。
  2. 选择 设置 > GitLab Duo。
  3. 在 席位使用情况 旁边，选择 分配席位。
  4. 从筛选栏中，选择 已分配席位 和 是。
  5. 用户列表将筛选为仅显示已分配 GitLab Duo 席位的用户。

对于 GitLab Self-Managed

先决条件：

  • 您必须是管理员。
  • 您必须拥有 GitLab 17.5 或更高版本。
  1. 在左侧边栏底部，选择 管理员。
  2. 选择 GitLab Duo。
    • 如果 GitLab Duo 菜单项不可用，请在购买后同步您的订阅：
      1. 在左侧边栏，选择 订阅。
      2. 在 订阅详情 中，在 上次同步 右侧，选择 同步订阅（ retry ）。
  3. 在 席位使用情况 旁边，选择 分配席位。
  4. 要筛选已分配 GitLab Duo 席位的用户，在 筛选用户 栏中，选择 已分配席位，然后选择 是。
  5. 用户列表将筛选为仅显示已分配 GitLab Duo 席位的用户。

自动席位移除

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

  • 席位超额
  • 被阻止、被禁止和被停用的用户

在订阅到期时

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

在 28 天宽限期结束时，席位分配将被移除，用户需要重新分配。

对于席位超额

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

例如：

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

席位移除的选择基于以下标准，按此顺序：

  1. 尚未使用 Code Suggestions 的用户，按最近分配的顺序排列。
  2. 已使用 Code Suggestions 的用户，按最近使用 Code Suggestions 的顺序排列。

对于被阻止、被禁止和被停用的用户

每天一到两次，CronJob 会检查 GitLab Duo 席位分配。如果一个被分配了 GitLab Duo 席位的用户变得 被阻止、被禁止或被停用，他们对 GitLab Duo 功能的访问权限将自动移除。

席位被移除后，它将变得可用，可以重新分配给新用户。

故障排除

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

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

  • 席位 选项卡不加载。

  • 显示以下错误消息：

    加载计费成员列表时发生错误。

作为临时解决方案，您可以使用 此代码片段 中的 GraphQL 查询为用户分配席位。