Skip to main content

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
Select Save.
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:
  1. Give the GitLab user who connected the role listed in Before you start.
  2. In vikingQA, open Project settings → MCPs, select Configure next to GitLab, then Save access. This adds the webhook again.