🛰️ 技術調査 - GitLab Agentic Engineering Platform

GitLab は 2026 年 6 月 10〜11 日に開催したオンラインイベント GitLab Transcend で、エージェント並列実行を前提にした次世代のソフトウェア開発プラットフォームを発表しました。本記事は、その中核である 次世代 SCM・GitLab Orbit・エージェント向けガバナンス・GitLab Duo Agent Platform・GitLab Flex の構造とデータモデルを、公式情報をもとに整理します。

調査対象の起点: GitLab: Built for the agentic engineering era（日本語版あり、更新 2026-06-11）。各機能はベータ / GA 段階のため、最新の仕様は公式ドキュメントを確認してください。

概要

なぜ「人間スケールの SCM」がボトルネックになるのか

ソフトウェア開発の主体がエージェントへ移行すると、人間が 1〜数人でリポジトリを操作する前提で設計された従来の Git バックエンドは、3 つの構造的な問題に直面します。

GitLab はこれらを「IDE やプロンプトの工夫では解けない、基盤の問題」と位置づけ、プラットフォーム全体を再設計しました。

GitLab が再設計した「living system」とは

GitLab はプラットフォームを 4 つのシステムから成る living system として再定義しました。エージェントが知能であるか人間であるかを問わず、4 つすべてのシステムを利用して動作するという設計思想です。

5 つの発表機能と 4 システムの対応

GitLab Flex は購入・ライセンスモデルであり、技術的な Orchestration システムへの直接マッピングではなく便宜上の分類です。

関連技術との比較

従来の Git/SCM と次世代 SCM

RAG ベースのコンテキスト供給と GitLab Orbit コンテキストグラフ

GitLab が公開したコードレビュー精度の比較では、Compare the Market の協力により 79 件の実マージリクエストを検証し、Orbit ベースのコードレビューが約 70% の精度で正確なインラインコメント配置を達成したのに対し、RAG ベースは約 58% にとどまったと報告されています。要点の捕捉率も Orbit が 68%、RAG が 66% でした。GitLab は「RAG はコンテキストなしのアプローチを含む他のすべてのアプローチを下回った」とも述べています。

特徴

次世代 SCM - モーターシステム

• Git プロトコルとの後方互換性を維持しつつバックエンドを再設計する
• エージェントがサーバーサイドでリポジトリに対しタスクに必要な情報だけをクエリする
• 各エージェントをタスクに必要な最小可視性 (minimum visibility) に制限する
• 数千のエージェントを同一リポジトリに安全にデプロイできる

初期テストでの改善値（いずれも「最大」値）:

GitLab Orbit - ナーバスシステム

• ソフトウェアライフサイクル全体を単一のグラフにマッピングする — コード・作業アイテム・パイプライン・デプロイ・本番シグナル
• 変更データキャプチャ (Change Data Capture) により ClickHouse へ取り込み、イベント駆動で継続的に更新する
• MCP・REST・GitLab CLI の複数インターフェースで外部エージェントと接続する
• インデックス処理を独立サービスとして動作させ、GitLab インスタンスへ負荷を与えない
• GitLab Duo Agent Platform からはネイティブに呼び出せる

GitLab の初期テストでは、同一タスク・同一モデルの条件 (On the same tasks, with the same model) で Claude Code に Orbit を組み合わせると、応答が最大 11 倍高速、トークン消費は最大 4.5 分の 1、ハルシネーションは最大 45 分の 1 になったと報告されています。

Governance for Agents - イミュニティシステム

• エージェントのすべてのアクションにアイデンティティ (identity) を付与する
• ポリシー (policy) に基づき実行前の承認ワークフローを適用する
• 入力・推論・ツール呼び出しを監査 (audit) として記録する
• 高リスク操作に承認 (approval) ゲートを設ける

GitLab Duo Agent Platform - オーケストレーションシステム

• イシュー処理・コードレビュー・パイプライン修正をオーケストレーションする
• チーム固有のルールに基づいたコードレビューを実施する
• パイプライン障害を診断し、コード変更が必要か単純な再実行で足りるかを判別する
• 2026 年 1 月より一般提供 (GA)

GitLab Flex - 購入モデル

• 年間コミットメント内でシート・AI 使用量・機能を月次調整できる
• 契約修正や新たな調達サイクルなしで機能追加に対応する
• シートと AI 消費量を単一のコミットメントで一元管理する

構造

C4 モデルの 3 段階で、プラットフォームの内部構造を図解します。

システムコンテキスト図

アクター

外部システム

コンテナ図

Motor System

Nervous System

Immune System

Orchestration System

コンポーネント図

次世代 SCM - Motor System

GitLab Orbit - Nervous System

Orbit Remote コンポーネント

Orbit Local コンポーネント

データ

GitLab Orbit は、ソフトウェアライフサイクル全体のエンティティを単一のグラフへ継続的にマッピングします。GitLab 自身の規模では、5 億ノード（500M）・20 億エッジ（2B）規模のグラフを 45 分以内にインデックスすると報告されています。

なお公式ドキュメントは、Orbit のクエリ結果を「最終インデックスサイクル時点 (point-in-time) の SDLC 状態を反映するもの」と位置づけています。イベント駆動で鮮度を保ちつつも、厳密なトランザクション整合のリアルタイム参照ではない点に注意します。

概念モデル

Orbit グラフのノード種別と、エージェントガバナンスのエンティティの所有・参照関係を示します。

Orbit グラフのノード

エージェントガバナンスのエンティティ

情報モデル

主要エンティティの主要属性を示します。GitLab 公式 API ドキュメントで確認できたフィールドを核とし、Orbit 固有の追加属性やガバナンスエンティティの属性は推測を含みます。

エンティティ属性の出典区分

グラフのエッジ種別

Orbit 紹介ブログに掲載されたクエリ例から、以下のエッジ種別が確認できます。

それ以外の関係（Repository → MergeRequest 等）は、GitLab の一般的なデータ構造から導いた構成です。

構築方法

GitLab Orbit パブリックベータへの参加

GitLab Orbit はパブリックベータです。コンテキストグラフを GitLab.com 上に構築する Orbit Remote と、ローカルにコードグラフを構築する Orbit Local の 2 形態があります。

Orbit Remote の対象ティアは Premium / Ultimate（GitLab.com）です。公式の発表ブログでは「パブリックベータ」ですが、ドキュメント上は Orbit REST API が Experiment、glab / MCP / Orbit Local が Beta で、いずれも機能フラグ管理かつ本番利用前提ではない点に注意します。申込と有効化の手順は次のとおりです。

1. GitLab Orbit 製品ページ の「Request early access」からフォームに記入する
2. GitLab.com にサインインし、対象のトップレベルグループの Owner ロールを確認する
3. 左サイドバーの Orbit > Configuration を開く
4. 対象のトップレベルグループの「Enable」トグルをオンにする

初回インデックス処理はグループの規模に応じて時間がかかります。進捗は次のコマンドで確認します。

glab orbit remote graph-status --full-path your-group

次世代 SCM / ガバナンスのプライベートベータ申請

次世代 SCM と Governance for Agents はいずれもプライベートベータです。Early Access & Preview Partner プログラム のフォームから申し込みます。対象は、ソリューション評価を担うエンジニアリングリーダー・プラットフォームオーナー・AI 導入を推進するエグゼクティブです。

GitLab Duo Agent Platform の有効化

GitLab Duo Agent Platform は 2026 年 1 月より一般提供されており、既定でオンです。無効化されている場合は、GitLab.com のグループで次の手順で有効化します。

1. 対象グループの Settings > GitLab Duo を開く
2. 「Change configuration」を選択する
3. 「Turn on GitLab Duo Agentic Chat, agents, and flows」を有効にする
4. 「Save changes」をクリックする

Self-Managed では右上の Admin エリアから GitLab Duo を開き、同じ設定を行います。

Orbit Local のセットアップ

Orbit Local は glab バージョン 1.94 以降を前提とします。ローカル処理のため GitLab Credits を消費しません。

# glab 経由でバイナリをインストール
glab orbit local --install

# リポジトリをインデックス化
glab orbit local index /path/to/your/repo

# スキーマを確認
glab orbit local schema

利用方法

必須パラメータ一覧

Claude Code を MCP 経由で Orbit に接続する

Claude Code は HTTP トランスポートをネイティブにサポートするため、ラッパー不要で直接接続できます。

claude mcp add --transport http gitlab-orbit https://gitlab.com/api/v4/orbit/mcp

初回のツール呼び出し時にブラウザが開き、GitLab の OAuth 認証が実行されます。事前に glab auth status でセッションを確認しておきます。

Cursor / OpenAI Codex（JSON 設定クライアント）の接続

mcp-remote ラッパーを使う設定例です。

{
  "mcpServers": {
    "gitlab-orbit": {
      "command": "npx",
      "args": ["mcp-remote", "https://gitlab.com/api/v4/orbit/mcp"]
    }
  }
}

MCP ツール

接続後に利用できる MCP ツールは 2 つです。

