Before you start
- GitLab is connected and granted to your vikingQA project.
- The GitLab user who connected has the Maintainer or Owner role on the GitLab project.
Set it up
1
Create the flow
Open Flows, select Create flow, then Run an AI agent on a GitLab
event.
2
Set the trigger
Under Trigger, choose:
- GitLab connection and Project
- Event type: see Events
- With the following branches as target (merge requests) or On the following branches (push, pipeline): All branches or Selected branches
- Environment: where the agent works
3
Tell the agent what to do
Under Action, fill in Instructions for the agent and save.
4
Turn it on
A new flow is off. Switch Status to Enabled.
Events
For merge requests, pick which of Opened, Re-opened and Updated
start the flow. Pipelines that run on a tag count only when All branches is
selected.
Troubleshooting
The flow doesn’t start
vikingQA adds a webhook to the GitLab project when you grant access. Check it exists in GitLab under Settings → Webhooks. If it’s missing:- Give the GitLab user who connected the role listed in Before you start.
- In vikingQA, open Project settings → MCPs, select Configure next to GitLab, then Save access. This adds the webhook again.