--- title: "GitLab Duo Agent Platformとは？料金（GitLab Credits）の見積もりとフロー13本・安全設定【2026年11月】" url: "https://www.issoh.co.jp/tech/details/10660/" published: 2026-01-20 updated: 2026-11-12 categories: ["AIエージェント・MCP"] publisher: "株式会社一創" --- # GitLab Duo Agent Platformとは？料金（GitLab Credits）の見積もりとフロー13本・安全設定【2026年11月】 GitLab Duo Agent Platformは、コードの作成からレビュー、CI/CDの修正、脆弱性への対応までを、複数のAIエージェントとそれをつないだ「フロー」に任せるGitLabの機能群です。GitLab 18.8（2026年1月15日）で一般提供（GA）になり、利用料は人数ではなく実行した処理の量に応じて「GitLab Credits」で払います。 導入を検討する人がつまずくのは、何をすればいくらかかるのか、どこまで安全に任せられるのかが、公式ドキュメントの複数のページに分かれている点です。この記事では、2026年11月11日時点の公式ドキュメントと料金ページ（最新の安定版はGitLab 19.5.3）をもとに、料金の見積もり方、基盤フロー13本の役割、既定モデル、組織ルールの渡し方、サンドボックスと権限の落とし穴を1本にまとめます。 ## まとめ - GitLab Duo Agent PlatformはGitLab 18.8でGAしました。対象はPremiumとUltimateですが、Freeでもクレジットを月単位で購入すれば一部の機能を使えます（GitLab.comは18.10から、Self-Managedは19.0から）。 - 料金は1クレジット1ドル（オンデマンドの定価）です。Premiumは1ユーザーあたり月12クレジット、Ultimateは24クレジットが付きますが、料金ページはこれを期間限定のプロモーションと明記しています。 - 付属クレジットは個人に割り当てられ、Code Review Flowのようにサービスアカウントで動くフローには使われません。フローの費用は月次コミットメントかオンデマンドから引かれるので、付属分だけで見積もると足りなくなります。 - 定額の機能は、Code Review Flowが1回0.25クレジット、SAST Vulnerability Resolution Flowが1回4クレジットです。チャットなどは呼び出したモデルごとに課金され、既定のClaude Sonnet 5.5は1クレジットで3.2回です。 - 安全面では、サンドボックスは条件を満たさないとジョブログに警告を出して適用されないこと、`setup_script`がサンドボックスの外で実行者の資格情報を使えること、GitLab側で基盤フローを止めてもIDEとGitLab Duo CLIからは実行できることの3点を先に押さえます。 ## GitLab Duo Agent Platformの主要機能と利用窓口 公式ドキュメントの[GitLab Duo Agent Platform](https://docs.gitlab.com/user/duo%5Fagent%5Fplatform/)は、この機能群を、開発ライフサイクル全体に複数のエージェントを組み込み、人がエージェントと非同期に協業するためのものと説明しています。使う側から見ると、入口は次の3つです。 | 入口 | 動く場所 | 主な用途 | | ------------ | ----------------------------- | ------------------------ | | Agentic Chat | GitLab UI・IDE | 質問への回答、ファイルの作成・編集 | | エージェント | GitLab UI・IDE・CLI | 計画、データ分析などの専門作業 | | フロー | GitLab UI：Runner、IDE・CLI：実行端末 | Issueから MR、レビュー、パイプライン修正 | フローは複数の手順をまとめて自動で進める仕組みで、GitLabが用意する「基盤フロー」と、自社で定義する「カスタムフロー」があります。ほかに、Claude CodeやCodexなど外部のコーディングエージェントをGitLabのイベントから呼ぶ「外部エージェント」も同じ基盤の上で動きます。GitLabそのものの基本操作から確認したい場合は[GitLabの使い方：プロジェクト作成からIssue・MR・CI/CDまでの手順【2026年10月】](/tech/details/18874/)を先に読むと、MRやRunnerといった用語がつながります。 ### GitLab 18.8〜19.5の主要機能と課金仕様の変更 ベータは18.2で始まり、Self-Managed向けは18.4で実験的機能として入りました。GA後は月1回のマイナーリリースごとに機能が増えています。版ごとの詳細は[GitLab 19.2とは？Duo CLI・カスタムフローGAで変わる開発運用](/tech/details/15769/)と[GitLab 18.10の新機能とパッチ18.10.8までの修正｜保守終了後の19.4・19.5への移行経路](/tech/details/11561/)で扱っており、ここでは導入判断に効く変化だけを並べます。 | 版 | Agent Platformに関わる変化 | | ----- | --------------------------------------------------- | | 18.8 | GA、GitLab Creditsでの課金開始 | | 18.9 | コンポジットアイデンティティが常時有効に | | 18.10 | GitLab.comのFreeでクレジット購入が可能に | | 19.0 | Self-ManagedのFreeでもクレジット購入が可能に | | 19.2 | GitLab Duo CLI 9.0.0でCLIがGA、カスタムフローがGA | | 19.3 | クレジットの利用上限（usage caps）がGA | | 19.4 | Duo CLIがDeveloper Flowで動く形に、消費順の変更 | | 19.5 | GitLab MCPサーバーとRecommend ReviewersがGA、Orbitのクエリ課金開始 | 19.5は2026年10月15日のリリースで、11月11日時点の最新パッチは19.5.3です。公式ドキュメントにはすでに19.6（2026年11月19日予定）の変更も載っているため、Self-Managedで運用している場合は、ページの履歴欄にある版番号と自社の版を照らし合わせてから設定を探してください。 ## 対応プランとFreeで使える範囲 製品ページのバッジはPremiumとUltimateですが、ドキュメントの機能表にはFree列があります。Freeは月次コミットメント（後述）としてクレジットを買えば、Agentic Chat、コード提案、カスタムエージェント、Developer Flow、Code Review Flowなどを使えます。外部エージェントはFreeでは使えません。 | 項目 | Free | Premium | Ultimate | | ------------------- | --------- | ------------- | -------- | | 本体価格 | 0ドル | 29ドル／人・月（年払い） | 個別見積もり | | 付属クレジット | なし | 12／人・月 | 24／人・月 | | クレジット購入 | 月次コミットメント | 可 | 可 | | 外部エージェント | 不可 | 可 | 可 | | Recommend Reviewers | 不可 | 可 | 可 | | SAST・シークレット系フロー | 不可 | 不可 | 可 | Freeのオンデマンド利用は暦月あたり25,000ドルで自動的に止まり、翌月に戻ります。前提条件として、GitLab Duo ProかDuo Enterpriseを契約していない場合は、トップレベルグループかインスタンスで「GitLab Duo Core」を有効にしておく必要があります。Duo Enterpriseアドオンを契約している場合、18.9以前はAgent Platformと併用できず、18.10以降への更新が要ります。Self-Managedでセルフホストモデルを使う場合、オンラインライセンスならアドオンなしで従量課金になりますが、外部と通信しないオフラインライセンスでは「GitLab Duo Agent Platform Self-Hosted」アドオンの購入が必要です。GitHubとの料金体系の違いは[GitHubとGitLabの違い｜ActionsとGitLab CIの対応表・料金・セルフホスト比較](/tech/details/4219/)で比較しています。 ## GitLab Creditsの料金と消費量 [GitLab Credits and usage billing](https://docs.gitlab.com/subscriptions/gitlab%5Fcredits/)によると、クレジットは従量課金の共通通貨で、請求はプロジェクト単位ではなくトップレベルグループ（ルート名前空間）単位でまとめられます。GitLab Duo ProとEnterpriseの機能はシート課金のままで、クレジットを消費しません。 ### 付属・コミットメント・オンデマンドの消費順 19.4以降は、評価用の一時クレジットも含め、次の4段階の順に使われます。 1. 付属クレジット：Premium・Ultimateの各ユーザーに付く分。個人に割り当てられ、他人と共有できず、翌月に繰り越せません。 2. 評価用の一時クレジット：月次コミットメントを購入しておらず、オンデマンドの利用規約にも同意していない場合に、営業へ依頼できる無料の共有枠です。有効期限は30日です。 3. 月次コミットメント：年単位で購入し12で割った量が毎月使える共有プールです。増量はいつでもできますが、減量は更新時だけです。 4. オンデマンド：上の3つを使い切った後の分で、1クレジット1ドルで月ごとに請求されます。利用規約に同意した時点で有効になり、同意は撤回できません。 見積もりで外せないのは課金先の区別です。人がAgentic Chatを直接使った分はその人に付きますが、基盤フローやカスタムフローのようにサービスアカウントで動く処理は、誰が起動しても名前空間に請求されます。名前空間への請求は月次コミットメントとオンデマンドから引かれるため、付属クレジットでは払えません。 ### 定額で課金される4つの機能 次の4機能は、内部でLLMを何回呼んでも1回の実行あたりの消費量が決まっています。セルフホストモデルで動かすと20%安くなりますが、この割引は19.1で入った機能フラグ`self_hosted_flat_pricing_discount`で制御されています。 | 機能 | 1クレジットでの回数 | 1回あたり | セルフホスト時 | | ---------------------------------- | ---------- | ------ | ------- | | Code Suggestions | 50回 | 0.02ドル | 62.5回 | | Code Review Flow | 4回 | 0.25ドル | 5回 | | SAST False Positive Detection Flow | 1回 | 1ドル | 1.25回 | | SAST Vulnerability Resolution Flow | 0.25回 | 4ドル | 0.3125回 | ### モデルごとの呼び出し回数とプロモ価格の期限 定額でない機能は、LLMを1回呼ぶたびに課金されます。Agentic Chatで1通送ると、回答のために1回以上の呼び出しが起きます。新しく大きいモデルほど1クレジットで呼べる回数が減ります。主なモデルの値は次のとおりです（GitLab管理のモデル）。 | モデル | 1クレジットでの回数 | 備考 | | ------------------------ | ---------- | ----------------------- | | Claude Haiku 5.5 | 8.0 | Recommend Reviewersの既定 | | Gemini 3.6 Flash | 6.7 | 2026-12-31までプロモ、以後約3.3 | | Claude Sonnet 5.5 | 3.2 | チャット・多くのフローの既定 | | GPT-6.1 Sol（27.2万トークン以下） | 2.86 | 長文脈は1.54 | | Claude Sonnet 4.6 | 2.0 | Security Review Flowの既定 | | Claude Opus 5.5 | 1.35 | | | GPT-5.6 Sol（短文脈） | 1.33 | 2026-11-21までプロモ、以後約1.0 | | セルフホストモデル | 8.0 | 対応・互換モデル共通 | 同じ呼び出し回数なら、プロモ終了後の費用はGemini 3.6 Flashで約2倍、GPT-5.6 Solの短文脈で約1.33倍になります。見積もりは期限後の値で計算するのが安全です。 ### GitLab Orbitのクエリ課金 製品ページで大きく扱われているGitLab Orbitは、コード、MR、パイプライン、デプロイを1つのグラフにつないでエージェントに渡す仕組みです。[GitLab Orbit credit usage](https://docs.gitlab.com/subscriptions/gitlab%5Forbit%5Fcredit%5Fusage/)によると、19.5からOrbit APIへのクエリは100回あたり3クレジットを消費し、GitLab Duoが自動で投げたクエリも含まれます。手元のOrbit CLIが作るローカルのグラフへの問い合わせは課金されません。グラフ容量の上限はGitLab.comとDedicatedでPremiumが2GiB、Ultimateが5GiBで、購入やSelf-Managedでの利用は営業経由です。 ### 失敗した実行の扱い GitLab.comのGitLab管理モデルでは、途中で失敗したフローはクレジットを引きません。Self-Managedのセルフホストモデルは逆で、呼び出しの開始時点で課金されるため、途中で失敗しても呼んだ分は請求されます。同じSelf-Managedのセルフホストモデルでは、定額の機能も失敗時に満額が請求されます。セルフホスト環境では、利用者に開放する前にクレジットを消費しない機能検証（functional verification check）を通しておくと、設定ミスで無駄な課金が出ません。 ## 月額費用の見積もり方 公式の単価から、Premiumで10人のチームがAgentic ChatとCode Review Flowを使う場合のクレジット費用を試算します。Runnerの実行費用や、利用に応じて発生するOrbitクエリ料金は含めません。ここでの回数は前提として置いた数字で、実際の呼び出し回数は使い方で大きく変わります。 | 用途 | 前提 | 消費 | 払い元 | | ---------------- | ----------------------- | ------- | ------------- | | Agentic Chat | 1人月100回呼び出し（Sonnet 5.5） | 約31.3／人 | 付属12を超えた分がプール | | Code Review Flow | 月200回実行（1MRにつき1回と仮定） | 50 | 名前空間（付属は使えない） | チャットは1人あたり約31.3クレジットから付属の12を引いた約19.3クレジットが超過し、10人で約193クレジットです。Code Review Flowの50クレジットを足すと、付属クレジットとは別に月約243クレジット、オンデマンドなら約243ドルかかります。Premiumの本体価格（10人で月290ドル相当）に近い額で、付属クレジットだけで足りるのは、チャットを軽く使う程度のチームに限られます。 想定外の請求を防ぐには、19.3でGAした[利用上限（usage caps）](https://docs.gitlab.com/subscriptions/gitlab%5Fcredits%5Fdashboard/)を先に設定します。上限は3種類あり、サブスクリプション全体の上限はオンデマンド分だけを数え、達すると全ユーザーのクレジット機能が止まります。ユーザー単位の一律上限と個別上書きは、人が直接使った分だけを数えます。フローの費用は人ではなく名前空間に付くため、ユーザー単位の上限ではレビューの自動実行を抑えられない点に注意してください。 ## 基盤フロー13本の一覧と起動のしかた [Foundational flows](https://docs.gitlab.com/user/duo%5Fagent%5Fplatform/flows/foundational%5Fflows/)の一覧は2026年11月時点で13本です。9月時点の11本から、作業計画を作るGenerate Workplanと、脆弱性の優先度付け用の文脈を作るVulnerability Context Flowが増えました。提供段階と対象プランはフローごとに違い、セキュリティ系の多くはUltimateだけです。 | フロー | 役割 | 段階 | プラン | 課金 | | ---------------------------------- | ------------------------ | --- | --------- | ------- | | Developer | IssueからMRを作る | GA | Free以上 | あり | | Software Development | IDEで計画を立てて実装 | GA | Free以上 | あり | | Code Review | MRの自動レビュー | GA | Free以上 | 1回0.25 | | Fix CI/CD Pipeline | 失敗ジョブの診断と修正 | GA | Free以上 | あり | | Convert to GitLab CI/CD | JenkinsからGitLab CI/CDへ移行 | GA | Free以上 | あり | | Recommend Reviewers | MRのレビュアーを推薦 | GA | Premium以上 | あり | | SAST False Positive Detection | SASTの誤検出を判定 | GA | Ultimate | 1回1 | | Resolve SAST Vulnerability | SASTの指摘を直すMRを作成 | GA | Ultimate | 1回4 | | Secret False Positive Detection | シークレット検出の誤検出を判定 | GA | Ultimate | あり | | Security Review | MRのビジネスロジック脆弱性を検出 | ベータ | Ultimate | 1回約8〜20 | | Agentic Breaking Change Resolution | 依存更新MRの破壊的変更を修正 | ベータ | Ultimate | なし | | Generate Workplan | 作業項目の作業計画を下書き | 実験 | Premium以上 | なし | | Vulnerability Context Flow | 脆弱性の優先度付け用の文脈を生成 | 実験 | Ultimate | 記載なし | 課金の数字はクレジット数です。Security Review Flowはベータでも課金され、[公式の目安](https://docs.gitlab.com/user/application%5Fsecurity/security%5Freview/)は小さな差分で約8、標準的な機能ブランチで約14、大きな変更で約20クレジットです。Code Review Flowの30〜80倍にあたるため、全MRに自動で走らせる前に対象を絞ります。ベータ期間中は手動でしか起動できません。課金なしのベータ・実験的機能も、GAになった時点で全版・全提供形態で課金が始まり、GA化はいつでも起こり得ると明記されています。 SASTの指摘を扱うフローは、事前にSASTがパイプラインで動いている必要があります。SASTの組み込み方は[SASTとは？DAST・SCAとの違いとCI/CDへの組み込み・導入判断を実装視点で解説](/tech/details/15880/)で扱っています。 ### Developer FlowとSoftware Development Flowの使い分け コードを書くフローは2本あり、どちらが動くかは作業を始める場所で決まります。 | 始める場所 | 動くフロー | 実行場所 | | --------------------------------------------- | -------------------- | -------------- | | GitLab UI | Developer | Runner | | GitLab UIのAgentic Chat | Developer | Runner（別セッション） | | GitLab Duo CLI | Developer | CLIを動かす端末 | | IDEのFlowsタブ（VS Code・JetBrainsはclassic layout） | Software Development | IDE | GitLab UIでは、IssueにフローをアサインするほかにIssueで`@duo-developer-`とメンションする、「Implement」を選ぶ、作業項目のステータスを変える、のいずれかでDeveloper Flowが始まります。Agentic Chatから起動した場合、フローは別セッションとして動き、チャット側のツール承認はフローには適用されません。 ## 既定モデルと選べるモデル [Model selection](https://docs.gitlab.com/user/duo%5Fagent%5Fplatform/model%5Fselection/)によると、2026年10月7日にAgentic Chat、Developer、その他のエージェントの既定モデルがClaude Sonnet 5.5（Google CloudのGemini Enterprise Agent Platform経由）に変わりました。Code Review Flowは10月5日に同じモデルへ、Recommend Reviewers Flowは10月8日にClaude Haiku 5.5へ変わり、Security Review FlowだけはClaude Sonnet 4.6のままです。 既定モデルのまま使っていると、GitLabは利用者に通知せずにモデルを入れ替えることがあります。上の表のとおりモデルで1クレジットあたりの回数が違うため、モデルの自動変更による課金倍率の変化を避けたい場合は、トップレベルグループで利用モデルを明示的に選びます。総費用は呼び出し回数によって変動します。19.1からはAgentic Chatで使えるモデルを特定のモデルに絞れますが（19.2でGA）、既定モデルは常に使える状態で外せません。19.5ではこの制限を外部エージェントにも広げる機能がフラグ付き（既定は無効）で入りました。 ## AGENTS.md・Agent Skillsによる組織ルールの適用範囲 コーディング規約やビルド手順をエージェントに渡す手段は5つあり、効く範囲が少しずつ違います。共通する例外はCode Review Flowで、AGENTS.mdもSkillsも読まず、レビュー基準は専用のレビュー指示ファイルで渡します。 | 手段 | 置き場所 | 効く対象 | | --------------- | --------------------------------------- | ------------------------------------------- | | AGENTS.md | リポジトリ直下など | Chat、フロー（Code Review除く） | | Agent Skills | skills配下か.agents/skills配下のSKILL.md | ローカルのChat、GitLab UI・ローカルのフロー（Code Review除く） | | カスタムルール | .gitlab/duo/chat-rules.md | Chat、エージェント、フロー（Code Review除く） | | MRレビュー指示 | .gitlab/duo/mr-review-instructions.yaml | Code Review Flowのみ | | ワークスペースサブエージェント | .agents/agents配下 | Developer Flowのみ | AGENTS.mdには、ユーザー単位、プロジェクト単位、サブディレクトリ単位の3段階がありますが、GitLab UIで効くのはプロジェクト単位だけです。ユーザー単位とサブディレクトリ単位は、エディタ拡張（VS Code 6.60以降、JetBrains 3.26.0以降）とGitLab Duo CLI（8.47.0以降）でしか読まれません。Agent Skillsはプロジェクト単位が18.10、ユーザー単位が19.0（Duo CLIのみ・実験的機能）からで、GitLab UIのAgentic ChatはSkillsに対応していません。AGENTS.md自体の書き方は[AGENTS.mdとは？書き方・配置とCodex・Claude Code・Copilotの読み込み仕様【2026年11月実測】](/tech/details/19289/)、SKILL.mdの仕様は[Agent Skillsとは？SKILL.md仕様とAAIF寄贈後も移植性を保つ実装手順](/tech/details/17685/)を参照してください。 ### カスタムフローでAGENTS.mdを読ませる設定 基盤フローはAGENTS.mdを自動で読みますが、カスタムフローは定義ファイルで受け取る設定を書かないと読みません。[AGENTS.md customization files](https://docs.gitlab.com/user/duo%5Fagent%5Fplatform/customize/agents%5Fmd/)の例は次のとおりです。 ``` components: - name: "my_agent" type: AgentComponent prompt_id: "my_prompt" inputs: - from: "context:inputs.user_rule" as: "agents_dot_md" optional: true ``` `optional: true`を付けると、AGENTS.mdが無いリポジトリでもフローが失敗しません。AGENTS.mdを追加・更新しても、すでに始まっている会話とフローには反映されず、新しく始めたものから効きます。 ## 外部エージェントとGitLab Duo CLI 外部エージェントは、Claude Code、OpenAI Codex、Amazon Q、Geminiなどを、MRやIssueのイベントをきっかけにRunner上で動かす仕組みです。GitLabが資格情報を管理して提供するのはAnthropic ClaudeとOpenAI Codexだけで、Amazon QとGeminiは自前の資格情報を使います。[External agents](https://docs.gitlab.com/user/duo%5Fagent%5Fplatform/agents/external/)は機能フラグで制御され、自社の名前空間やインスタンスで使うにはGitLabサポートへの連絡が必要と書かれています。Self-Hostedモデルの環境では使えません。また、外部エージェントはGitLab標準のプロンプトスキャンの対象外で、組み込みエージェントやフローと同等のネットワーク隔離も適用されません。導入前に外部プロバイダーのデータ取扱条件とセキュリティ対策を確認してください。なお、Claude CodeやCursorなど外部のAIツールからGitLabのIssueやMRを操作する接続設定は、[GitLab MCPサーバーの接続設定：Claude Code・Cursorでの使い方とツール一覧](https://www.issoh.co.jp/tech/details/19635/)で扱っています。 GitLab Duo CLI（コマンド名`duo`）は19.2でGAし、19.4からはGitLab UIと同じDeveloper Flowを手元で動かします。対話モードでは端末でツール呼び出しを承認しながら進め、ヘッドレスモードではスクリプトやRunnerから非対話で実行できます。`glab`経由でも呼べます。GitLab以外のツールでMRレビューを自動化したい場合の比較材料としては、[PR-AgentをGitLabで使う手順｜CI・Webhook・Lambdaの設定と自動レビューの制御【v0.49対応】](/tech/details/2575/)が参考になります。 ## 安全に動かすための実行環境と権限 GitLab UIから起動するフローはRunner上のCI/CDジョブで動き、通常は実行者とサービスアカウントを組み合わせた権限でリポジトリやAPIを操作します。導入時に最も事故につながりやすいのはこの章の4点です。 ### サンドボックスが外れる条件 フローの通信とファイルアクセスを制限する[実行環境サンドボックス](https://docs.gitlab.com/user/duo%5Fagent%5Fplatform/environment%5Fsandbox/)は、Anthropic Sandbox Runtime（SRT）が入ったイメージで、ジョブがユーザー名前空間とマウント名前空間を作れるときだけ有効になります。使えるイメージは、既定イメージ（v0.0.6以降）、強化版のUBI 9 Minimal、SRT 0.0.20以降を入れたカスタムイメージです。`image: python:3.11`のようにSRTの無いイメージを指定すると、通信制限はかかりません。 Runnerの`privileged = true`は条件を満たす方法の1つですが、それだけでは足りず、必須でもありません。ホストの`user.max_user_namespaces`が0の場合、seccompやAppArmorが`CLONE_NEWUSER`を塞いでいる場合、docker-autoscalerやkubernetes executorで特権がジョブコンテナまで届かない場合は失敗します。失敗してもフローは止まらず、ジョブログに次の警告を出してサンドボックスなしで動きます。 ``` Warning: SRT found but can't create sandbox (insufficient privileges), running command directly without sandbox ``` この警告のログ監視で、サンドボックスなしの実行を検知できます。通信先の制限が必須なら、Runner側のファイアウォールやKubernetes NetworkPolicyでも送信先を制限します。ドキュメントには、サンドボックスを作れないときにジョブを失敗させる「必須化」の設定が19.6の機能として載っていますが、カスタムイメージや`setup_script`を使うプロジェクトでは、どの`srt`コマンドが動くかをプロジェクト側が決められるため、必須化しても隔離は保証されないと注記されています。 ### agent-config.ymlとsetup\_scriptの権限 フローの実行環境は`.gitlab/duo/agent-config.yml`で決めます。このファイルは既定ブランチからだけ読まれ、別ブランチに置いたものは無視されます。次の例は、サンドボックス適用後の追加許可先をregistry.npmjs.orgに絞る設定です。GitLabなどの固定許可先は残り、setup\_script中の通信にはこの制限が適用されません。 ``` setup_script: - npm ci network_policy: include_recommended_allowed: false allowed_domains: - registry.npmjs.org ``` `allowed_domains`と`denied_domains`は各1,000件まで、`"*"`は使えず、`include_recommended_allowed`の既定は`false`です。定義済みのCI/CD変数はこのファイルの設定に使えません。 注意すべきは`setup_script`です。このコマンドはサンドボックスが適用される前に外で動き、実行者のOAuthトークン、サービストークン、身元情報を含むフロー内のすべての環境変数にアクセスできます。しかも使われるのは、ファイルをコミットした人ではなくフローを起動した人の資格情報です。`agent-config.yml`への変更は認証情報に触れる変更として扱います。既定ブランチへの直接pushを制限し、このファイルにCode Ownersを指定したうえで、所有者の承認を必須にする承認ルールを設定してください。 ### サービスアカウントとコンポジットアイデンティティ 基盤フローを有効にすると、トップレベルグループに`duo-<フロー名>-<グループ名>`という名前のサービスアカウントが作られ、各プロジェクトにDeveloperロールで追加されます（カスタムフローは`ai-`で始まる名前）。実行時は起動した人のロールとサービスアカウントのDeveloperロールを組み合わせた[コンポジットアイデンティティ](https://docs.gitlab.com/user/duo%5Fagent%5Fplatform/composite%5Fidentity/)が使われ、両者のうち制約の強いほうが適用されます。Maintainerがフローを起動しても、フローはDeveloperの範囲でしか動きません。 フローが作ったMRは、サービスアカウントではなく起動した人に帰属します。職務分離を求めるコンプライアンス要件に合わせた仕様です。また、フローがアクセスできるのは、起動した人が見られるプロジェクトのうちサービスアカウントが追加されているものに限られます。なお、Agentic Chatにはコンポジットアイデンティティが適用されず、使う人の権限で動きます。 ### 基盤フローの停止設定とIDE・CLIへの適用範囲 グループ設定で基盤フローやフロー実行をオフにしても、止まるのはGitLab上で動くフロー（IssueやMRから起動するもの）だけです。Agent Platformが使えるプロジェクトであれば、利用者はIDEやGitLab Duo CLIのセッションから同じフローを実行できます。組織として利用を禁止する場合は、Agent Platform自体をオフにします。利用上限は費用の制御であり、ユーザー単位の上限では付属クレジットが残っている間の利用や名前空間に課金されるフローを止められません。 ## 導入が向くチームと見送る条件 向いているのは、すでにGitLab PremiumかUltimateを使い、MRとCI/CDがGitLabに集まっているチームです。レビュー、パイプライン修正、SASTの誤検出判定は、GitLabの中にある情報だけで完結するため、別のAIツールより文脈を集める手間が少なく済みます。Code Review Flowの1回0.25ドルは、レビュー待ちで止まる時間と比べて判断しやすい単価です。 見送るべきなのは次のような場合です。 - ソースコードの管理がGitHubなどGitLab以外にあり、GitLabはCI/CDだけに使っている：GitLabのMRやIssueを起点にするフローを主目的とする場合は、対象作業をGitLabに集約できるかを先に確認します。 - Runnerがkubernetes executorで、名前空間の作成をセキュリティ方針で禁じている：サンドボックスが効かないまま、資格情報を持つフローを動かすことになります。 - 月額予算を超えられず、予算到達による月途中の利用停止も許容できない：クレジット消費は実行量に依存するため、必要な処理を予算内で継続できるか、試行期間の利用量から判断します。 自社の業務フローに合わせたエージェントの設計から相談したい場合は、[AIエージェント開発](/service/ai/agent/)の支援内容も参考にしてください。 ## よくある質問 ### GitLab Duo Agent Platformはいつから正式版ですか？ GitLab 18.8で一般提供になり、リリースは2026年1月15日です。ベータは18.2から提供されていました。Self-Managedでは18.4で実験的機能として入り、18.9で機能フラグが削除されています。 ### GitLab DuoとGitLab Duo Agent Platformは何が違いますか？ GitLab DuoはGitLabのAI機能全体の名前です。シート課金のアドオン（Duo Pro、Duo Enterprise）とPremium以上に含まれるDuo Coreがあり、Agent Platformはその中のエージェントとフローを扱う部分で、GitLab Creditsの従量課金です。Duo ProとEnterpriseの機能はクレジットを消費しません。Duo Coreの利用者は2026年5月21日から従来型（非エージェント型）のチャットを使えなくなっており、チャットを使うにはAgent Platform側でクレジットを消費します。 ### GitLab Duoの料金はいくらですか？ Agent Platformはオンデマンドの定価で1クレジット1ドルです。Premium（29ドル／人・月の年払い）には月12クレジット、Ultimateには月24クレジットが1人ずつ付きますが、期間限定のプロモーションと明記されています。Code Review Flowは1回0.25ドルです。 ### Freeプランでも使えますか？ 使えます。GitLab.comは18.10から、Self-Managedは19.0から、Freeでも月次コミットメントとしてクレジットを購入するとAgentic Chatや一部のフローを使えます。外部エージェント、Recommend Reviewers Flow、SASTとシークレット検出の各フローはFreeの対象外です。 ### Claude CodeやCodexをGitLabのコーディングエージェントとして動かせますか？ 外部エージェントとして、MRやIssueのイベントからRunner上で動かせます。ClaudeとCodexはGitLabが管理する資格情報で動かせますが、機能フラグで制御されており、有効化にはGitLabサポートへの連絡が必要です。Freeプランでは使えません。 ## 関連記事 - [GitLabの使い方：プロジェクト作成からIssue・MR・CI/CDまでの手順【2026年10月】](/tech/details/18874/) - [GitLab 19.2とは？Duo CLI・カスタムフローGAで変わる開発運用](/tech/details/15769/) - [GitHubとGitLabの違い｜ActionsとGitLab CIの対応表・料金・セルフホスト比較](/tech/details/4219/) - [AGENTS.mdとは？書き方・配置とCodex・Claude Code・Copilotの読み込み仕様【2026年11月実測】](/tech/details/19289/) - [PR-AgentをGitLabで使う手順｜CI・Webhook・Lambdaの設定と自動レビューの制御【v0.49対応】](/tech/details/2575/) --- 出典: [GitLab Duo Agent Platformとは？料金（GitLab Credits）の見積もりとフロー13本・安全設定【2026年11月】]()（株式会社一創）