正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

GitLab Duo Agent Platformへの移行

  • プラン: Premium、Ultimate
  • 提供形態: GitLab Self-Managed、GitLab Dedicated

GitLab Duo（非エージェント型）からAgent Platformへ移行すると、ソフトウェア開発ライフサイクル全体で（エージェントと呼ばれる）複数のアシスタントにアクセスできるようになります。

お使いのインスタンスをAgent Platformへ移行するには、次の手順を完了します:

  1. 環境を設定する
  2. 設定を検証する
  3. Agent Platformを設定する
  4. 使用状況を検証する

移行後に利用可能な機能

次の表は、GitLab Duoの非エージェント型機能と、Duo Agent Platformへの移行後にユーザーがアクセスできるエージェント型バージョンを示しています。Duo Agent Platformの機能の完全なリストについては、Generally available featuresおよびベータおよび実験機能を参照してください。

非エージェント型機能Agent Platform
GitLab Duo Non-Agentic ChatAgentic Chat
複雑な質問に回答し、自律的にファイルを作成および編集します。プランナーおよびセキュリティ分析エージェントに接続します。マージリクエストのサマリー、ディスカッションサマリー、コードリファクタリング、およびテスト生成は、現在Agentic Chatの一部です。
GitLab Duoコードレビューコードレビューフロー 1
コードレビュータスクを自動化し、チーム全体でコーディング標準を適用します。
根本原因分析CI/CDパイプライン修正フロー 1
失敗したCI/CDパイプラインを診断し、自動的に修正します。
脆弱性の説明と脆弱性の修正SAST脆弱性の修正フロー 1
SASTの脆弱性の修正と修正手順を自動的に生成します。

補足説明:

  1. フローを実行するように設定されたRunnerが必要です。Runnerを設定しない場合、Duo Agent Platformへの移行後、これらの機能はGitLab Duo（非エージェント型）でこれらの機能に依存していたユーザーには利用できなくなります。

はじめる前

GitLab 19.0以降が必要です。

環境を設定する

GitLab Duo（非エージェント型）とは異なり、Duo Agent PlatformはRunner上でフローを実行し、サービスアカウントを使用してコミットとパイプラインを作成します。これには、非エージェント型機能にはなかった設定要件が必要です。

Duo Agent Platform用に環境を設定するには:

  1. インスタンスを設定します。
  2. GitLabインスタンスからの送信接続を許可するようにネットワークを設定します。
  3. フローを使用するようにインスタンスまたはグループRunnerを設定します。CI/CDを使用するフローは、Runnerで実行されます。Agentic ChatはRunnerを必要としません。
  4. RunnerからGitLabインスタンスへの接続を許可します。
  5. オンラインライセンスを使用している場合は、サブスクリプションデータを同期します。

設定を検証する

環境を設定した後、次の診断チェックを実行します:

Duo Agent Platformを設定する

環境を設定した後、次の設定を行います:

  1. Duo Agent Platformをオンにする。
  2. 基本フローをオンにする。
  3. 基本フローで使用されるサービスアカウントのプッシュルールを設定します。
  4. GitLab Duoのデフォルトネームスペースを設定する。
  5. オプション。一貫性を保ち、コストを管理するために、すべてのユーザーがそのモデルを使用するように機能のモデルを選択します。どのモデルが要件に合っているかわからない場合は、適切なモデルを選択するを参照してください。

使用状況を検証する

Duo Agent Platformを大部分のユーザーに展開する前に、少数のユーザーに次の結果を確認するように依頼してください:

  • GitLab UIでAgentic Chatにアクセスして使用できる。
  • IDEでDuo Agent Platformを認証できる。
  • テストのマージリクエストでコードレビューフローを実行できる。
  • サブスクリプションで利用可能なその他の基本フローを実行できる。

これらのユーザーがいくつかのフローを実行した後、クレジット使用状況を確認するためにCreditsダッシュボードも確認する必要があります。

請求

サブスクリプションをDuo ProまたはEnterpriseから使用量課金に変更すると、シートではなくクレジット使用量に基づいて課金されます。

チームのクレジット使用状況を追跡するおよび使用上限を設定するには、Creditsダッシュボードを使用してください。

移行中の一般的な問題

インスタンスを最初にDuo Agent Platformに移行する際、次の問題が発生する可能性があります。

イシュー考えられる原因解決策
UIにフローが表示されないGitLab Duoまたはフローの実行が有効になっていないか、グループにフローを使用する権限がないか、フローがプロジェクトレベルで有効になっていません。UIにフローが表示されない
Runnerがジョブをピックアップしないため、フローが実行されないRunnerにgitlab--duoタグがないか、Runnerがフロー用に設定されていません。Runnerを設定する
セッションがcreated状態のまま止まっているプッシュルールがサービスアカウントをブロックします。コミット作成者メールまたはduo/feature/ブランチプレフィックスが許可されていません。サービスアカウントを許可するプッシュルールを設定
Error in creating workload: Insufficient permissions to create a new pipeline基本フローサービスアカウントは、インポートされた、またはテンプレート化されたプロジェクトが存在する前に設定されました。インポートされたプロジェクトの新しいパイプラインを作成する権限が不足しています
基本フローはオンになっているが何も実行しないサービスアカウントが作成されていないか、グループメンバーシップのロックによってプロジェクトへの追加が妨げられています。基本フローサービスアカウントが作成されていません、およびグループメンバーシップがロックされています
Duo Agent Platformがオフ、またはSomething went wrong while requesting a review from GitLab Duoユーザーが複数のGitLab Duoネームスペースに属しており、デフォルトネームスペースが設定されていません。デフォルトGitLab Duoネームスペースが設定されていません
Your request was valid but Workflow failed to complete itリポジトリにコミットがないため、フローがデフォルトブランチを見つけられません。エラー: リクエストは有効でしたが、ワークフローが完了できませんでした
SSL certificate OpenSSL verify result: unable to get local issuer certificate (20)カスタムまたは自己署名CAを使用するGitLab Self-Managedでは、サンドボックスの強化により、git clone中のRunnerのCAインジェクションがブロックされます。エラー: SSL証明書OpenSSL検証結果
GitLab Duoのすべての機能が、移行直後にすべてのユーザーで失敗するサイレントモードがオンになっており、GitLabがAIゲートウェイにアクセスできないようにしています。サイレントモードをオフにする
ヘルスチェックネットワークテストが失敗するか、移行後にGitLab Duo機能が利用できないcloud.gitlab.com、customers.gitlab.com、またはduo-workflow-svc.runway.gitlab.netへの送信HTTPSがファイアウォールまたはプロキシによってブロックされています。GitLabインスタンスからGitLab Duoへの送信接続を許可する
Duo Agent Platform機能が移行直後にすべてのユーザーで利用できない使用量課金規約が承認されていないか、プールに利用可能なクレジットがありません。オンデマンドGitLabクレジット