Use GitLab Orbit with GitLab Duo Agent Platform

GitLab Orbit is integrated into GitLab Duo Agent Platform. Agents call GitLab Orbit’s command tools (list_commands, invoke_command) automatically, running commands such as get_graph_schema and query_graph, when a question is best answered by traversing your SDLC graph - cross-project dependencies, blast radius, pipeline inheritance, vulnerability lineage, contributor patterns. When GitLab Orbit doesn’t have the answer, the agent falls back to its existing tools.

Prerequisites

• GitLab Orbit is enabled on your group.
• You have access to GitLab Duo Agent Platform.

Where GitLab Orbit is available

GitLab Orbit is wired into the following GitLab Duo Agent Platform agents and flows:

When an agent uses GitLab Orbit to answer a question, the answer is grounded in your live graph rather than the agent’s general knowledge.

Turn on GitLab Orbit for custom flows

To turn on GitLab Orbit for custom flows:

1. In the upper-right corner, select your avatar.
2. Select Preferences.
3. Under Orbit in GitLab Duo, select the Use Orbit in GitLab Duo and Other Foundational Agents checkboxes.
4. Select Save changes.

Use GitLab Orbit in a custom flow

To use GitLab Orbit in a custom flow, you must add the GitLab Orbit tools to the flow configuration. After you add the tools, you can write prompts that tell the agent to use GitLab Orbit.

Prerequisites:

• The Maintainer or Owner role for the project that manages the flow.
• Each user who triggers the flow must turn on GitLab Orbit for custom flows.

To use GitLab Orbit in a custom flow:

1. In the top bar, select Search or go to and find your group or project.

2. Select AI > Flows.

3. Select the flow you want to edit.

4. In the upper-right corner, select Edit.

5. Add the GitLab Orbit tools to the toolset of each agent component that needs them:

   yaml

   toolset:
     - orbit_list_commands
     - orbit_invoke_command

6. In the prompt, tell the agent when to use GitLab Orbit. For example, to find other projects that import the changed files.

7. Select Save changes.

To edit the flow in VS Code, see Edit a flow.

Billing

During the beta, queries that GitLab Duo Agent Platform makes against GitLab Orbit on your behalf do not consume GitLab Credits.

When GitLab Orbit is generally available, these queries consume GitLab Credits. Credit rates are published in GitLab Credits and usage billing before charging begins.

Example prompts

Ask these in any of the surfaces above - the agent picks the right tool.

Codebase exploration:

• “What are the 10 most recently updated projects in my group?”
• “Which projects have the most open merge requests?”
• “Who are the top contributors to this project by merge requests merged?”

Blast radius and impact:

• “Which projects import the payments-service library?”
• “What files in this project depend on UserAuthService?”
• “If I deprecate this function, which other files reference it?”

CI/CD and pipeline health:

• “Which projects have the highest pipeline failure rate?”
• “What are the most common job failure reasons in this group?”
• “Which pipelines take the longest to run?”

Security:

• “Show me all critical and high severity open vulnerabilities in this group.”
• “Which projects have unresolved vulnerabilities introduced in the last 30 days?”
• “What CVEs are present across my projects?”

Planning and work items:

• “How many open issues are assigned to each user in this group?”
• “Which milestones are overdue?”
• “What work items are blocking this epic?”

Limitations

• GitLab Orbit only answers about groups where it is enabled and that you have access to.
• Complex multi-step questions may need a follow-up to narrow scope.
• Code content (file text, function bodies) is available but may not be returned by default for large results. Ask explicitly: “Show me the source of this function.”
• Code Review Flow does not use GitLab Orbit. To use GitLab Orbit in code review, use a custom flow.