Orbit コンテキストグラフへのクエリ

CLI を使う方法

# スキーマ取得
glab orbit remote schema

# クエリ実行 (ファイルから)
glab orbit remote query query.json

# クエリ実行 (stdin から)
glab orbit remote query - < query.json

glab orbit remote のサブコマンドは次のとおりです。

REST API を使う方法

# クラスタ正常性
curl -H "PRIVATE-TOKEN: <token>" https://gitlab.com/api/v4/orbit/status

# スキーマ取得
curl -H "PRIVATE-TOKEN: <token>" https://gitlab.com/api/v4/orbit/schema

# MCP ツールマニフェスト取得
curl -H "PRIVATE-TOKEN: <token>" https://gitlab.com/api/v4/orbit/tools

# クエリ実行
curl -X POST https://gitlab.com/api/v4/orbit/query \
  -H "PRIVATE-TOKEN: <token>" \
  -H "Content-Type: application/json" \
  -d @query.json

リクエストボディの例（オープン MR が多いプロジェクト上位 10 件）:

{
  "query": {
    "query_type": "aggregation",
    "nodes": [
      {"id": "p", "entity": "Project", "columns": ["name", "full_path"]},
      {"id": "mr", "entity": "MergeRequest", "filters": {"state": "opened"}}
    ],
    "relationships": [{"type": "IN_PROJECT", "from": "mr", "to": "p"}],
    "group_by": [{"kind": "node", "node": "p"}],
    "aggregations": [{"function": "count", "target": "mr", "alias": "open_mrs"}],
    "aggregation_sort": {"column": "open_mrs", "direction": "DESC"},
    "limit": 10
  }
}

サポートするクエリタイプ（JSON DSL 内の query.query_type）:

Orbit 紹介ブログには、パイプライン障害トリアージの例として Cypher 風の DSL も掲載されています。

MATCH (job:CiJob {status: "failed"})-[:RAN_IN]->(pipeline)-[:FOR]->(mr:MergeRequest)
RETURN mr.title, mr.author, pipeline.started_at, mr.project_id
ORDER BY pipeline.started_at DESC LIMIT 20

REST API へは上記の JSON DSL 形式で送信します。Cypher 形式の文字列をそのまま API へ送る構文は公式ドキュメントで確認できないため、API 呼び出しには JSON DSL を使います。

エンジニアは GitLab UI のグラフ探索画面から、同じグラフへ直接問い合わせることもできます。

Orbit Local をクエリする

Orbit Local は DuckDB ベースのため、SQL で問い合わせます。

# SQL クエリを実行
glab orbit local sql 'SELECT count(*) FROM gl_definition'

# スキーマ確認
glab orbit local schema gl_definition

主なテーブルは gl_definition / gl_file / gl_directory / gl_imported_symbol / gl_edge などです。MCP 対応は将来リリース予定です。

Duo Agent Platform でエージェントに作業させる

AI カタログからエージェント・フローを有効化します。

1. Explore > AI Catalog（または左サイドバーの GitLab Duo > AI Catalog）を開く
2. Agents または Flows タブを選択する
3. 利用するアイテムを選択し Enable で対象プロジェクトを指定する（Maintainer または Owner ロールが必要）

すぐに使えるプリビルトフローには次のものがあります。

GitLab マネージドの外部エージェント（Claude Code Agent・Codex Agent）は GitLab 側で認証情報を管理するため追加設定が不要です。サードパーティエージェントをカスタム設定する場合は、プロジェクトの Settings > CI/CD > Variables に認証用の変数を追加します。

運用

エージェント identity の管理

エージェントごとに複合 identity (composite identity) が付与されます。サービスアカウントと人間ユーザーのメンバーシップを合成し、長期ワークフローでも「誰が何を行ったか」を追跡します。

サービスアカウントの Personal Access Token のスコープは write_repository / api / ai_features を必要最小限とします。

監査ログの運用

• セッションはすべて Project > AI > Sessions に自動記録される。実行ステータス・ステップ詳細・ツール呼び出し・CI/CD ジョブログを参照できる（推論の可視化範囲は Governance 機能の提供状況に依存する）
• クレデンシャル漏洩時は、GitLab の監査証跡からそのクレデンシャルを使用した全ジョブと起動元パイプラインを追跡できる
• Governance for Agents は「何が変更されたか・どのポリシーが許可したか・誰が承認したか」を 1 つのレコードに記録する

ポリシー適用と違反時の挙動

ガバナンスレイヤーは 4 要素で構成されます。

ポリシーが許可しないアクションは、エージェントが実行する前にブロックされます。人間の承認が必要な操作では、セッションが停止して（GitLab Duo のフローでは Input Required のような状態）人間のレビューを待ちます。違反は監査証跡に記録されます。

approval ワークフロー

• チャットセッションでは高リスク操作に Human-in-the-loop 承認が組み込まれる
• フロー (Flows) はセッションが Input Required になると一時停止し、人間の応答後に再開する
• Governance for Agents では、コード変更・依存関係変更・デプロイメント起動など、人間のレビュー速度を超えるリスク操作に承認チェーンを設定できる

Orbit グラフの鮮度監視

Orbit はイベント駆動エンジンで更新を受け取り、鮮度の高い状態を維持します。

参考値は GitLab 自社 SaaS 規模の実測であり、セルフマネージドインスタンスでは規模によって異なります。

次世代 SCM の最小可視性スコープ運用

• エージェントに付与する権限スコープを明示的に設定し、必要以上の読み取り範囲を与えない
• Orbit の認可は GitLab のプロジェクト権限をそのまま継承するため、UI で見えないものはエージェントにも見えない

GitLab Flex による月次調整

ベストプラクティス

エージェントガバナンス設計の 4 軸

人間とエージェントの権限分離

• エージェントにはタスク単位の最小スコープを付与する。コードレビューエージェントにはリポジトリ書き込み権限を与えない
• 読み取り専用エージェントと書き込みエージェントをアーキテクチャ上分離し、悪意ある指示の伝播を防ぐ
• サービスアカウントの Personal Access Token を定期ローテーションする

CI/CD 連携とエージェント設定資産の統制

• AGENTS.md をリポジトリルートに置き、チームの規約・ワークフロー・ガードレールをエージェントのコンテキストへ注入する
• Secret Detection / SAST / Dependency Scanning は per-project 設定でなく グループポリシー 経由で有効化し、新規リポジトリへの適用漏れを防ぐ
• AGENTS.md / CLAUDE.md 等のエージェント設定ファイルはソースコードとして git 管理し、変更を MR ベースでレビューする。変更履歴が監査証跡の一部になる

コンテキスト供給を RAG から Orbit グラフへ移す判断基準

Orbit グラフは RAG を置き換えるものではなく、SDLC コンテキストを GitLab ネイティブに供給する専用レイヤーとして位置づけます。外部ドキュメントや社内 Wiki は引き続き RAG で補完します。

トラブルシューティング

セットアップ診断の標準フロー

まとめ

GitLab Transcend で発表された Agentic Engineering Platform は、エージェント並列実行のボトルネックを「IDE やプロンプト」ではなく SCM バックエンド・コンテキスト供給・ガバナンスという基盤レイヤーで解こうとする再設計です。次世代 SCM はサーバーサイドクエリと最小可視性でクローンコストと並行性を、GitLab Orbit はライフサイクルのコンテキストグラフで RAG の限界を、Governance for Agents は identity/policy/audit/approval でエージェント統制を、それぞれ担います。多くがベータ / Experiment 段階のため、導入を検討する際は本記事のアーキテクチャ理解を土台に、必ず最新の公式ドキュメントで仕様とステータスを確認してください。

この記事が少しでも参考になった、あるいは改善点などがあれば、ぜひリアクションやコメント、SNSでのシェアをいただけると励みになります！

参考リンク

• GitLab 公式（発表・製品）
  • GitLab: Built for the agentic engineering era（Transcend 発表ブログ）
  • GitLab Transcend 発表ブログ（日本語版）
  • GitLab Orbit 製品ページ
  • Introducing GitLab Orbit（紹介ブログ）
  • GitLab Duo Agent Platform 製品ページ
  • Early Access & Preview Partner プログラム
• GitLab 公式ドキュメント
  • Orbit ドキュメント（概要）
  • Orbit Remote セットアップ
  • Orbit Remote: MCP 接続
  • Orbit Remote: glab CLI
  • Orbit Local セットアップ
  • Orbit REST API ドキュメント
  • Duo Agent Platform 有効化・無効化
  • Duo Agent Platform エージェント一覧
  • 外部エージェント設定
  • Duo Agent Platform トラブルシューティング
  • Merge Requests API
  • Pipelines API
  • Jobs API
  • Deployments API
  • Vulnerability Findings API
• 記事・プレスリリース
  • GitLab Announces New Capabilities to Give Enterprises Speed and Control at Agentic Scale（プレスリリース）
  • GitLab Previews Revamped DevOps Platform for the Agentic AI Era（DevOps.com）