【GitLab 19.2】無料ユーザーでも使える！GitLab Duo custom flows が正式リリース(GA)されたので使い倒そう

はじめに

2026年7月16日にリリースされた GitLab 19.2 で、GitLab Duo の custom flows(カスタムフロー) が正式に GA(General Availability、一般提供開始)になりました。

「AIによる自動化って結局 Premium や Ultimate プランじゃないと使えないんでしょ?」と思われがちですが、custom flows は Free / Premium / Ultimate すべてのプランで利用可能 です。GitLab.com、GitLab Self-Managed、GitLab Dedicated のいずれの提供形態でも使えます。

この記事では、custom flows が具体的に何をしてくれる機能なのか、そしてどうやって作成・有効化するのかを、GitLab を使い始めたばかりの方にもわかりやすく整理してみます。無料ユーザーの方にこそ、ぜひ触ってみてほしい機能です。

custom flows とは何か

custom flows は、自分のGitLabプロジェクトをまたいで複雑な複数ステップの作業を自動化するために、自分で作成・設定できるAI駆動のワークフローです。

これまでもGitLab Duoにはあらかじめ用意された「基盤フロー(foundational flows)」がありましたが、custom flowsは自分たちのチーム独自の作業手順をYAMLで定義できる点が大きな特徴です。ワークフローのステップ、コンポーネント、そしてどんなイベントで起動するかというトリガーを自分たちで設計できるので、GitLab上で発生する繰り返しの多い開発・運用作業を、決まった手順で自動的に走らせることができます。

GitLabのUI上では、CI/CDのパイプラインとしてフローが実行されるため、GitLabの画面を離れることなく定型作業を自動化できるのもポイントです。

主な特徴は次の通りです。

チーム独自の自動化を、再利用可能なYAMLとして定義できる
複数のAIエージェントが連携して複雑な複数ステップのタスクをこなす、マルチエージェントのオーケストレーションに対応
承認やフィードバックが必要な工程では、人が介在するチェックポイント(Human-in-the-loop)を自分で設定できる
メンション、アサイン、パイプラインイベント、マージリクエストのライフサイクルイベントなど、GitLabのネイティブなイベントをトリガーにできる
プロジェクトからでも、AI Catalog(AIカタログ)からでもフローの作成・管理ができる
公開(Public)・非公開(Private)の可視性を設定できる
サービスアカウントとコンポジットアイデンティティを使った安全な実行が可能
実行前にYAMLの設定ミスを検知するバリデーション機能がある

なぜ無料ユーザーが注目すべきなのか

custom flows のプラン対応は Free、Premium、Ultimate となっています。つまり、有料プランに加入していなくても、GitLab.com上で custom flows という機能自体は利用できます。

ただし注意が必要なのは、custom flowsの実行には GitLab Credits が消費されるという点です。GitLab CreditsはGitLabのAI機能の利用量に応じて消費される、いわば従量課金のクレジットであり、それ自体は有料の仕組みです。つまり「機能のプラン制限はFreeでも解放されているが、実際にフローを動かすたびに課金対象のクレジットが消費される」という位置づけになります。無料プランだからといって、フローの実行自体が無制限・無料で使い放題になるわけではないので、その点は誤解のないようにしておきましょう。

とはいえ、有料プランへのアップグレードなしにこの機能自体へアクセスできることは、個人開発者や小規模チームにとって大きなメリットです。まずは小さな自動化を試してみて、消費されるクレジット量や効果を確認しながら、本格導入を検討するという進め方がしやすくなっています。

フローを作ってみる(大まかな流れ)

custom flowsを使い始めるには、前提として GitLab Duo Agent Platform の利用条件を満たしていること、そしてcustom flows自体が有効になっていることが必要です(デフォルトではオンになっています)。

作成方法は大きく分けて2つあります。

プロジェクトから作成する
AI Catalog から作成する

どちらの方法でも、次のような流れで作成します。

対象のプロジェクトを開く、またはAI Catalogを開く
「Flows」または「New flow」を選択する
表示名と説明を入力する
可視性を「Private」か「Public」で選ぶ
YAML形式でフローの設定を記述する
「Create flow」を選択して作成する

作成したフローは AI Catalog に表示されます。

フローを有効化して使う

作成したフローは、そのままでは動きません。プロジェクトで「有効化」してはじめて、issueやマージリクエスト、ディスカッションからトリガーできるようになります。

有効化する際には、どのイベントでフローを起動するかという「トリガー」も一緒に設定します。プロジェクトで有効化すると、そのプロジェクトが属するトップレベルグループでも同時に有効化される点は覚えておくとよいでしょう。

実際にフローを使うときは、issueやマージリクエスト、エピック上で、そのフロー用のサービスアカウントユーザーをメンションしたり、アサインしたり、レビュー依頼したりするだけです。例えば「Security scanner」という名前のフローを「GitLab Duo」というグループで有効化した場合、サービスアカウントのユーザー名は ai-security-scanner-gitlab-duo のようになります。フローの処理が終わると、完了の通知とともに、マージ可能な変更やインラインコメントが返ってきます。

