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

トリガー

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

フロー設定ファイルの場所を変更するには、機能フラグを有効にする必要があります。詳細については、履歴を参照してください。

トリガーは、フローまたは外部エージェントをいつ実行するかを決定します。カスタムエージェントまたは基本エージェントに対してトリガーを作成することはできません。

たとえば、ディスカッションでフローのサービスアカウントユーザーにメンションしたとき、またはそのサービスアカウントユーザーをレビュアーとして割り当てたときに、フローがトリガーされるよう指定できます。

トリガーを作成する

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。

前提条件:

  • プロジェクトのメンテナーまたはオーナーロールが必要です。

トリガーを作成するには:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、AI > トリガーを選択します。
  3. 新しいフロートリガーを選択します。
  4. 説明に、トリガーの説明を入力します。
  5. 条件セクションで、トリガーを開始する各条件に対して、次のようにします:
    1. 条件を追加を選択し、次にイベント発生時を選択します。
    2. イベントドロップダウンリストから、トリガーイベントタイプを選択します。
    3. イベントタイプに設定が必要な場合は、実行条件ドロップダウンリストから1つ以上のトリガーイベントアクションを選択します。
    4. イベントを追加を選択します。
  6. サービスアカウントドロップダウンリストから、複合アイデンティティとなるユーザーを選択します。
  7. 設定ソースで、次のいずれかを選択します:
    • AIカタログ: このプロジェクト用に設定されているフローの中から、トリガーで実行するフローを選択します。
    • 設定パス: フロー設定ファイルのパスを入力します（例: .gitlab/duo/flows/claude.yaml）。このオプションを表示するには、ai_catalog_create_third_party_flowsフラグを有効にする必要があります。
  8. フロートリガーを作成を選択します。

作成したトリガーが、AI > トリガーに表示されるようになります。

トリガーイベントタイプ

名前説明構成
メンションイシューまたはマージリクエストのコメントでサービスアカウントユーザーがメンションされたとき。なし
割り当てサービスアカウントユーザーがイシューまたはマージリクエストに割り当てられたとき。なし
レビュアーの割り当てサービスアカウントユーザーがレビュアーとしてマージリクエストに割り当てられたとき。なし
パイプラインイベントパイプラインのステータスが変更されたとき。実行条件ドロップダウンリストから、以下の1つ以上を選択します:
- 実行中
- 成功
- 失敗
- キャンセル済み
マージリクエスト選択したマージリクエストアクションが発生したとき。実行条件ドロップダウンリストから、以下のいずれかを選択します:
- 承認済み: マージリクエストにすべての必須承認がある場合。
- 作成日: 誰かがドラフトまたは準備完了のマージリクエストを作成し、GitLabがその差分を生成した場合。GitLabは、マージリクエストがマージトレインに参加している場合、またはGitLabが差分を再読み込みできない場合を除き、フローが実行される前にその差分に対してコードオーナー承認ルールを同期します。
- 準備完了としてマーク済み: ドラフトマージリクエストがレビューの準備完了としてマークされたとき。
- マージ競合: コードコンフリクトにより、マージリクエストをマージできなくなったとき。
作業アイテム選択した作業アイテムアクションが発生したとき。実行条件ドロップダウンリストから、以下のいずれかを選択します:
- 作成日: 作業アイテムが作成された場合
- ステータス変更: 作業アイテムのステータスが変更された場合。ステータス変更が唯一選択されたアクションである場合、作業アイテムがいずれかのステータスに変更されたときにのみフローを実行するように、1つ以上のステータスを選択できます。

トリガーを編集する

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、AI > トリガーを選択します。
  3. 変更したいトリガーで、その他の操作（ ellipsis_v ）> トリガーを編集を選択します。
  4. 変更を加えて、変更を保存を選択します。

カスタムフローのトリガーは、その設定ページのトリガー条件の下で編集することもできます。

トリガーのオン/オフを切り替える

トリガーをオフにすると、無効になり、その設定が保持されます。トリガーをオフにすると、設定されたアクションの後に自動実行を停止し、トリガーのリストに残ります。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、AI > トリガーを選択します。
  3. オンまたはオフにしたいトリガーで、右側の切替を選択します。

カスタムフローのトリガーは、その設定ページのトリガー条件の下でオンまたはオフにすることもできます。

トリガーを削除する

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、AI > トリガーを選択します。
  3. 削除したいトリガーで、その他の操作（ ellipsis_v ）> トリガーを削除を選択します。
  4. 確認ダイアログで、OKを選択します。

カスタムフローのトリガーは、その設定ページのトリガー条件の下で削除することもできます。

トリガーを開始しないアクション

すべてのトリガーイベントタイプは、人間ユーザーがトリガーアクションを実行する必要があります。ボットユーザー、サービスアカウントユーザー、または別のフローのような非人間ユーザーは、トリガーをアクティブ化できません。

この制限は、すべてのトリガーイベントタイプに適用されます。たとえば、フローはコメントでサービスアカウントに言及することで、別のフローをトリガーすることはできません。