트리거는 흐름 또는 외부 에이전트가 언제 실행되는지 결정합니다. 커스텀 에이전트나 기본 에이전트에 대한 트리거는 생성할 수 없습니다.

예를 들어 토론에서 언급될 때 또는 검토자로 할당될 때 실행되도록 흐름을 지정할 수 있습니다.

트리거 만들기#

사전 요구 사항:

• 프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

트리거를 만들려면 다음 단계를 수행합니다.

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
3. 새 흐름 트리거를 선택합니다.
4. 설명에 트리거에 대한 설명을 입력합니다.
5. 조건 섹션에서 트리거를 시작해야 하는 각 조건에 대해 다음을 수행합니다.
   1. 조건 추가를 선택한 다음 이벤트 발생 시를 선택합니다.
   2. 이벤트 드롭다운 목록에서 트리거 이벤트 유형을 선택합니다.
   3. 이벤트 유형에 구성이 필요한 경우, 실행 시점 드롭다운 목록에서 하나 이상의 트리거 이벤트 액션을 선택합니다.
   4. 이벤트 추가를 선택합니다.
6. 서비스 계정 드롭다운 목록에서 복합 ID가 될 사용자를 선택합니다.
7. 구성 소스에서 다음 중 하나를 선택합니다.
   • AI 카탈로그: 이 프로젝트에 구성된 흐름 중에서 트리거가 실행할 흐름을 선택합니다.
   • 구성 경로: 흐름 구성 파일의 경로를 입력합니다 (예: .gitlab/duo/flows/claude.yaml). 이 옵션을 보려면 ai_catalog_create_third_party_flows 플래그가 활성화되어 있어야 합니다.
8. 선택 사항. 이벤트에 고유한 지침을 지정하려면 조건 섹션에서 해당 이벤트의 Edit event(✏️)를 선택합니다. Goal 필드에 텍스트를 입력한 다음 Save를 선택합니다. 자세한 내용은 목표 추가를 참고합니다.
9. 흐름 트리거 만들기를 선택합니다.

이제 트리거가 AI > 트리거에 표시됩니다.

트리거 이벤트 유형#

목표 추가#

목표는 흐름이 무엇을 해야 하는지 알려 주는 텍스트입니다. 해당 이벤트에 대해 흐름이 특정 작업을 수행하도록 하려면 조건에 목표를 추가합니다. 두 트리거 이벤트가 같은 흐름을 서로 다른 목표로 실행할 수 있습니다.

사전 요구 사항:

• 프로젝트의 Maintainer 또는 Owner 권한이 있어야 합니다.
• 트리거가 목표를 받는 흐름을 사용해야 합니다. 커스텀 흐름과 외부 에이전트는 목표를 받으며, 구성 경로를 사용하는 트리거도 목표를 받습니다. 코드 리뷰 같은 기본 흐름은 목표를 받지 않습니다.

기존 트리거의 조건에 목표를 추가하려면 다음과 같이 합니다:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
3. 변경하려는 트리거에서 More actions(⋮) > Edit trigger를 선택합니다.
4. 조건 섹션에서 변경하려는 조건의 Edit event(✏️)를 선택합니다.
5. Goal 필드에 목표를 입력합니다. 4096자 이하로 입력합니다.
6. Save를 선택합니다.
7. 변경 사항 저장을 선택합니다.

목표는 조건 섹션의 해당 조건 아래에 표시됩니다.

목표는 트리거 전체가 아니라 하나의 조건에 속합니다. 머지 리퀘스트 이벤트에서는 하나의 목표가 실행 시점에서 선택한 모든 액션에 적용됩니다.

트리거를 만들 때나 흐름을 사용하도록 설정할 때도 목표를 추가할 수 있습니다. 트리거 양식에서 Goal 필드는 구성 소스를 설정하기 전까지 표시되지 않습니다. AI 카탈로그를 선택하면 목표를 받는 흐름도 선택해야 합니다.

목표 작성#

목표는 이벤트가 제공하는 정보 앞에 놓입니다. 목표가 그 정보를 대체하지는 않습니다. 그 정보를 목표에서 반복하지 않습니다.

흐름은 다음도 받습니다:

• 언급 이벤트의 경우, 사용자가 작성한 댓글.
• 그 밖의 모든 이벤트의 경우, 짧은 컨텍스트 블록. 이 블록은 머지 리퀘스트, 작업 항목 또는 프로젝트의 웹 주소를 알려 줍니다. 또한 발생한 액션도 알려 줍니다.

원하는 결과를 얻을 수 있는 목표를 작성하려면 다음을 따릅니다:

• 흐름에 명확한 작업 하나를 부여합니다.
• 리소스를 지정하지 않습니다. 컨텍스트 블록이 이미 리소스를 알려 줍니다.
• 흐름에 필요한 모든 세부 정보를 제공합니다. 흐름은 추가 정보를 요청할 수 없습니다.
• 출력이 어떤 모습이어야 하는지 설명합니다. 예를 들어 형식이나 최대 길이를 지정합니다.
• 서비스 계정에 권한이 있는 작업만 요청합니다.

다음 표는 목표 예시를 보여 줍니다.

트리거 편집#

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
3. 변경하려는 트리거에서 More actions(⋮) > Edit trigger를 선택합니다.
4. 변경 사항을 적용하고 변경 사항 저장을 선택합니다.

커스텀 흐름의 구성 페이지에서 Trigger conditions 아래에서도 해당 흐름의 트리거를 편집할 수 있습니다.

트리거 켜기 또는 끄기#

트리거를 꺼서 비활성화하면 구성은 그대로 유지됩니다. 트리거를 끄면 구성된 액션에 따라 자동으로 실행되지 않으며, 트리거 목록에는 계속 남아 있습니다.

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
3. 켜거나 끄려는 트리거에서 오른쪽의 토글을 선택합니다.

커스텀 흐름의 구성 페이지에서 Trigger conditions 아래에서도 해당 흐름의 트리거를 켜거나 끌 수 있습니다.

트리거 삭제#

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
3. 삭제하려는 트리거에서 More actions(⋮) > Delete trigger를 선택합니다.
4. 확인 대화 상자에서 확인을 선택합니다.

커스텀 흐름의 구성 페이지에서 Trigger conditions 아래에서도 해당 흐름의 트리거를 삭제할 수 있습니다.

트리거를 시작하지 않는 액션#

모든 트리거 이벤트 유형은 사람 사용자가 트리거 동작을 수행해야 합니다. 봇 사용자, 서비스 계정 사용자, 다른 흐름과 같은 비인간 사용자는 트리거를 활성화할 수 없습니다.

이 제한은 모든 트리거 이벤트 유형에 적용됩니다. 예를 들어 흐름은 코멘트에서 서비스 계정을 언급하는 방식으로 다른 흐름을 트리거할 수 없습니다.

트리거된 플로의 GitLab Credits 소비#

트리거로 시작된 플로는 트리거의 서비스 계정으로 실행되며, 이에 따라 서비스 계정이 플로의 GitLab Credits 소비에 대한 과금 대상이 됩니다. 트리거 동작을 수행한 사람 사용자는 플로가 실행되기 위한 위임된 인가 컨텍스트를 제공하지만 과금 대상은 아닙니다.

서비스 계정은 비인간 주체이며 포함 크레딧을 받지 않습니다. 이들의 소비는 네임스페이스에서 월간 커밋 풀과 온디맨드 크레딧으로 청구됩니다. 이러한 크레딧 유형에 대한 자세한 내용은 GitLab Credits를 참고합니다.

예를 들어 트리거가 머지 리퀘스트에 필요한 승인을 모두 받으면 플로를 실행하도록 설정되어 있고, 해당 머지 리퀘스트에 승인이 세 번 필요하다고 가정합니다. 세 번째 승인자가 머지 리퀘스트를 승인하면 트리거가 구성된 서비스 계정으로 플로를 실행하며, 크레딧 소비는 세 번째 승인자가 아니라 서비스 계정에 귀속됩니다.

이 귀속은 모든 트리거 이벤트 유형에 적용됩니다. 예를 들어 파이프라인 상태 변경, 작업 항목 상태 변경, 언급으로 트리거된 플로에도 적용됩니다.

GitLab Credits 대시보드에서 이 크레딧 소비는 Usage by user 탭에 Automated flow 배지가 붙은 서비스 계정 행으로 표시됩니다. 트리거한 사람 사용자 아래에는 표시되지 않습니다.