极狐 GitLab

GitLab Duo 模型选择

Tier: 专业版,旗舰版

附加组件: GitLab Duo Core、Pro 或 Enterprise

Offering: JihuLab.com

版本历史
  • 在极狐GitLab 18.4 中为 GA。

每个 GitLab Duo 功能都有一个由极狐GitLab 预先选择的默认大语言模型(LLM)。极狐GitLab 可以更新该默认 LLM 以优化功能性能。因此,在无需你执行任何操作的情况下,某个功能的 LLM 可能会发生变化。如果你不想使用每个功能的默认 LLM,或者有特定需求,你可以从其他可用且受支持的 LLM 列表中进行选择。如果你为某个功能选择了特定的 LLM,则该功能会一直使用该 LLM,直到你选择其他模型为止。

为功能选择 LLM#

在 JihuLab.com 上#

版本历史
  • 在极狐GitLab 18.1 中为顶级群组引入,功能标志名为 ai_model_switching。默认禁用。
  • 在极狐GitLab 18.4 中更改为 Beta。
  • 在极狐GitLab 18.4 中默认启用。
  • 在极狐GitLab 18.4 中为 GitLab Duo Agent 平台引入模型选择,功能标志名为 duo_agent_platform_model_selection。默认禁用。
该功能的可用性由功能标志控制。更多信息请参阅历史。

在 JihuLab.com 上,你可以在顶级群组中为某个功能选择模型。你所选择的模型会应用于该功能的所有子群组和项目。

前提条件:

  • 你想为其选择 LLM 的群组必须:
    • 是 JihuLab.com 上的顶级群组或命名空间。
    • 已启用 GitLab Duo Core、Pro 或 Enterprise。
  • 你必须在该群组或命名空间中具有所有者角色。
  • 在极狐GitLab 18.3 或更高版本中,如果你隶属于多个 GitLab Duo 命名空间,则必须分配一个默认命名空间

选择不同的功能所用 LLM:

  1. 在左侧边栏选择 搜索或跳转到 并找到你的群组。
  2. 选择 设置 > GitLab Duo。如果未显示 GitLab Duo,请确保已为该群组启用 GitLab Duo Core、Pro 或 Enterprise。
  3. 选择 配置功能
  4. 在你想配置的功能中,从下拉列表中选择一个 LLM。

在顶级群组级别选择模型的 极狐GitLab UI。

- GitLab Duo Agentic Chat 的模型选择与 GitLab Duo Chat(经典版)相互独立。你必须分别配置每个功能——对其中一个的更改不会影响另一个。 - 在 Agentic Chat 中使用的 国内 SOTA 大模型 当前为试验性支持。请在此[议题](https://jihulab.com/gitlab-cn/gitlab/-/issues/572864)中留下你对在 Agentic Chat 中使用 国内 SOTA 大模型 的反馈。

分配默认 GitLab Duo 命名空间#

版本历史
  • 在极狐GitLab 18.3 中引入,功能标志名为 ai_user_default_duo_namespace。默认禁用。
  • 在极狐GitLab 18.4 中默认启用。
该功能的可用性由功能标志控制。更多信息请参阅历史。

如果你隶属于多个 GitLab Duo 命名空间,则必须选择其中一个作为默认命名空间。必须这样做的原因是,GitLab Duo 可能无法自动检测你当前的工作命名空间,从而无法识别你希望使用的 LLM。例如,当你:使用 GitLab Duo 的 CLI;或新项目尚未使用 Git 初始化,因此 IDE 无法识别关联的命名空间。如果出现这种情况,GitLab Duo 会使用你在默认命名空间中选择的 LLM。

选择默认命名空间:

  1. 在 JihuLab.com 上,在左侧边栏选择你的头像。
  2. 选择 首选项
  3. 进入 行为 部分。
  4. 默认 GitLab Duo 命名空间 下拉列表中,选择要设置为默认的命名空间。
  5. 选择 保存更改

故障排查#

在选择非默认模型时,你可能会遇到以下问题。

LLM 不可用#

如果你在 GitLab Duo 的 AI 原生功能中使用极狐GitLab 默认 LLM,极狐GitLab 可能会在未通知用户的情况下更改默认 LLM,以维持最佳性能和可靠性。如果你为 GitLab Duo 的 AI 原生功能选择了特定 LLM,而该 LLM 不可用,则不会自动回退,使用该 LLM 的功能将不可用。

未设置默认 GitLab Duo 命名空间#

当你在使用已选择 LLM 的 GitLab Duo 功能时,可能会收到一条错误提示,指出你尚未选择默认 GitLab Duo 命名空间。例如:在 GitLab Duo 代码建议中,你可能会收到 错误 422:未找到默认 GitLab Duo 群组。请在你的用户首选项中选择一个默认 GitLab Duo 群组,然后重试。;在 GitLab Duo Chat 中,你可能会收到 错误 G3002:抱歉,你尚未选择默认 GitLab Duo 命名空间。请在你的用户首选项中选择默认 GitLab Duo 命名空间。。出现该问题的原因是:启用了 ai_user_default_duo_namespace 功能标志;你隶属于多个 GitLab Duo 命名空间,但尚未选择其中一个作为默认命名空间。为解决该问题,你可以执行以下任一操作: 分配默认 GitLab Duo 命名空间;或者在模型选择功能处于测试阶段期间,联系极狐GitLab支持以禁用 ai_user_default_duo_namespace 功能标志。