Agentic breaking change resolution flow
- Tier: Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
The agentic breaking change resolution flow automatically analyzes pipeline failures on dependency bump merge requests and generates code fixes to resolve breaking changes introduced by the dependency update.
When a dependency bump merge request has a failed pipeline, GitLab Duo analyzes the failure and attempts to generate fixes. The flow examines:
- Pipeline error logs to identify the root cause of the failure.
- Dependency changelogs and release notes to identify breaking changes.
- Code usage patterns of the updated dependency to determine what needs to change.
After generating fixes, the flow commits them directly to the dependency bump merge request branch and re-runs the pipeline.
Results are based on AI analysis and should be reviewed before merging.
Prerequisites
- Meet the prerequisites for the GitLab Duo Agent Platform.
- Turn on Allow foundational flows and Resolve Dependency Bump Breaking Changes for the top-level group.
- Configure push rules to allow a service account.
- Configure your own runners or turn on GitLab hosted runners for your project.
- Turn on the feature for the project. See Enable agentic breaking change resolution.
Run agentic breaking change resolution
The flow runs automatically when a pipeline fails on a dependency bump merge request created by the auto-remediation agent, and the feature is enabled for the project.
You can also trigger the flow manually:
- In the top bar, select Search or go to and find your project.
- In the left sidebar, select Code > Merge requests.
- Select the dependency bump merge request with a failed pipeline.
- In the pipeline widget, select Resolve breaking changes with Duo.
The flow runs in the background. When complete, it commits any generated fixes to the MR branch and re-runs the pipeline.