なお、このサービスアカウントは、実行したユーザー自身がアクセスできるプロジェクトかつフローが追加されているプロジェクトにしかアクセスできない仕組みになっているので、権限面でも安心して使えます。

複製・編集・非表示・削除もできる

一度作ったフローで満足せず、育てていけるのもcustom flowsの良いところです。

既存のフローをそのまま複製して、別バージョンとして調整できる
設定を後から編集できる
AI Catalogから一時的に見えなくする「Hide」ができる(すでに有効化されている場所では引き続き動作します)
管理者権限があれば、インスタンスから完全に削除することもできる

チームの運用に合わせて、少しずつフローを改善していけるイメージです。

custom flowsのオン・オフ切り替え

custom flowsはデフォルトでオンになっていますが、グループ単位やインスタンス単位でオフにすることもできます。オフにすると、ユーザーはcustom flowsの作成・有効化・無効化・実行ができなくなり、既存のフローも「Enabled」タブには表示されなくなります(基盤フローは影響を受けず引き続き使えます)。

セキュリティポリシー上の理由でAI機能を制限したい組織でも、柔軟にコントロールできるようになっています。

GAに至るまでの道のり

custom flowsは、いきなり今回GAになったわけではありません。もともとは GitLab 18.4 で、機能フラグ ai_catalog_flows を使った実験的機能(Experiment)として登場しました。その後 GitLab 18.7 でベータ(Beta)に格上げされ、GitLab.com上で有効化。GitLab 18.8ではGitLab Self-ManagedとGitLab Dedicatedでも有効化され、機能フラグがデフォルトで有効になりました。

GitLab 18.9ではパイプラインイベントをトリガーにできるようになり、GitLab 18.10ではプロジェクトのMaintainerが直接有効化できるようになるなど、リリースを重ねるごとに機能とトリガーの種類が拡充されてきました。そして GitLab 19.2 で、機能フラグ ai_catalog_flows が完全に削除され、正式に GA(一般提供) となりました。

長い実験・ベータ期間を経て磨き上げられてきた機能がついに正式版になった、というのがこのアップデートの意味するところです。

GA版で使えるトリガーイベント

custom flowsの強みのひとつが、GitLab上のさまざまなイベントをきっかけにフローを自動起動できる点です。GitLab 19.2時点で対応しているトリガーには、次のようなものがあります。

マージリクエストの準備完了(Merge request ready)
マージリクエストのコードコンフリクト発生(Merge request code conflict)
マージリクエストの承認(Merge request Approved)
ワークアイテムの作成(Work item created)
ワークアイテムのステータス変更(Work item status changed、GitLab 19.2で新規追加)

これらはリリースを重ねるたびに追加されてきたもので、GitLab 19.2では「ワークアイテムのステータスが変わったら自動でフローを走らせる」といった、より細かい業務フローの自動化ができるようになっています。

可視性(Public / Private)の考え方

フロー作成時には、可視性を Public か Private かで選びます。

Publicなフローは、インスタンス上の誰からでも閲覧でき、条件を満たすどのプロジェクトにも有効化できます。
Privateなフローは、管理プロジェクトのGuest以上のロールを持つメンバー、またはトップレベルグループのOwnerロールを持つユーザーだけが閲覧できます。また、有効化できる範囲も管理プロジェクトやそのトップレベルグループ内に限られます。

なお、一度有効化されたPublicなフローは、後からPrivateに戻すことはできない点は注意しておきましょう。

サービスアカウントとグループ共有の仕組み

フローをグループで有効化すると、そのフロー専用のサービスアカウントが自動的に作成されます。このサービスアカウントは次のような性質を持っています。

コンポジットアイデンティティ認証を使い、フローを実行したユーザー本人がアクセスできる範囲を超えてアクセスすることはない
フローが有効化されたトップレベルグループ配下のすべてのプロジェクトに、自動的にメンバーとして追加される
トップレベルグループと共有されている別のグループにもアクセス権が付与される(通常のグループメンバーと同じ扱い)

複数のトップレベルグループでフローのサービスアカウントを共有すると、意図しないアクセス権限が発生するリスクがあるとも案内されているので、権限設計は慎重に行うとよいでしょう。

まとめ

GitLab 19.2 で GA となった custom flows は、Free プランのユーザーでも利用できる、チーム独自のAI自動化ワークフローです。難しく考えず、まずは小さな定型作業ひとつをフロー化してみるところから始めてみてください。

GitLabには、まだ知られていない便利な機能がたくさんあります。この記事をきっかけに、ぜひ普段のGitLab運用をもう一歩使いこなしてみてください。

参考にしたバージョン情報

GitLab 19.2(2026年7月16日リリース)
対象機能: GitLab Duo custom flows(Tier: Free, Premium, Ultimate / Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated)