Orbit Remoteを使ってみる

プラン: Premium、Ultimate
提供形態: GitLab.com
ステータス: ベータ

この機能の利用可否は機能フラグによって制御されています。詳細については、履歴を参照してください。この機能はテスト目的で利用可能ですが、本番環境での使用には対応していません。

前提条件

Orbitを有効にするトップレベルグループのオーナーロール

Orbitはトップレベルグループのみをインデックス作成します。サブグループとプロジェクトは自動的にインデックス作成を継承します。

ステップ1: Orbitを有効にする

左サイドバーでマイワークを展開します。
Orbit > 設定を選択します。
インデックスリストでトップレベルグループを見つけます。
有効にするを切り替えます。

Orbitはすぐにインデックス作成を開始します。初回のインデックス作成は、小規模なグループでは数分、数千のプロジェクトを持つグループでは最大30分かかります。

インデックス作成のステータスはいつでも確認できます。

glab orbit remote status

ステップ2: 最初のクエリを実行する

Orbit Remoteは同じグラフを3つのインターフェースで公開しています。クエリを実行するユーザーに合ったものを選択してください。

方法	最適な用途	セットアップ	課金
GitLab Duo Agent Platform	GitLab UIのエンドユーザー	不要	消費対象外
MCP	Claude Code、Codex、その他のAIエージェント	エージェントの初回設定	GitLab Credits
REST API	スクリプト、ダッシュボード、カスタムツール	APIトークン	GitLab Credits

GitLab Duo Agent Platform（セットアップ不要）

OrbitはGitLab Duo Agent Platformに組み込まれています。GitLab Duo Agent、Planner Agent、Security Analyst Agent、Data Analyst Agent、CI Expert Agent、Developer Flowは、グラフトラバーサルで回答するのが最適な質問に対して、Orbitのquery_graphツールとget_graph_schemaツールを自動的に呼び出します。ツールの選択や設定は不要です。

たとえば、deploy_userメソッドの名前変更を依頼する作業アイテムを登録すると、Developer FlowはOrbitを使用してそのメソッドを呼び出しているすべてのサービスを特定し、それぞれを更新するMRを作成します。

GitLab Duoのクエリは消費対象外であり、GitLab Creditsを消費しません。

MCP（Claude Code、Codex、その他のエージェント）

セットアップについてはMCPを使用してOrbitにアクセスするを参照してください。設定が完了すると、query_graphとget_graph_schemaの2つのツールが使用できます。

AIエージェント向けOrbitスキルをインストールする

OrbitスキルはAIエージェントにクエリレシピ、DSLガイダンス、トラブルシューティングを提供し、初回から正しいOrbitクエリを作成できるようにします。

glab skills install --global orbit

プロジェクトスコープのインストール、アップデート手順、スキルの内容については、Orbitスキルを使用してAIコーディングエージェントをセットアップするを参照してください。

REST API

your-groupをOrbitを有効にしたトップレベルグループのパスに置き換えてください。full_pathフィルターはクエリのスコープを絞り込み、Orbitの選択性検証を通過させます。

curl --request POST \
  --header "Authorization: Bearer <your_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "query": {
      "query_type": "traversal",
      "node": {
        "id": "p",
        "entity": "Project",
        "columns": ["name", "full_path"],
        "filters": {
          "full_path": {"op": "starts_with", "value": "your-group/"}
        }
      },
      "limit": 10
    },
    "format": "raw"
  }' \
  "https://gitlab.com/api/v4/orbit/query"

次に試すこと

Orbitのインデックス対象 - クエリを作成する前にカバレッジを理解する
スキーマリファレンス - 28種類のノードタイプとそのプロパティを確認する
Cookbook - 一般的なユースケース向けのコピー&ペーストクエリ
Orbit Localを使ってみる - ローカルリポジトリをオフラインでクエリする