The GitLab Docs website is now available in Japanese!

AI Catalog

  • Tier: Premium, Ultimate
  • Add-on: GitLab Duo Core, Pro, or Enterprise
  • Offering: GitLab.com, GitLab Self-Managed
  • Status: Beta

The availability of this feature is controlled by a feature flag. For more information, see the history.

The AI Catalog is a central list of agents and flows. Add these agents and flows to your project to get started orchestrating agentic AI tasks.

Use the AI Catalog to:

  • Discover agents and flows created by the GitLab team and community members.
  • Create custom agents and flows, and share them with other users.
  • Enable agents and flows in your projects to use them across the GitLab Duo Agent Platform.

View the AI Catalog

Prerequisites:

To view the AI Catalog:

  1. On the top bar, select Search or go to > Explore.
  2. Select AI Catalog.

A list of agents is displayed. To view available flows, select the Flows tab.

Agent and flow versions

Each custom agent and flow in the AI Catalog maintains a version history. When you make changes to an item’s configuration, GitLab automatically creates a new version. Foundational agents and flows do not use versioning.

GitLab uses semantic versioning to indicate the scope of changes. For example, an agent can have a version number like 1.0.0 or 1.1.0. GitLab manages semantic versioning automatically. Updates to agents or flows always increment the minor version.

Versioning ensures that your projects and groups continue to use a stable, tested configuration of an agent or flow. This prevents unexpected changes from affecting your workflows.

Creating versions

GitLab creates a version when you:

  • Update a custom agent’s system prompt.
  • Modify an external agent or flow’s configuration.

To ensure consistent behavior, versions are immutable.

Version pinning

When you enable an AI Catalog item in a group or project, GitLab pins it to a specific version:

  • In a group, GitLab pins the latest version.
  • In a project, GitLab pins the same version as the project’s top-level group.

Version pinning means:

  • Your project or group uses a fixed version of the item.
  • Updates to the agent or flow in the AI Catalog do not affect your configuration.
  • You maintain control over when to adopt new versions.

This approach provides stability and predictability for your AI-powered workflows.

View the current version

Prerequisites:

  • You must have at least the Developer role.

To view the current version of an agent or flow:

  1. On the top bar, select Search or go to and find your project or group.
  2. On the left sidebar, select either:
    • Automate > Agents
    • Automate > Flows
  3. Select the agent or flow to view its details.

The details page displays:

  • The pinned version your project or group is using.
  • The version identifier. For example, 1.2.0.
  • Details about that specific version’s configuration.

Update to the latest version

Prerequisites:

  • You must have at least the Maintainer role.

To make your group or project use the latest version of an agent or flow:

  1. On the top bar, select Search or go to and find your project or group.
  2. On the left sidebar, select either:
    • Automate > Agents
    • Automate > Flows
  3. Select the agent or flow you want to update.
  4. Review the latest version carefully. To update, select View latest version > Update to <x.y.z>.