Foundational agents

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

Foundational agents are specialized AI assistants that extend the capabilities of GitLab Duo Chat with domain-specific expertise and context awareness.

Unlike the general-purpose GitLab Duo agent, foundational agents understand the unique workflows, frameworks, and best practices of their specialized domains. Each agent combines deep knowledge of GitLab features with role-specific reasoning to provide targeted help that aligns with how practitioners actually work.

When you interact with a foundational agent, you’re engaging with an AI tool that understands not just what you’re asking, but the broader context of your role and objectives. For example:

  • A product planning agent that understands prioritization frameworks and dependency management.
  • A security agent that recognizes vulnerability patterns and compliance requirements.

These agents integrate into your existing GitLab workflows through Chat, and can help provide specialized support without requiring you to leave your current context.

GitLab provides foundational agents for workflows where specialized knowledge significantly improves outcome quality. Each agent maintains awareness of GitLab-specific implementations, organizational standards, and industry best practices in its domain. This specialization helps enable more accurate, actionable, and contextually appropriate responses compared to general-purpose AI help.

Available foundational agents

The following foundational agents are available:

Turn foundational agents on or off

By default, foundational agents are turned on. You can turn them on or off for a top-level group (namespace) or for an instance.

If you turn foundational agents off, you can still use the default GitLab Duo agent.

Prerequisites:

  • You must have the Owner role for the group.
  1. On the left sidebar, select Search or go to and find your group. If you’ve turned on the new navigation, this field is on the top bar.
  2. Select Settings > GitLab Duo.
  3. Select Change configuration.
  4. Under Foundational agents, select either:
    • On by default
    • Off by default
  5. Select Save changes.

If you turn off foundational agents for a top-level group, users with that group as their default GitLab Duo namespace can’t access foundational agents in any namespace.

Prerequisites:

  • You must be an administrator.
  1. On the left sidebar, at the bottom, select Admin. If you’ve turned on the new navigation, in the upper-right corner, select Admin.
  2. Select GitLab Duo.
  3. Select Change configuration.
  4. Under Foundational agents, select either:
    • On by default
    • Off by default
  5. Select Save changes.