AI 目录

模型信息

• 关于 Agent 和任务流使用的模型，请参见 Agent Platform AI 模型。

AI 目录是 Agent 和任务流的中央列表。将这些 Agent 和任务流添加到您的项目，即可开始编排 Agentic AI 任务。

使用 AI 目录可以：

• 发现由 GitLab 团队和社区成员创建的 Agent 和任务流。
• 创建自定义 Agent 和任务流，并与其他用户共享。
• 在您的项目中启用 Agent 和任务流，以便在整个极狐GitLab Duo Agent Platform 中使用它们。

查看 AI 目录#

先决条件：

• 满足极狐GitLab Duo Agent Platform 先决条件。
• 已开启 Agent Platform。
• 在极狐GitLab 私有化部署上，已为实例开启极狐GitLab Duo。
• 要从 AI 目录启用 Agent 和任务流：
  • 在群组中，您必须具有维护者或所有者角色。
  • 在项目中，您必须具有维护者或所有者角色。

要查看 AI 目录，您可以：

• 使用顶部栏：
  1. 在顶部栏中，选择搜索或跳转到 > 探索。
  2. 选择 AI 目录。
• 使用极狐GitLab Duo 侧边栏：
  1. 在顶部栏中，选择搜索或跳转到并找到您的项目。
  2. 在极狐GitLab Duo 侧边栏中，选择 极狐GitLab Duo AI 目录（）。

此时会显示 Agent 列表。

在极狐GitLab 私有化部署上，以下 Agent 不会显示在 AI 目录中：

• 在 JihuLab.com 上创建的自定义 Agent。
• 尚未添加到实例的极狐GitLab 管理的外部 Agent。

要查看可用的任务流，请选择Flows选项卡。

要确定某个条目由哪个项目管理，请选择该条目并查看 管理方 字段。

条目定义的位置#

条目定义存储在 AI 目录中，而不是代码仓库中。您创建的每个条目都有一个管理它的项目，该项目在您创建条目时选择。创建条目后，您无法更改该项目。

管理项目中具有维护者或所有者角色的成员可以编辑该条目。管理项目还决定谁可以查看私有或受限条目。单个项目可以管理多个条目。 极狐GitLab 提供的条目（例如内置 Agent 和极狐GitLab 管理的外部 Agent） 没有管理项目。

要更改条目，请在 AI 目录中编辑它。您不需要提交或合并请求。有关更多信息，请参见编辑 Agent 或编辑任务流。

当您保存对条目配置的更改时，版本固定会决定哪些项目和群组使用新版本：

• 未固定版本的项目（例如管理项目）会立即使用新版本。
• 固定到较早版本的项目和群组会继续使用该版本，直到您更新固定版本。

对条目名称、描述或可见性的更改会直接应用于该条目，不会创建版本。有关更多信息，请参见版本固定。

使用合并请求更新定义#

您可以将 Agent 和任务流定义存储在代码仓库中，并在合并请求中审查对它们的更改。 AI 目录 CI/CD 组件 会将 agents/ 和 flows/ 目录中的定义发布到 AI 目录。您可以配置这两个目录名称。该组件在标签流水线中运行。要添加该组件并更改目录名称，请参见组件 README 中的快速开始和输入参数。

要更新条目定义，请完成以下步骤：

1. 打开一个合并请求，其中包含您对定义文件的更改。
2. 在合并请求合并后，从默认分支创建标签。该标签流水线会将更改发布到 AI 目录。

创建标签时，该组件会为每个条目完成以下操作：

1. 对定义文件进行哈希计算，并将其与上次同步时 .ai-catalog-mapping.json中的哈希值进行比较。
2. 如果文件未更改，则跳过该条目。
3. 如果文件已更改，则覆盖 AI 目录中该条目的名称、描述和可见性，并在定义不同时添加新版本。

该组件比较的是代码仓库文件，而不是 AI 目录，因此它不会检测在 AI 目录编辑器中进行的编辑。这些编辑会一直保留，直到代码仓库文件发生更改。下一次发布时会覆盖它们。

Agent 和任务流版本#

AI 目录中的每个自定义 Agent 和任务流都维护版本历史记录。当您更改条目配置时，极狐GitLab 会自动创建新版本。内置 Agent 和任务流不使用版本控制。

极狐GitLab 使用语义化版本控制来表示更改的范围。例如，Agent 的版本号可能类似于 1.0.0 或 1.1.0。极狐GitLab 会自动管理语义化版本控制。对 Agent 或任务流的更新始终递增次版本号。

版本控制可确保您的项目和群组继续使用稳定、经过测试的 Agent 或任务流配置。这可以防止意外更改影响您的工作流。

创建版本#

极狐GitLab 会在您执行以下操作时创建版本：

• 更新自定义 Agent 的系统提示。
• 修改外部 Agent 或任务流的配置。

为确保行为一致，版本是不可变的。

版本固定#

当您启用 AI 目录条目时：

• 在群组中，极狐GitLab 会固定最新版本。
• 在不管理该条目的项目中，极狐GitLab 会固定与该项目的顶级群组相同的版本。

