트리거
GitLab v19.2Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
흐름 구성 파일의 위치를 변경하려면 기능 플래그를 활성화해야 합니다. 트리거는 플로우 또는 외부 에이전트가 언제 실행되는지 결정합니다. 예를 들어 토론에서 언급될 때 또는 검토자로 할당될 때 실행되도록 흐름을 지정할 수 있습니다.
히스토리
흐름 구성 파일의 위치를 변경하려면 기능 플래그를 활성화해야 합니다. 자세한 내용은 기록을 참조하세요.
트리거는 플로우 또는 외부 에이전트가 언제 실행되는지 결정합니다. 커스텀 에이전트나 기본 에이전트에 대한 트리거는 생성할 수 없습니다.
예를 들어 토론에서 언급될 때 또는 검토자로 할당될 때 실행되도록 흐름을 지정할 수 있습니다.
트리거 만들기#
히스토리
- 할당 및 검토자 할당 이벤트 유형이 GitLab 18.5에서 도입되었습니다.
- 파이프라인 이벤트 트리거 이벤트 유형이 GitLab 18.9에서
ai_flow_trigger_pipeline_hooks라는 플래그와 함께 실험으로 도입되었습니다. 기본적으로 비활성화되어 있습니다. - 머지 리퀘스트 준비 완료 트리거 이벤트 유형이 GitLab 19.0에서
merge_request_ready_flow_trigger라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - 머지 리퀘스트 코드 충돌 트리거 이벤트 유형이 GitLab 19.1에서 도입되었습니다.
- Approved 액션이 있는 머지 리퀘스트 트리거 이벤트 유형이 GitLab 19.1에서 도입되었습니다.
- 기능 플래그
ai_flow_trigger_pipeline_hooks가 GitLab 19.1에서 제거되었습니다. - 작업 항목 생성됨 트리거 이벤트 유형이 GitLab 19.1에서 도입되었습니다.
- 머지 리퀘스트 준비 완료 트리거 이벤트 유형이 GitLab 19.1에서 일반 출시되었습니다. 기능 플래그
merge_request_ready_flow_trigger가 제거되었습니다. - 작업 항목 상태 변경됨 트리거 이벤트 유형이 GitLab 19.2에서 도입되었습니다.
- 머지 리퀘스트 준비 완료 및 머지 리퀘스트 코드 충돌 이벤트 유형이 GitLab 19.2에서 머지 리퀘스트 이벤트 유형의 준비 완료로 표시됨 및 머지 충돌 액션으로 통합되었습니다.
이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 내용은 기록을 참조하세요.
전제 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
트리거를 만들려면:
- 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
- 새 흐름 트리거를 선택합니다.
- 설명에 트리거에 대한 설명을 입력합니다.
- 이벤트 유형 드롭다운 목록에서 다음을 선택합니다:
- 하나 이상의 트리거 이벤트 유형.
- 트리거 이벤트 유형에 필요한 경우, 트리거 이벤트 액션.
- 서비스 계정 드롭다운 목록에서 복합 ID가 될 사용자를 선택합니다.
- 구성 소스에서 다음 중 하나를 선택합니다:
- AI 카탈로그: 이 프로젝트에 구성된 흐름 중에서 트리거가 실행할 흐름을 선택합니다.
- 구성 경로: 흐름 구성 파일의 경로를 입력합니다(예:
.gitlab/duo/flows/claude.yaml). 이 옵션을 보려면ai_catalog_create_third_party_flows플래그가 활성화되어 있어야 합니다.
- 흐름 트리거 만들기를 선택합니다.
이제 트리거가 AI > 트리거에 표시됩니다.
트리거 이벤트 유형#
| 이름 | 설명 | 구성 |
|---|---|---|
| 언급 | 서비스 계정 사용자가 이슈 또는 머지 리퀘스트의 코멘트에서 언급될 때. | 없음 |
| 할당 | 서비스 계정 사용자가 이슈 또는 머지 리퀘스트에 할당될 때. | 없음 |
| 검토자 할당 | 서비스 계정 사용자가 머지 리퀘스트에 검토자로 할당될 때. | 없음 |
| 파이프라인 이벤트 | 파이프라인의 상태가 변경될 때. | 트리거 시점 드롭다운 목록에서 다음 중 하나 이상을 선택: - 실행 중 - 통과 - 실패 - 취소됨 |
| 머지 리퀘스트 | 선택한 머지 리퀘스트 액션이 발생할 때. | 트리거 시점 드롭다운 목록에서 다음 중 하나를 선택: - Approved: 머지 리퀘스트에 필요한 모든 승인이 있을 때 - 준비 완료로 표시됨: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때 - 머지 충돌: 코드 충돌로 인해 머지 리퀘스트를 더 이상 머지할 수 없을 때 |
| 작업 항목 | 선택한 작업 항목 액션이 발생할 때. | 트리거 시점 드롭다운 목록에서 다음 중 하나를 선택: - 생성됨: 작업 항목이 생성될 때 - 상태 변경됨: 작업 항목의 상태가 변경될 때 |
트리거 편집#
- 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
- 변경하려는 트리거에서 흐름 트리거 편집(✏️)을 선택합니다.
- 변경 사항을 만들고 변경 사항 저장을 선택합니다.
트리거 삭제#
- 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 AI > 트리거를 선택합니다.
- 변경하려는 트리거에서 흐름 트리거 삭제([remove])를 선택합니다.
- 확인 대화 상자에서 확인을 선택합니다.