版本固定意味着：

• 您的项目或群组使用该条目的固定版本。
• AI 目录中对 Agent 或任务流的更新不会影响您的配置。
• 您可以控制何时采用新版本。

这种方法可为您的 AI 驱动工作流提供稳定性和可预测性。

当您在管理该条目的项目中启用 AI 目录条目时，极狐GitLab 不会固定版本。相反，该项目始终使用该条目的最新版本。

如果您在极狐GitLab 18.10 之前已在管理该 Agent 或任务流的项目中启用它，您的配置会保持在固定的版本。

在您首次更新到最新版本后，极狐GitLab 会从那时起自动使用最新版本。

查看当前版本#

先决条件：

• 您必须具有开发者、维护者或所有者角色。

要查看 Agent 或任务流的当前版本：

1. 在顶部栏中，选择搜索或跳转到并找到您的项目或群组。
2. 在左侧边栏中，选择以下任一项：
   • AI > Agent
   • AI > Flows
3. 选择该 Agent 或任务流以查看其详细信息。

详细信息页面会显示：

• 您的项目或群组正在使用的固定版本。
• 版本标识符。例如，1.2.0。
• 该特定版本配置的详细信息。

更新到最新版本#

先决条件：

• 您必须具有维护者或所有者角色。

要让您的群组或项目使用 Agent 或任务流的最新版本：

1. 在顶部栏中，选择搜索或跳转到并找到您的项目或群组。
2. 在左侧边栏中，选择以下任一项：
   • AI > Agent
   • AI > Flows
3. 选择您要更新的 Agent 或任务流。
4. 仔细查看最新版本。要更新，请选择 查看最新版本 > 更新到 <x.y.z>。

配置大小限制#

AI 目录条目的配置不能超过最大大小：

任务流和外部 Agent 的限制更低。极狐GitLab 会同时存储您输入的 YAML 和极狐GitLab 由此生成的结构化配置。两者合计约为 YAML 大小的两倍。

如果您的配置超过限制，极狐GitLab 会显示错误并且不会保存该条目。要解决该错误，请减小配置的大小。

条目可见性#

当您创建 Agent 或任务流时，您需要选择一个项目来管理它，并选择该条目是公开、私有还是受限。可见性控制谁可以查看、启用和运行该条目。这些规则适用于自定义 Agent、外部 Agent 和任务流。

公开条目#

• 任何人都可以查看，并且可以在任何满足先决条件的项目中开启。

私有条目#

• 只有管理项目中具有访客、计划者、报告者、 开发者、维护者或所有者角色的成员可以查看。
• 除管理项目外，不能在其他项目中开启。

如果某个公开或受限条目已被管理项目以外的项目开启，您无法将其设为私有。

受限条目#

• 管理项目所属顶级群组中任何项目的成员都可以查看和使用。
• 可以在同一顶级群组中的其他项目中开启。
• 不能在该顶级群组之外查看或开启。
• 不能在探索中的 AI 目录中查看。
• 不能从探索中的 AI 目录创建。

如果某个公开条目已被该顶级群组以外的项目开启，您无法将其设为受限。

受限条目与共享项目或群组#

极狐GitLab 允许您将项目或群组共享到另一个项目或群组中。围绕启用的受限可见性规则只考虑管理项目的实际顶级群组。它不考虑共享项目或群组关系。

通过共享获得项目或群组访问权限的协作者，只有在共享容器内工作时才能查看、启用和运行受限条目。共享不会将受限访问权限扩展到协作者自己的顶级群组。

将 AI 目录限制在群组层级内#

在顶级群组中，您可以限制 AI 目录，使该群组层级中项目的用户只能查看、启用和运行：

• 由极狐GitLab 维护的内置 Agent 和任务流。
• 由同一顶级群组层级中项目拥有的公开 Agent 和任务流。
• 由该项目自身拥有的私有 Agent 和任务流。

由该层级之外的项目拥有的 Agent 和任务流：

• 会从 AI 目录中隐藏。
• 会被阻止启用。
• 会被阻止运行，即使某个项目之前已启用它们。

您只能在顶级群组上配置此设置。它适用于该层级中的所有项目。对此设置的更改会记录在审计日志中。

先决条件：

• 您必须具有该顶级群组的所有者角色。

要将 AI 目录限制在您的群组层级内：

1. 在顶部栏中，选择搜索或跳转到并找到您的顶级群组。
2. 选择设置 > 极狐GitLab Duo。
3. 选择 更改配置。
4. 在 数据和隐私 部分中，在 AI 目录下，选中 将 AI 目录限制在此群组内 复选框。
5. 选择 保存更改。

删除条目#

当您删除 Agent 或任务流时，极狐GitLab 会将其从实例中移除。如果管理项目以外的项目已开启该条目，极狐GitLab 会改为隐藏该条目。该条目不再列在 AI 目录中，并且任何项目都无法启用它。有关步骤，请参见删除 Agent 和删除任务流。