InfoGrab DocsInfoGrab Docs

자동화

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자동화는 플로 또는 외부 에이전트가 언제 실행되는지 결정합니다. 같은 플로를 이벤트와 일정으로 모두 실행하려면 자동화를 두 개 만듭니다. 프로젝트의 자동화를 보려면 다음과 같이 합니다.

히스토리
  • GitLab 18.3에서 실험으로 ai_flow_triggers라는 기능 플래그와 함께 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 18.8에서 일반 공급되었습니다.
  • 기능 플래그 ai_flow_triggers가 GitLab 19.1에서 제거되었습니다.
  • GitLab 19.6에서 트리거에서 자동화로 이름이 변경되었으며, duo_automations라는 플래그와 함께 제공됩니다. 기본적으로 활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

자동화는 플로 또는 외부 에이전트가 언제 실행되는지 결정합니다. 커스텀 에이전트나 기반 에이전트에 대한 자동화는 만들 수 없습니다.

자동화는 두 종류 중 하나입니다.

  • 이벤트 기반 자동화는 서비스 계정이 언급되거나 파이프라인이 실패하는 등 프로젝트에서 어떤 일이 발생할 때 플로를 실행합니다.
  • 예약 자동화는 평일 오전 9:00처럼 반복되는 시각에 플로를 실행합니다.
항목 이벤트 기반 자동화 예약 자동화
실행을 시작하는 주체 언급이나 승인처럼 사람이 수행한 동작 일정입니다. 실행을 시작하는 사람은 없습니다.
플로가 실행되는 계정 복합 ID가 적용된 플로의 서비스 계정 복합 ID가 없는 전용 서비스 계정
플로가 받는 정보 언급의 경우 코멘트. 다른 이벤트의 경우 머지 리퀘스트, 작업 항목 또는 프로젝트의 웹 주소 프로젝트의 웹 주소

같은 플로를 이벤트와 일정으로 모두 실행하려면 자동화를 두 개 만듭니다.

자동화 보기#

히스토리
  • GitLab 19.6에서 Developer 권한이 트리거를 볼 수 있도록 변경되었습니다.

사전 요구 사항:

  • 프로젝트에 대해 최소한 Developer 권한이 있어야 합니다.

프로젝트의 자동화를 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.

이벤트 기반 자동화#

이벤트 기반 자동화는 서비스 계정이 검토자로 할당될 때처럼 조건 중 하나가 발생하면 플로를 실행합니다. 자동화에는 이벤트 조건을 여러 개 지정할 수 있습니다.

이벤트 기반 자동화 만들기#

히스토리
  • Configuration path 옵션이 GitLab 18.9에서 ai_catalog_create_third_party_flows라는 플래그를 요구하도록 변경되었습니다. 기본적으로 비활성화되어 있습니다.
  • Merge request ready 및 Merge request code conflict 이벤트 유형이 GitLab 19.2에서 Merge request 이벤트 유형의 Marked ready 및 Merge conflict 액션으로 통합되었습니다.
  • 트리거 생성 양식이 GitLab 19.3에서 조건을 하나씩 추가하도록 변경되었습니다.
Feature flag

Configuration path 옵션의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

사전 요구 사항:

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

자동화를 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. New automation을 선택합니다.
  4. Name에 자동화의 이름을 입력합니다.
  5. Runs with 드롭다운 목록에서 다음 중 하나를 선택합니다.
    • 프로젝트에서 사용하도록 설정된 플로 또는 외부 에이전트. Developer Flow를 사용하도록 설정했다면 기본으로 선택됩니다.
    • Configuration file. 그런 다음 Configuration path에 플로 구성 파일의 경로를 입력합니다 (예: .gitlab/duo/flows/claude.yaml). Service account 드롭다운 목록에서 복합 ID가 될 사용자를 선택합니다. 이 옵션을 보려면 ai_catalog_create_third_party_flows 플래그가 활성화되어 있어야 합니다.
  6. Instructions 필드가 표시되면 플로가 수행해야 할 작업을 입력합니다. Developer Flow에서는 지침이 필수입니다. 자세한 내용은 지침 추가를 참고합니다.
  7. Runs when에서 일정이 열려 있으면 Cancel을 선택합니다. 플로를 일정에 따라 실행할 수 있는 경우 새 자동화는 일정으로 시작합니다.
  8. 자동화를 시작해야 하는 각 이벤트에 대해 다음을 수행합니다.
    1. Add trigger > On an event를 선택합니다.
    2. Select an event 드롭다운 목록에서 이벤트 유형을 선택합니다.
    3. 이벤트 유형에 액션이 있으면 Run when 드롭다운 목록에서 하나 이상의 액션을 선택합니다.
    4. Add event를 선택합니다.
  9. Create를 선택합니다.

이제 자동화가 AI > Automations에 표시됩니다.

이벤트 유형#

이름 설명 구성 도입 버전
Mention 서비스 계정 사용자가 이슈 또는 머지 리퀘스트의 코멘트에서 언급될 때입니다. 없음 GitLab 18.3
Assign 서비스 계정 사용자가 이슈 또는 머지 리퀘스트에 할당될 때입니다. 없음 GitLab 18.5
Assign reviewer 서비스 계정 사용자가 머지 리퀘스트에 검토자로 할당될 때입니다. 없음 GitLab 18.5
Pipeline events 파이프라인의 상태가 변경될 때입니다. Run when 드롭다운 목록에서 다음 중 하나 이상을 선택합니다.
- Running
- Passed
- Failed
- Canceled
GitLab 18.9에서 실험으로 도입. GitLab 19.1에서 일반 공급.
Merge request 선택한 머지 리퀘스트 액션이 발생할 때입니다. Run when 드롭다운 목록에서 다음 중 하나를 선택합니다.
- Approved: 머지 리퀘스트에 필요한 모든 승인이 있을 때입니다. GitLab 19.1에서 도입되었습니다.
- Created: 드래프트 또는 준비 완료 상태의 머지 리퀘스트를 생성하고 GitLab이 해당 diff를 생성할 때입니다. 머지 리퀘스트가 머지 트레인에 합류하거나 GitLab이 diff를 다시 로드할 수 없는 경우가 아니면, GitLab은 플로가 실행되기 전에 해당 diff를 기준으로 코드 소유자 승인 규칙을 동기화합니다. GitLab 19.4에서 도입되었습니다.
- Marked ready: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때입니다. GitLab 19.0에서 도입되었습니다.
- Merge conflict: 코드 충돌로 인해 머지 리퀘스트를 더 이상 머지할 수 없을 때입니다. GitLab 19.1에서 도입되었습니다.
- Merged: 머지 리퀘스트가 머지될 때입니다. Developer Flow 세션이 해당 머지 리퀘스트를 만들었거나 그 위에서 실행된 경우에만 플로가 실행됩니다. Developer Flow를 실행하는 자동화는 이 액션에서 세션을 시작하지 않습니다. 플로가 대신 동작하는 사용자에 대해서는 자동화를 시작하지 않는 동작을 참고합니다. GitLab 19.6에서 도입되었습니다.
GitLab 19.1
Work item 선택한 작업 항목 액션이 발생할 때입니다. Run when 드롭다운 목록에서 다음 중 하나를 선택합니다.
- Created: 작업 항목이 생성될 때입니다. GitLab 19.1에서 도입되었습니다.
- Status changed: 작업 항목의 상태가 변경될 때입니다. Status changed가 선택된 유일한 액션이면 하나 이상의 상태를 선택하여, 작업 항목이 그중 하나로 변경될 때만 플로를 실행할 수 있습니다. GitLab 19.2에서 도입되었습니다. 상태 선택은 GitLab 19.5에서 도입되었습니다.

두 액션 모두 Type 드롭다운 목록에서 작업 항목 유형을 선택하여 해당 유형에 대해서만 플로를 실행할 수 있습니다. 유형을 선택하면 Status 드롭다운 목록에는 해당 유형의 상태만 표시됩니다. 선택한 유형이 선택된 상태를 사용하지 않으면 목록은 그 상태를 별도 그룹으로 표시하므로 선택을 해제할 수 있습니다. 유형을 선택하지 않은 경우에는 어떤 유형도 사용하지 않는 상태에 같은 내용이 적용됩니다. 유형 선택은 GitLab 19.6에서 도입되었습니다.
GitLab 19.1

작업 항목 유형 ID#

GraphQL API에서 aiFlowTriggerCreate 및 aiFlowTriggerUpdate 뮤테이션의 filter 인수는 work_item_type_id 규칙으로 작업 항목 유형 필터를 설정합니다. 이 규칙은 in 연산자를 사용하면 나열된 유형에 대해서만 플로를 실행하고, not_in 연산자를 사용하면 그 외의 모든 유형에 대해 플로를 실행합니다. 값은 작업 항목 유형 ID의 목록입니다. ID는 5와 같은 정수입니다. GitLab은 "5" 같은 문자열을 거부합니다. 예를 들어 다음 필터는 작업이 In dev 상태로 변경될 때만 플로를 실행합니다.

{
  "work_item": {
    "rules": [
      { "field": "action", "operator": "in", "value": ["status_changed"] },
      { "field": "status.name", "operator": "in", "value": ["In dev"] },
      { "field": "work_item_type_id", "operator": "in", "value": [5] }
    ]
  }
}

기본 작업 항목 유형은 모든 GitLab 인스턴스에서 ID가 같습니다.

작업 항목 유형 ID
Issue 1
Incident 2
Test Case 3
Requirement 4
Task 5
Objective 6
Key Result 7
Epic 8
Ticket 9

커스텀 작업 항목 유형은 다른 ID를 가집니다. 유형의 ID를 찾으려면 프로젝트의 workItemTypes 필드를 쿼리합니다. ID는 유형의 id 끝에 있는 숫자입니다.

자동화 양식은 in 규칙만 표시하고 변경합니다. not_in 규칙의 경우 Type 드롭다운 목록에 Any type이 표시되며 양식은 해당 규칙을 유지합니다. 양식에서 유형을 변경하면 양식이 not_in 규칙을 대체합니다.

기반 플로의 자동화#

자동화는 해당 기반 플로가 그룹 또는 프로젝트에서 켜져 있을 때만 실행됩니다. 자세한 내용은 기반 플로 켜기 또는 끄기를 참고합니다.

기반 플로는 다음과 같은 방식으로 시작할 수 있습니다.

  • 플로를 켤 때 GitLab이 추가하는 기본 자동화.
  • 플로가 지원하는 이벤트에 대해 사용자가 만든 자동화.
  • 보안 스캔이 끝날 때처럼 다른 방식. 이러한 플로는 자동화를 사용하지 않으므로 AI > Automations에 나열되지 않습니다.

각 플로를 시작하는 방법에 대한 자세한 내용은 개별 기반 플로 문서를 참고합니다.

세션이 끝날 때 작업 항목 변경#

히스토리
  • GitLab 19.6에서 dap_software_factory 및 ai_flow_trigger_chaining이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

자동화는 해당 자동화가 시작한 세션이 끝난 뒤 작업 항목을 변경할 수 있습니다. 사람의 개입 없이 작업 항목을 프로세스의 다음 단계로 옮길 때 사용합니다.

다음 설정 중 하나 또는 둘 다 지정할 수 있습니다.

  • Set work item status: GitLab이 작업 항목을 이 상태로 설정합니다.
  • Mark merge requests as ready: GitLab이 세션이 만든 드래프트 머지 리퀘스트를 준비 완료로 표시합니다. 자동 리뷰가 켜져 있으면 GitLab이 이어서 GitLab Duo Code Review를 검토자로 추가합니다.

둘 다 설정하면 GitLab이 먼저 머지 리퀘스트를 준비 완료로 표시합니다. 머지 리퀘스트가 드래프트로 남아 있으면 GitLab은 상태를 설정하지 않습니다.

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  • 자동화에 Status changed만 액션으로 선택한 Work item 조건이 있어야 하며, 상태가 하나 이상 있어야 합니다. 조건이 이 요구 사항을 충족할 때까지 설정을 사용할 수 없습니다.

세션이 끝날 때 작업 항목을 변경하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 변경하려는 자동화에서 More actions(⋮) > Edit automation을 선택합니다.
  4. Conditions 섹션에서 Work item 조건의 Edit event(✏️)를 선택합니다.
  5. Run when 드롭다운 목록에서 Status changed만 선택합니다.
  6. Status 드롭다운 목록에서 상태를 하나 이상 선택한 다음 Save를 선택합니다.
  7. When the session finishes에서 둘 중 하나 또는 둘 다 설정합니다.
    • Set work item status 드롭다운 목록에서 상태를 선택합니다.
    • Mark merge requests as ready 확인란을 선택합니다.
  8. Save changes를 선택합니다.

나중에 Created 액션을 추가하거나, 마지막 상태를 제거하거나, Work item 조건을 제거하면 GitLab이 설정을 지웁니다. Set work item status의 상태를 가지지 않는 유형으로 유형을 변경하면 GitLab이 해당 상태를 지웁니다.

GitLab이 설정을 적용하는 시점#

GitLab은 다음 조건이 모두 참일 때만 설정을 적용합니다.

  • 세션의 상태가 finished입니다. 중지된 세션, 실패한 세션 또는 입력을 기다리는 세션은 아무것도 변경하지 않습니다.
  • 자동화가 켜져 있습니다.
  • 작업 항목 이벤트가 세션을 시작했습니다.
  • 사람 사용자가 이 세션 또는 체인의 첫 세션을 다음 방식 중 하나로 시작했습니다.
    • Mention, Assign 또는 Work item 이벤트로 시작
    • GitLab Duo Agentic Chat 세션처럼 GitLab Duo 에이전트가 있는 세션에서 시작. 예를 들어 사용자가 슬래시 명령으로 플로를 트리거합니다.
  • 작업 항목이 여전히 자동화의 상태 중 하나입니다. 세션이 실행되는 동안 상태가 자동화가 실행되지 않는 상태로 바뀌면 GitLab은 아무것도 변경하지 않습니다. 플로가 자체 작업 항목의 상태를 설정하는 경우에도 마찬가지입니다.
  • 세션의 서비스 계정이 복합 ID를 적용합니다.
  • 서비스 계정과 세션을 시작한 사용자가 모두 작업 항목과 머지 리퀘스트를 업데이트할 수 있습니다.

GitLab은 작업 항목 유형에 없는 상태를 설정하지 않습니다.

자동화 체인#

GitLab은 세션의 복합 ID로 변경 사항을 기록합니다. 이 때문에 GitLab은 상태 변경을 플로가 일으킨 이벤트로 취급합니다. 상태 변경은 새 상태에서 실행되는 다른 자동화를 시작할 수 있습니다. 끝난 세션은 체인 깊이 및 너비 제한 안에서 다음 세션의 부모가 됩니다.

Warning

상태가 순환을 이루는 자동화는 구성하지 않습니다. 예를 들어 자동화 A는 상태 X에서 실행되어 상태 Y를 설정하고, 자동화 B는 상태 Y에서 실행되어 상태 X를 설정하는 경우입니다. 체인 제한이 순환을 멈추지만, 순환 안의 각 세션은 여전히 실행됩니다.

두 단계 사이에 사람의 결정을 두려면 어떤 자동화도 실행되지 않는 상태, 예를 들어 Plan ready로 상태를 설정합니다. 그러면 사용자가 작업 항목을 다음 단계를 시작하는 상태로 옮깁니다.

다음 표는 사람의 개입 없이 작업 항목을 세 가지 상태로 옮기는 두 자동화를 보여 줍니다.

자동화 다음 상태로 변경될 때 실행 플로 Set work item status Mark merge requests as ready
A Planning Generate Workplan Ready for development 아니요
B Ready for development GitLab Duo Developer In review 예

알려진 문제#

  • 세션이 작업을 마치지 않은 채 끝날 수 있습니다. 예를 들어 GitLab Duo Developer가 코드 변경이 필요하지 않다고 판단하고 머지 리퀘스트를 열지 않을 수 있습니다. 이 경우에도 GitLab은 상태를 설정합니다. 플로가 일찍 멈출 수 있다면 실패 또는 입력 대기 상태로 끝나도록 만듭니다. 그러면 GitLab이 상태를 설정하지 않습니다.
  • 자동화가 설정하는 상태가 자동화가 실행되는 상태 중 하나이기도 하면, 변경이 자동화를 다시 시작할 수 있습니다. 양식은 이 구성에 대해 경고를 표시합니다.

자동화를 시작하지 않는 동작#

모든 이벤트 유형은 트리거하는 동작을 사람 사용자가 수행해야 합니다. 봇 사용자, 서비스 계정 사용자 또는 다른 플로 같은 사람이 아닌 사용자는 자동화를 활성화할 수 없습니다.

이 제한은 모든 이벤트 유형에 적용됩니다. 예를 들어 플로는 코멘트에서 서비스 계정을 언급해 다른 플로를 트리거할 수 없습니다. 자동화 설정에서 일어나는 상태 변경은 예외입니다. 자세한 내용은 자동화 체인을 참고합니다.

Merge request 이벤트 유형의 Merged 액션도 예외입니다. 자동화는 머지하는 사용자가 아니라 머지 리퀘스트의 작성자를 확인합니다. 플로가 만든 머지 리퀘스트의 작성자는 복합 ID의 사람 사용자입니다. 예를 들면 다음과 같습니다.

  • 봇 사용자 또는 서비스 계정 사용자가 사람 사용자가 작성한 머지 리퀘스트를 머지하면 자동화가 실행됩니다.
  • 플로가 머지 리퀘스트를 머지하면, 사람 사용자가 작성했더라도 자동화가 실행되지 않습니다.
  • 사람이 아닌 사용자가 머지 리퀘스트를 작성했다면 자동화가 실행되지 않습니다.

Work item 이벤트 유형과 Created 액션이 있는 자동화는 다음의 경우에도 실행되지 않습니다.

  • 작업 항목을 다른 GitLab 인스턴스 또는 GitHub나 Jira 같은 다른 도구에서 가져온 경우.
  • 작업 항목이 Service Desk로 보낸 이메일에서 생성된 경우.

예약 자동화#

히스토리
  • GitLab 19.4에서 베타로 ai_flow_schedules 및 autonomous_service_account_execution이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • 예약 자동화를 끄는 설정이 GitLab 19.6에서 도입되었습니다.
  • 실험 및 베타 기능 요구 사항이 GitLab 19.6에서 추가되었습니다.
  • GitLab 19.6에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 활성화되었습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

예약 자동화는 반복되는 시각에 플로를 실행합니다. 오래된 이슈의 주간 요약처럼 이벤트에서 시작하지 않는 작업에 예약 자동화를 사용합니다. 플로는 머지 리퀘스트나 작업 항목을 받지 않으므로, 지침으로 각 실행에서 플로가 할 일을 알려 줍니다.

Disclaimer

이 페이지에는 개발 중인 제품, 기능에 대한 정보가 포함되어 있습니다. 이 정보는 참고 목적으로만 제공되며, 구매 또는 계획 시 이 정보에 의존하지 마십시오.

예약 자동화에는 다음과 같은 제한이 있습니다.

  • 예약 자동화에는 일정이 하나 있습니다.
  • 예약 자동화는 그룹이 아닌 프로젝트에서만 만들 수 있습니다.
  • 기본적으로 프로젝트는 예약 자동화를 최대 100개까지 가질 수 있습니다.

예약 자동화용 서비스 계정#

예약 자동화를 만들면 GitLab이 해당 자동화 전용 서비스 계정을 만듭니다. 계정 이름은 Duo Scheduled로 시작하고, 이어서 프로젝트 경로와 자동화 설명이 붙습니다. GitLab은 플로의 서비스 계정과 같은 권한으로 이 계정을 프로젝트에 추가합니다. GitLab은 이 계정에 Owner 권한을 부여하지 않으며, 계정이 Owner 권한을 가지면 실행이 실패합니다.

예약 실행은 복합 ID를 사용하지 않으므로, 서비스 계정의 권한이 플로가 할 수 있는 일을 제한하는 유일한 요소입니다. GitLab은 자동화를 만드는 프로젝트에 서비스 계정을 추가합니다. 예약 실행은 누군가 서비스 계정을 다른 프로젝트에도 추가한 경우에만 그 프로젝트에 접근할 수 있습니다. 자세한 내용은 GitLab Duo Agent Platform의 보안 위협을 참고합니다.

계정의 권한은 플로의 서비스 계정 권한을 따릅니다.

  • 각 실행 전에 플로 계정의 권한이 더 낮으면 GitLab은 자동화 계정의 권한을 그에 맞게 낮춥니다. GitLab이 권한을 낮출 수 없으면 실행이 실패합니다.
  • 플로 계정의 권한이 더 높으면, 해당 권한을 부여할 수 있는 사람이 자동화를 편집할 때만 GitLab이 자동화 계정의 권한을 높입니다.

예약 자동화 만들기#

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  • 프로젝트에 대한 권한이 플로의 서비스 계정 권한과 같거나 더 높아야 합니다.
  • 서비스 계정을 만들 수 있는 권한과 프로젝트에 멤버를 추가할 수 있는 권한이 있어야 합니다.
  • 프로젝트가 그룹에 속해야 하며, 그룹이 프로젝트에 멤버 추가를 막지 않아야 합니다.
  • 실험 및 베타 기능이 켜져 있어야 합니다.
  • 프로젝트, 그룹 또는 인스턴스에 대해 예약 자동화가 켜져 있어야 합니다.
  • AI 카탈로그의 커스텀 플로 또는 Developer Flow가 프로젝트에서 사용하도록 설정되어 있어야 합니다. 다른 기반 플로, 외부 에이전트, 구성 파일을 사용하는 플로는 일정에 따라 실행할 수 없습니다.

기존 예약 자동화의 플로를 변경하려면 다음이 필요합니다.

  • 프로젝트에 대한 권한이 자동화의 서비스 계정 권한과 같거나 더 높아야 합니다.
  • 프로젝트에 멤버를 추가할 수 있는 권한이 있어야 합니다.
  • 새 플로가 AI 카탈로그의 커스텀 플로 또는 Developer Flow여야 합니다.

일정, 이름 또는 지침을 변경할 때는 이러한 권한이 필요하지 않습니다.

예약 자동화를 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.

  3. New automation을 선택합니다.

  4. Name에 자동화의 이름을 입력합니다.

  5. Runs with 드롭다운 목록에서 플로를 선택합니다.

  6. Instructions 필드가 표시되면 플로가 각 실행에서 수행해야 할 작업을 입력합니다. Developer Flow에서는 지침이 필수입니다.

  7. Runs when에서 새 자동화는 요일과 시각이 이미 선택된 주간 일정으로 시작합니다. 열려 있는 일정이 없으면 Add trigger > On a schedule을 선택합니다.

  8. 빈도 드롭다운 목록에서 플로를 얼마나 자주 실행할지 선택합니다. 빈도에 따라 플로를 실행할 시점을 선택합니다.

    빈도 선택할 항목
    Every 15 minutes 없음
    Every 30 minutes 없음
    Hourly 정각 이후의 분.
    Daily 시와 분.
    Weekdays 월요일부터 금요일까지의 시와 분.
    Weekly 요일, 시, 분.
    Monthly 1일부터 28일까지의 일, 그리고 시와 분.

    시는 24시간제를 사용합니다. 분은 15분 단위입니다.

  9. 선택 사항. 15분 또는 30분 간격이 아닌 빈도에서 시간대를 변경하려면 Change를 선택한 다음 시간대를 선택합니다. 기본값은 프로필의 시간대이며, 프로필에 없으면 브라우저의 시간대입니다.

  10. Add schedule을 선택합니다.

  11. Create를 선택합니다.

GitLab이 부하를 분산하기 위해 예약 실행을 분산하므로 플로가 예약 시각보다 몇 분 늦게 실행될 수 있습니다.

예약 실행이 실패하는 경우#

예약 실행이 실패하면 GitLab은 프로젝트의 Owner 또는 Maintainer 권한을 가진 사용자에게 이메일을 보냅니다. 프로젝트에 이러한 권한을 가진 사용자가 없으면 그룹의 Owner 또는 Maintainer 권한을 가진 사용자에게 이메일을 보냅니다. 예를 들어 서비스 계정이 프로젝트에 없거나, 비활성 상태이거나, Owner 권한을 가지고 있거나, GitLab이 플로에 맞게 낮출 수 없는 권한을 가진 경우 실행이 실패합니다.

연속으로 세 번 실패하면 GitLab은 일정을 비활성화하고 실패 이메일 대신 비활성화 이메일을 보냅니다. 실행에 성공하면 횟수가 초기화됩니다.

다음의 경우 GitLab은 예약 실행을 건너뛰며 실패로 세지 않습니다.

  • 자동화가 꺼져 있습니다.
  • 그룹 또는 인스턴스에 대해 실험 및 베타 기능이 꺼져 있습니다.
  • 프로젝트, 그룹 또는 인스턴스에 대해 예약 자동화가 꺼져 있습니다.
  • 플로 실행이 꺼져 있습니다.
  • 네임스페이스에 남은 GitLab Credits가 없습니다.
  • 프로젝트가 보관되었거나 삭제 예정입니다.

비활성화된 일정을 다시 시작하려면 이메일에 안내된 원인을 해결한 다음 aiFlowScheduleUpdate GraphQL 뮤테이션으로 active를 true로 설정합니다. 일정의 ID를 가져오려면 자동화의 flowSchedules 필드를 쿼리합니다. 재활성화해도 실패 횟수는 초기화되지 않으므로, 한 번 더 실패하면 일정이 다시 비활성화됩니다. 자동화 토글은 일정을 다시 활성화하지 않습니다. GitLab이 일정을 비활성화한 뒤에도 자동화는 켜진 상태로 남지만 플로는 실행되지 않습니다.

예약 자동화 켜기 또는 끄기#

예약 자동화는 기본적으로 켜져 있습니다. 예약 자동화를 끄면 기존 일정은 실행을 멈추지만 GitLab이 보관합니다. 진행 중인 실행은 계속됩니다. 예약 자동화가 꺼져 있는 동안에는 자동화에 일정을 추가할 수 없습니다. 예약 자동화를 다시 켜면 일정은 다음 예약 시각부터 재개됩니다. GitLab은 건너뛴 실행을 보충하지 않습니다.

예약 자동화를 켜거나 끄려면 플로 실행이 켜져 있어야 합니다. 그룹 또는 인스턴스에 대해 예약 자동화가 꺼져 있으면 하위 그룹과 프로젝트는 이를 켤 수 없습니다.

사전 요구 사항:

  • 최상위 그룹의 경우 그룹에 대한 Owner 권한.
  • 프로젝트의 경우 프로젝트에 대한 Maintainer 또는 Owner 권한.

최상위 그룹에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Flow execution에서 Allow scheduled automations 확인란을 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

이 설정은 그룹의 하위 그룹과 프로젝트에 적용됩니다.

프로젝트에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo를 확장합니다.
  4. Allow scheduled automations 토글을 켜거나 끕니다.
  5. Save changes를 선택합니다.

사전 요구 사항:

  • 인스턴스의 경우 관리자 액세스.
  • 그룹의 경우 그룹에 대한 Owner 권한.
  • 프로젝트의 경우 프로젝트에 대한 Maintainer 또는 Owner 권한.

인스턴스에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Flow execution에서 Allow scheduled automations 확인란을 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

그룹에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo features를 확장합니다.
  4. Flow execution에서 Allow scheduled automations 확인란을 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

이 설정은 그룹의 하위 그룹과 프로젝트에 적용됩니다.

프로젝트에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo를 확장합니다.
  4. Allow scheduled automations 토글을 켜거나 끕니다.
  5. Save changes를 선택합니다.

지침 추가#

히스토리
  • 각 조건의 지침이 GitLab 19.5에서 ai_flow_trigger_goals라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.7에서 일반 공급됩니다. 기능 플래그 ai_flow_trigger_goals가 제거되었습니다.

지침은 자동화가 실행될 때 플로가 무엇을 해야 하는지 알려 주는 텍스트입니다. 자동화에는 지침이 한 세트 있으며, 이 지침은 자동화의 모든 이벤트와 일정에 적용됩니다. 같은 플로를 다른 지침으로 실행하려면 다른 자동화를 만듭니다.

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  • 자동화가 커스텀 플로, 외부 에이전트, Developer Flow 또는 구성 파일을 실행해야 합니다. 다른 플로에서는 Instructions 필드가 나타나지 않습니다. Developer Flow에서는 지침이 필수입니다.

기존 자동화에 지침을 추가하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 변경하려는 자동화에서 More actions(⋮) > Edit automation을 선택합니다.
  4. Instructions 필드에 지침을 입력합니다. 4096자 이하로 입력합니다.
  5. Save changes를 선택합니다.

이벤트 기반 자동화를 만들 때, 예약 자동화를 만들 때 또는 플로를 사용하도록 설정할 때도 지침을 추가할 수 있습니다.

지침 작성#

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

플로는 다음 정보도 받습니다.

  • 언급 이벤트의 경우 사람이 작성한 코멘트.
  • 그 외 모든 이벤트의 경우 짧은 컨텍스트 블록. 이 블록은 머지 리퀘스트, 작업 항목 또는 프로젝트의 웹 주소를 제공하며, 발생한 액션도 제공합니다.
  • 일정의 경우 프로젝트의 웹 주소가 담긴 컨텍스트 블록.
Warning

플로는 서비스 계정의 권한으로 실행됩니다. 플로의 질문에 답할 사람이 없습니다. 플로가 혼자 완료할 수 있도록 지침을 작성합니다.

원하는 결과를 얻는 지침을 작성하려면 다음과 같이 합니다.

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

다음 표는 지침의 예를 보여 줍니다.

조건 지침
Mention Answer the question in a comment. Keep the reply under 200 words.
Merge request, Created 액션 Review the code changes and list any missing tests in a comment.
Work item, Created 액션 Add a severity label and a test plan.
Schedule, Weekly List the open issues with no activity in the last 30 days in a new issue.

자동화 편집#

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 변경하려는 자동화에서 More actions(⋮) > Edit automation을 선택합니다.
  4. 변경한 다음 Save changes를 선택합니다.

커스텀 플로의 구성 페이지에서 Trigger conditions 아래에서도 해당 플로의 자동화를 편집할 수 있습니다.

자동화 켜기 또는 끄기#

히스토리
  • GitLab 19.4에서 도입되었습니다.

자동화를 끄면 비활성화되며 구성은 유지됩니다. 자동화를 끄면 구성된 액션 뒤에 자동으로 실행되지 않으며, 자동화 목록에는 그대로 남습니다.

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 켜거나 끄려는 자동화의 오른쪽에서 토글을 선택합니다.

커스텀 플로의 구성 페이지에서 Trigger conditions 아래에서도 해당 플로의 자동화를 켜거나 끌 수 있습니다.

자동화 삭제#

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 삭제하려는 자동화에서 More actions(⋮) > Delete automation을 선택합니다.
  4. 확인 대화 상자에서 OK를 선택합니다.

커스텀 플로의 구성 페이지에서 Trigger conditions 아래에서도 해당 플로의 자동화를 삭제할 수 있습니다.

트리거된 플로의 GitLab Credits 사용량#

자동화가 시작한 플로는 서비스 계정으로 실행됩니다. 플로의 사용량은 트리거하는 동작을 수행한 사용자가 아니라 네임스페이스에 청구됩니다.

예를 들어 머지 리퀘스트가 필요한 승인을 모두 받으면 자동화가 플로를 실행하고, 해당 머지 리퀘스트에 승인이 세 개 필요하다고 가정합니다. 세 번째 승인자가 머지 리퀘스트를 승인하면 자동화는 구성된 서비스 계정으로 플로를 실행하고, 사용량은 세 번째 승인자가 아니라 네임스페이스에 청구됩니다.

이 청구 방식은 파이프라인 상태 변경, 작업 항목 상태 변경, 언급, 일정을 포함한 모든 이벤트 유형에 적용됩니다.

자세한 내용은 크레딧 사용량의 청구 대상을 참고합니다.

문제 해결#

오류: Event types contains event types not supported#

기반 플로의 자동화를 만들거나 편집할 때 다음 오류가 발생할 수 있습니다.

Event types contains event types not supported by this foundational flow

자동화에 플로가 받아들이지 않는 이벤트 유형이 포함되어 있습니다. 이 오류를 해결하려면 플로의 문서에서 지원하는 이벤트를 확인한 다음 다음 중 하나를 수행합니다.

  • 플로가 자동화를 사용하면 자동화를 편집하여 플로가 지원하지 않는 이벤트를 제거합니다. 예를 들어 Fix CI/CD Pipeline은 Pipeline events만 받아들입니다.
  • 플로가 다른 방식으로 시작되면 플로에 자동화가 필요 없으므로 자동화를 삭제합니다. 예를 들어 SAST False Positive Detection은 보안 스캔 후에 실행됩니다.

서비스 계정에 No triggers for this event가 표시됨#

서비스 계정을 머지 리퀘스트에 할당하거나 서비스 계정에 리뷰를 요청할 때 서비스 계정이 No triggers for this event 메시지와 함께 비활성화될 수 있습니다. 언급 자동 완성에서는 Mention 이벤트에 대한 자동화가 없는 서비스 계정은 표시되지 않습니다. 각 경우에 프로젝트에는 해당 서비스 계정과 이벤트에 대한 자동화가 없습니다.

  • 담당자 메뉴에는 Assign이 필요합니다.
  • 검토자 메뉴에는 Assign reviewer가 필요합니다.
  • 언급 자동 완성에는 Mention이 필요합니다.

이 문제를 해결하려면 다음과 같이 합니다.

  1. 프로젝트에서 AI > Automations를 선택합니다.
  2. 서비스 계정과 원하는 이벤트를 사용하는 자동화가 있는지 확인합니다.
  3. 플로의 문서에서 플로가 해당 이벤트를 지원하는지 확인합니다.
  4. 플로가 이벤트를 지원하면 해당 이벤트를 포함하도록 자동화를 만들거나 편집합니다. 지원하지 않으면 플로의 문서에 설명된 방법을 사용합니다.

자동화에 저장할 수 있는 이벤트가 반드시 플로가 실행할 수 있는 이벤트는 아닙니다. 예를 들어 Developer는 Pipeline events에서 실행할 수 없습니다. 서비스 계정을 선택할 수 있게 하려는 목적으로만 이벤트를 추가하지 말고 지원되는 이벤트를 사용합니다.

오류: Event types cannot combine autonomous event types#

일정과 이벤트가 모두 있는 자동화를 저장할 때 다음 오류가 발생할 수 있습니다.

Event types cannot combine autonomous event types (scheduled) with other event types. Create a separate automation for them.

일정이 있는 자동화에는 이벤트 조건을 둘 수 없으며, 둘 중 하나를 제거하기 전에는 자동화를 저장할 수 없습니다. 이 오류를 해결하려면 이벤트를 제거하고 해당 이벤트용 자동화를 별도로 만듭니다.

경고: Flow enabled without an automation#

플로를 사용하도록 설정하면서 동시에 일정을 추가하면 GitLab이 자동화 없이 플로를 사용하도록 설정하고 다음 경고를 표시할 수 있습니다.

The scheduled automation was not created. <reason>

이 경고는 GitLab이 예약 자동화용 서비스 계정을 만들 수 없을 때 발생합니다. 플로는 여전히 켜져 있지만 일정이 없습니다.

경고 메시지의 <reason>이 원인을 설명합니다.

일반적인 원인은 다음과 같습니다.

  • 프로젝트에서 서비스 계정을 만들거나 프로젝트에 멤버를 추가할 권한이 없습니다.
  • 프로젝트의 그룹이 프로젝트에 멤버가 추가되는 것을 막고 있습니다.
  • 플로의 서비스 계정이 Owner 권한이거나 사용자가 부여할 수 있는 것보다 높은 권한을 가지고 있습니다.

이 경고를 해결하려면 경고 메시지에 나온 원인을 해결한 다음 플로의 예약 자동화를 다시 만듭니다.

전체 요구 사항 목록은 예약 자동화 만들기의 사전 요구 사항을 참고합니다.

예약 실행 결과 조사#

사전 요구 사항:

  • 인스턴스 로그에 접근할 수 있어야 합니다.

Ai::RunFlowScheduleWorker는 완료하는 모든 예약 실행에 대해 한 줄을 기록합니다. 일정 UI에 설명할 수 없는 결과가 표시되거나, 실행이 세션을 전혀 만들지 않았을 때 이 줄을 사용합니다.

이 줄을 읽는 위치는 제공 방식에 따라 다릅니다.

이 줄에는 다음 필드가 포함됩니다.

필드 설명
outcome succeeded, skipped 또는 failed.
outcome_reason 실행이 그렇게 끝난 이유. succeeded에는 설정되지 않습니다.
error_message 해당 메시지로, 1024자로 잘립니다. 실패의 경우 일정의 마지막 실행에 있는 error이기도 합니다.
flow_schedule_id 일정. GitLab이 일정을 로드할 수 없는 경우에도 설정됩니다.
flow_trigger_id 일정이 속한 자동화.
gl_project_id, gl_root_namespace_id 프로젝트와 최상위 그룹.
duo_workflow_id 실행이 만든 세션. 실행이 세션을 만든 뒤 시작하지 못해 실패한 경우에도 설정됩니다. 실행이 세션을 만들기 전에 끝난 경우에는 설정되지 않습니다.
consecutive_failure_count, deactivated 실패의 경우 새 횟수와 임곗값을 넘었는지 여부.

GitLab이 건너뛰며 실패로 세지 않는 실행은 다음 이유를 사용합니다.

outcome_reason 의미
schedule_not_found, flow_trigger_not_found 실행이 대기열에 들어간 뒤 일정 또는 해당 자동화가 삭제되었습니다.
schedule_inactive 실행이 대기열에 들어간 뒤 일정이 꺼졌습니다.
trigger_inactive, trigger_not_scheduled 자동화가 꺼졌거나 더 이상 일정에 따라 실행되지 않습니다.
scheduled_automations_disabled, flow_execution_disabled 프로젝트에 대해 예약 자동화 또는 플로 실행이 꺼져 있습니다.
schedules_feature_flag_disabled 프로젝트에 대해 플로 일정이 활성화되어 있지 않습니다.
beta_features_unavailable 인스턴스 또는 그룹에 대해 실험 및 베타 기능이 꺼져 있습니다.
project_archived, project_pending_deletion, project_not_found 프로젝트가 플로를 실행할 수 없습니다.
next_run_in_future 실행이 예정 시각보다 먼저 대기열에 들어갔습니다.
usage_quota_exceeded 네임스페이스에 남은 GitLab Credits가 없습니다.
flow_disabled_by_feature_flag, non_human_trigger_not_permitted 플로가 실행을 거부했습니다.

실패한 실행은 일정을 비활성화하는 연속 세 번 실패에 포함됩니다. GitLab은 다음 이유를 지정합니다.

outcome_reason 의미
unsupported_target 플로가 일정 실행을 지원하지 않습니다.
excess_service_account_access 서비스 계정이 플로보다 많은 액세스 권한을 가지고 있으며 GitLab이 이를 낮출 수 없었습니다.
unexpected_error 실행에서 예외가 발생했습니다. 예외는 Sentry에도 있습니다.
run_service_error 플로가 이유를 지정하지 않은 사유로 실행이 세션을 만들기 전에 실패했습니다.

플로가 자체 이유를 지정하면 GitLab은 그 이유를 대신 기록합니다. 일반적인 값은 플로에 일정용 목표 템플릿이 없을 때의 unsupported_event, 자동화가 일정과 다른 이벤트 유형을 함께 사용할 때의 autonomous_trigger_source_not_permitted, 기반 플로가 실행을 거부했을 때의 run_not_eligible입니다. 자세한 내용은 같은 줄의 error_message를 읽습니다.

예정된 일정이 처리되었는지 확인하려면 대신 워커의 Sidekiq 작업을 찾습니다. sidekiq.log를 json.class: "Ai::RunFlowScheduleWorker"로 필터링한 다음 json.correlation_id를 결과 줄과 대조합니다.

자동화

GitLab v19.6
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자동화는 플로 또는 외부 에이전트가 언제 실행되는지 결정합니다. 같은 플로를 이벤트와 일정으로 모두 실행하려면 자동화를 두 개 만듭니다. 프로젝트의 자동화를 보려면 다음과 같이 합니다.

히스토리
  • GitLab 18.3에서 실험으로 ai_flow_triggers라는 기능 플래그와 함께 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 18.8에서 일반 공급되었습니다.
  • 기능 플래그 ai_flow_triggers가 GitLab 19.1에서 제거되었습니다.
  • GitLab 19.6에서 트리거에서 자동화로 이름이 변경되었으며, duo_automations라는 플래그와 함께 제공됩니다. 기본적으로 활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

자동화는 플로 또는 외부 에이전트가 언제 실행되는지 결정합니다. 커스텀 에이전트나 기반 에이전트에 대한 자동화는 만들 수 없습니다.

자동화는 두 종류 중 하나입니다.

  • 이벤트 기반 자동화는 서비스 계정이 언급되거나 파이프라인이 실패하는 등 프로젝트에서 어떤 일이 발생할 때 플로를 실행합니다.
  • 예약 자동화는 평일 오전 9:00처럼 반복되는 시각에 플로를 실행합니다.
항목 이벤트 기반 자동화 예약 자동화
실행을 시작하는 주체 언급이나 승인처럼 사람이 수행한 동작 일정입니다. 실행을 시작하는 사람은 없습니다.
플로가 실행되는 계정 복합 ID가 적용된 플로의 서비스 계정 복합 ID가 없는 전용 서비스 계정
플로가 받는 정보 언급의 경우 코멘트. 다른 이벤트의 경우 머지 리퀘스트, 작업 항목 또는 프로젝트의 웹 주소 프로젝트의 웹 주소

같은 플로를 이벤트와 일정으로 모두 실행하려면 자동화를 두 개 만듭니다.

자동화 보기#

히스토리
  • GitLab 19.6에서 Developer 권한이 트리거를 볼 수 있도록 변경되었습니다.

사전 요구 사항:

  • 프로젝트에 대해 최소한 Developer 권한이 있어야 합니다.

프로젝트의 자동화를 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.

이벤트 기반 자동화#

이벤트 기반 자동화는 서비스 계정이 검토자로 할당될 때처럼 조건 중 하나가 발생하면 플로를 실행합니다. 자동화에는 이벤트 조건을 여러 개 지정할 수 있습니다.

이벤트 기반 자동화 만들기#

히스토리
  • Configuration path 옵션이 GitLab 18.9에서 ai_catalog_create_third_party_flows라는 플래그를 요구하도록 변경되었습니다. 기본적으로 비활성화되어 있습니다.
  • Merge request ready 및 Merge request code conflict 이벤트 유형이 GitLab 19.2에서 Merge request 이벤트 유형의 Marked ready 및 Merge conflict 액션으로 통합되었습니다.
  • 트리거 생성 양식이 GitLab 19.3에서 조건을 하나씩 추가하도록 변경되었습니다.
Feature flag

Configuration path 옵션의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

사전 요구 사항:

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

자동화를 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. New automation을 선택합니다.
  4. Name에 자동화의 이름을 입력합니다.
  5. Runs with 드롭다운 목록에서 다음 중 하나를 선택합니다.
    • 프로젝트에서 사용하도록 설정된 플로 또는 외부 에이전트. Developer Flow를 사용하도록 설정했다면 기본으로 선택됩니다.
    • Configuration file. 그런 다음 Configuration path에 플로 구성 파일의 경로를 입력합니다 (예: .gitlab/duo/flows/claude.yaml). Service account 드롭다운 목록에서 복합 ID가 될 사용자를 선택합니다. 이 옵션을 보려면 ai_catalog_create_third_party_flows 플래그가 활성화되어 있어야 합니다.
  6. Instructions 필드가 표시되면 플로가 수행해야 할 작업을 입력합니다. Developer Flow에서는 지침이 필수입니다. 자세한 내용은 지침 추가를 참고합니다.
  7. Runs when에서 일정이 열려 있으면 Cancel을 선택합니다. 플로를 일정에 따라 실행할 수 있는 경우 새 자동화는 일정으로 시작합니다.
  8. 자동화를 시작해야 하는 각 이벤트에 대해 다음을 수행합니다.
    1. Add trigger > On an event를 선택합니다.
    2. Select an event 드롭다운 목록에서 이벤트 유형을 선택합니다.
    3. 이벤트 유형에 액션이 있으면 Run when 드롭다운 목록에서 하나 이상의 액션을 선택합니다.
    4. Add event를 선택합니다.
  9. Create를 선택합니다.

이제 자동화가 AI > Automations에 표시됩니다.

이벤트 유형#

이름 설명 구성 도입 버전
Mention 서비스 계정 사용자가 이슈 또는 머지 리퀘스트의 코멘트에서 언급될 때입니다. 없음 GitLab 18.3
Assign 서비스 계정 사용자가 이슈 또는 머지 리퀘스트에 할당될 때입니다. 없음 GitLab 18.5
Assign reviewer 서비스 계정 사용자가 머지 리퀘스트에 검토자로 할당될 때입니다. 없음 GitLab 18.5
Pipeline events 파이프라인의 상태가 변경될 때입니다. Run when 드롭다운 목록에서 다음 중 하나 이상을 선택합니다.
- Running
- Passed
- Failed
- Canceled
GitLab 18.9에서 실험으로 도입. GitLab 19.1에서 일반 공급.
Merge request 선택한 머지 리퀘스트 액션이 발생할 때입니다. Run when 드롭다운 목록에서 다음 중 하나를 선택합니다.
- Approved: 머지 리퀘스트에 필요한 모든 승인이 있을 때입니다. GitLab 19.1에서 도입되었습니다.
- Created: 드래프트 또는 준비 완료 상태의 머지 리퀘스트를 생성하고 GitLab이 해당 diff를 생성할 때입니다. 머지 리퀘스트가 머지 트레인에 합류하거나 GitLab이 diff를 다시 로드할 수 없는 경우가 아니면, GitLab은 플로가 실행되기 전에 해당 diff를 기준으로 코드 소유자 승인 규칙을 동기화합니다. GitLab 19.4에서 도입되었습니다.
- Marked ready: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때입니다. GitLab 19.0에서 도입되었습니다.
- Merge conflict: 코드 충돌로 인해 머지 리퀘스트를 더 이상 머지할 수 없을 때입니다. GitLab 19.1에서 도입되었습니다.
- Merged: 머지 리퀘스트가 머지될 때입니다. Developer Flow 세션이 해당 머지 리퀘스트를 만들었거나 그 위에서 실행된 경우에만 플로가 실행됩니다. Developer Flow를 실행하는 자동화는 이 액션에서 세션을 시작하지 않습니다. 플로가 대신 동작하는 사용자에 대해서는 자동화를 시작하지 않는 동작을 참고합니다. GitLab 19.6에서 도입되었습니다.
GitLab 19.1
Work item 선택한 작업 항목 액션이 발생할 때입니다. Run when 드롭다운 목록에서 다음 중 하나를 선택합니다.
- Created: 작업 항목이 생성될 때입니다. GitLab 19.1에서 도입되었습니다.
- Status changed: 작업 항목의 상태가 변경될 때입니다. Status changed가 선택된 유일한 액션이면 하나 이상의 상태를 선택하여, 작업 항목이 그중 하나로 변경될 때만 플로를 실행할 수 있습니다. GitLab 19.2에서 도입되었습니다. 상태 선택은 GitLab 19.5에서 도입되었습니다.

두 액션 모두 Type 드롭다운 목록에서 작업 항목 유형을 선택하여 해당 유형에 대해서만 플로를 실행할 수 있습니다. 유형을 선택하면 Status 드롭다운 목록에는 해당 유형의 상태만 표시됩니다. 선택한 유형이 선택된 상태를 사용하지 않으면 목록은 그 상태를 별도 그룹으로 표시하므로 선택을 해제할 수 있습니다. 유형을 선택하지 않은 경우에는 어떤 유형도 사용하지 않는 상태에 같은 내용이 적용됩니다. 유형 선택은 GitLab 19.6에서 도입되었습니다.
GitLab 19.1

작업 항목 유형 ID#

GraphQL API에서 aiFlowTriggerCreate 및 aiFlowTriggerUpdate 뮤테이션의 filter 인수는 work_item_type_id 규칙으로 작업 항목 유형 필터를 설정합니다. 이 규칙은 in 연산자를 사용하면 나열된 유형에 대해서만 플로를 실행하고, not_in 연산자를 사용하면 그 외의 모든 유형에 대해 플로를 실행합니다. 값은 작업 항목 유형 ID의 목록입니다. ID는 5와 같은 정수입니다. GitLab은 "5" 같은 문자열을 거부합니다. 예를 들어 다음 필터는 작업이 In dev 상태로 변경될 때만 플로를 실행합니다.

{
  "work_item": {
    "rules": [
      { "field": "action", "operator": "in", "value": ["status_changed"] },
      { "field": "status.name", "operator": "in", "value": ["In dev"] },
      { "field": "work_item_type_id", "operator": "in", "value": [5] }
    ]
  }
}

기본 작업 항목 유형은 모든 GitLab 인스턴스에서 ID가 같습니다.

작업 항목 유형 ID
Issue 1
Incident 2
Test Case 3
Requirement 4
Task 5
Objective 6
Key Result 7
Epic 8
Ticket 9

커스텀 작업 항목 유형은 다른 ID를 가집니다. 유형의 ID를 찾으려면 프로젝트의 workItemTypes 필드를 쿼리합니다. ID는 유형의 id 끝에 있는 숫자입니다.

자동화 양식은 in 규칙만 표시하고 변경합니다. not_in 규칙의 경우 Type 드롭다운 목록에 Any type이 표시되며 양식은 해당 규칙을 유지합니다. 양식에서 유형을 변경하면 양식이 not_in 규칙을 대체합니다.

기반 플로의 자동화#

자동화는 해당 기반 플로가 그룹 또는 프로젝트에서 켜져 있을 때만 실행됩니다. 자세한 내용은 기반 플로 켜기 또는 끄기를 참고합니다.

기반 플로는 다음과 같은 방식으로 시작할 수 있습니다.

  • 플로를 켤 때 GitLab이 추가하는 기본 자동화.
  • 플로가 지원하는 이벤트에 대해 사용자가 만든 자동화.
  • 보안 스캔이 끝날 때처럼 다른 방식. 이러한 플로는 자동화를 사용하지 않으므로 AI > Automations에 나열되지 않습니다.

각 플로를 시작하는 방법에 대한 자세한 내용은 개별 기반 플로 문서를 참고합니다.

세션이 끝날 때 작업 항목 변경#

히스토리
  • GitLab 19.6에서 dap_software_factory 및 ai_flow_trigger_chaining이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

자동화는 해당 자동화가 시작한 세션이 끝난 뒤 작업 항목을 변경할 수 있습니다. 사람의 개입 없이 작업 항목을 프로세스의 다음 단계로 옮길 때 사용합니다.

다음 설정 중 하나 또는 둘 다 지정할 수 있습니다.

  • Set work item status: GitLab이 작업 항목을 이 상태로 설정합니다.
  • Mark merge requests as ready: GitLab이 세션이 만든 드래프트 머지 리퀘스트를 준비 완료로 표시합니다. 자동 리뷰가 켜져 있으면 GitLab이 이어서 GitLab Duo Code Review를 검토자로 추가합니다.

둘 다 설정하면 GitLab이 먼저 머지 리퀘스트를 준비 완료로 표시합니다. 머지 리퀘스트가 드래프트로 남아 있으면 GitLab은 상태를 설정하지 않습니다.

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  • 자동화에 Status changed만 액션으로 선택한 Work item 조건이 있어야 하며, 상태가 하나 이상 있어야 합니다. 조건이 이 요구 사항을 충족할 때까지 설정을 사용할 수 없습니다.

세션이 끝날 때 작업 항목을 변경하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 변경하려는 자동화에서 More actions(⋮) > Edit automation을 선택합니다.
  4. Conditions 섹션에서 Work item 조건의 Edit event(✏️)를 선택합니다.
  5. Run when 드롭다운 목록에서 Status changed만 선택합니다.
  6. Status 드롭다운 목록에서 상태를 하나 이상 선택한 다음 Save를 선택합니다.
  7. When the session finishes에서 둘 중 하나 또는 둘 다 설정합니다.
    • Set work item status 드롭다운 목록에서 상태를 선택합니다.
    • Mark merge requests as ready 확인란을 선택합니다.
  8. Save changes를 선택합니다.

나중에 Created 액션을 추가하거나, 마지막 상태를 제거하거나, Work item 조건을 제거하면 GitLab이 설정을 지웁니다. Set work item status의 상태를 가지지 않는 유형으로 유형을 변경하면 GitLab이 해당 상태를 지웁니다.

GitLab이 설정을 적용하는 시점#

GitLab은 다음 조건이 모두 참일 때만 설정을 적용합니다.

  • 세션의 상태가 finished입니다. 중지된 세션, 실패한 세션 또는 입력을 기다리는 세션은 아무것도 변경하지 않습니다.
  • 자동화가 켜져 있습니다.
  • 작업 항목 이벤트가 세션을 시작했습니다.
  • 사람 사용자가 이 세션 또는 체인의 첫 세션을 다음 방식 중 하나로 시작했습니다.
    • Mention, Assign 또는 Work item 이벤트로 시작
    • GitLab Duo Agentic Chat 세션처럼 GitLab Duo 에이전트가 있는 세션에서 시작. 예를 들어 사용자가 슬래시 명령으로 플로를 트리거합니다.
  • 작업 항목이 여전히 자동화의 상태 중 하나입니다. 세션이 실행되는 동안 상태가 자동화가 실행되지 않는 상태로 바뀌면 GitLab은 아무것도 변경하지 않습니다. 플로가 자체 작업 항목의 상태를 설정하는 경우에도 마찬가지입니다.
  • 세션의 서비스 계정이 복합 ID를 적용합니다.
  • 서비스 계정과 세션을 시작한 사용자가 모두 작업 항목과 머지 리퀘스트를 업데이트할 수 있습니다.

GitLab은 작업 항목 유형에 없는 상태를 설정하지 않습니다.

자동화 체인#

GitLab은 세션의 복합 ID로 변경 사항을 기록합니다. 이 때문에 GitLab은 상태 변경을 플로가 일으킨 이벤트로 취급합니다. 상태 변경은 새 상태에서 실행되는 다른 자동화를 시작할 수 있습니다. 끝난 세션은 체인 깊이 및 너비 제한 안에서 다음 세션의 부모가 됩니다.

Warning

상태가 순환을 이루는 자동화는 구성하지 않습니다. 예를 들어 자동화 A는 상태 X에서 실행되어 상태 Y를 설정하고, 자동화 B는 상태 Y에서 실행되어 상태 X를 설정하는 경우입니다. 체인 제한이 순환을 멈추지만, 순환 안의 각 세션은 여전히 실행됩니다.

두 단계 사이에 사람의 결정을 두려면 어떤 자동화도 실행되지 않는 상태, 예를 들어 Plan ready로 상태를 설정합니다. 그러면 사용자가 작업 항목을 다음 단계를 시작하는 상태로 옮깁니다.

다음 표는 사람의 개입 없이 작업 항목을 세 가지 상태로 옮기는 두 자동화를 보여 줍니다.

자동화 다음 상태로 변경될 때 실행 플로 Set work item status Mark merge requests as ready
A Planning Generate Workplan Ready for development 아니요
B Ready for development GitLab Duo Developer In review 예

알려진 문제#

  • 세션이 작업을 마치지 않은 채 끝날 수 있습니다. 예를 들어 GitLab Duo Developer가 코드 변경이 필요하지 않다고 판단하고 머지 리퀘스트를 열지 않을 수 있습니다. 이 경우에도 GitLab은 상태를 설정합니다. 플로가 일찍 멈출 수 있다면 실패 또는 입력 대기 상태로 끝나도록 만듭니다. 그러면 GitLab이 상태를 설정하지 않습니다.
  • 자동화가 설정하는 상태가 자동화가 실행되는 상태 중 하나이기도 하면, 변경이 자동화를 다시 시작할 수 있습니다. 양식은 이 구성에 대해 경고를 표시합니다.

자동화를 시작하지 않는 동작#

모든 이벤트 유형은 트리거하는 동작을 사람 사용자가 수행해야 합니다. 봇 사용자, 서비스 계정 사용자 또는 다른 플로 같은 사람이 아닌 사용자는 자동화를 활성화할 수 없습니다.

이 제한은 모든 이벤트 유형에 적용됩니다. 예를 들어 플로는 코멘트에서 서비스 계정을 언급해 다른 플로를 트리거할 수 없습니다. 자동화 설정에서 일어나는 상태 변경은 예외입니다. 자세한 내용은 자동화 체인을 참고합니다.

Merge request 이벤트 유형의 Merged 액션도 예외입니다. 자동화는 머지하는 사용자가 아니라 머지 리퀘스트의 작성자를 확인합니다. 플로가 만든 머지 리퀘스트의 작성자는 복합 ID의 사람 사용자입니다. 예를 들면 다음과 같습니다.

  • 봇 사용자 또는 서비스 계정 사용자가 사람 사용자가 작성한 머지 리퀘스트를 머지하면 자동화가 실행됩니다.
  • 플로가 머지 리퀘스트를 머지하면, 사람 사용자가 작성했더라도 자동화가 실행되지 않습니다.
  • 사람이 아닌 사용자가 머지 리퀘스트를 작성했다면 자동화가 실행되지 않습니다.

Work item 이벤트 유형과 Created 액션이 있는 자동화는 다음의 경우에도 실행되지 않습니다.

  • 작업 항목을 다른 GitLab 인스턴스 또는 GitHub나 Jira 같은 다른 도구에서 가져온 경우.
  • 작업 항목이 Service Desk로 보낸 이메일에서 생성된 경우.

예약 자동화#

히스토리
  • GitLab 19.4에서 베타로 ai_flow_schedules 및 autonomous_service_account_execution이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • 예약 자동화를 끄는 설정이 GitLab 19.6에서 도입되었습니다.
  • 실험 및 베타 기능 요구 사항이 GitLab 19.6에서 추가되었습니다.
  • GitLab 19.6에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 활성화되었습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참고합니다.

예약 자동화는 반복되는 시각에 플로를 실행합니다. 오래된 이슈의 주간 요약처럼 이벤트에서 시작하지 않는 작업에 예약 자동화를 사용합니다. 플로는 머지 리퀘스트나 작업 항목을 받지 않으므로, 지침으로 각 실행에서 플로가 할 일을 알려 줍니다.

Disclaimer

이 페이지에는 개발 중인 제품, 기능에 대한 정보가 포함되어 있습니다. 이 정보는 참고 목적으로만 제공되며, 구매 또는 계획 시 이 정보에 의존하지 마십시오.

예약 자동화에는 다음과 같은 제한이 있습니다.

  • 예약 자동화에는 일정이 하나 있습니다.
  • 예약 자동화는 그룹이 아닌 프로젝트에서만 만들 수 있습니다.
  • 기본적으로 프로젝트는 예약 자동화를 최대 100개까지 가질 수 있습니다.

예약 자동화용 서비스 계정#

예약 자동화를 만들면 GitLab이 해당 자동화 전용 서비스 계정을 만듭니다. 계정 이름은 Duo Scheduled로 시작하고, 이어서 프로젝트 경로와 자동화 설명이 붙습니다. GitLab은 플로의 서비스 계정과 같은 권한으로 이 계정을 프로젝트에 추가합니다. GitLab은 이 계정에 Owner 권한을 부여하지 않으며, 계정이 Owner 권한을 가지면 실행이 실패합니다.

예약 실행은 복합 ID를 사용하지 않으므로, 서비스 계정의 권한이 플로가 할 수 있는 일을 제한하는 유일한 요소입니다. GitLab은 자동화를 만드는 프로젝트에 서비스 계정을 추가합니다. 예약 실행은 누군가 서비스 계정을 다른 프로젝트에도 추가한 경우에만 그 프로젝트에 접근할 수 있습니다. 자세한 내용은 GitLab Duo Agent Platform의 보안 위협을 참고합니다.

계정의 권한은 플로의 서비스 계정 권한을 따릅니다.

  • 각 실행 전에 플로 계정의 권한이 더 낮으면 GitLab은 자동화 계정의 권한을 그에 맞게 낮춥니다. GitLab이 권한을 낮출 수 없으면 실행이 실패합니다.
  • 플로 계정의 권한이 더 높으면, 해당 권한을 부여할 수 있는 사람이 자동화를 편집할 때만 GitLab이 자동화 계정의 권한을 높입니다.

예약 자동화 만들기#

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  • 프로젝트에 대한 권한이 플로의 서비스 계정 권한과 같거나 더 높아야 합니다.
  • 서비스 계정을 만들 수 있는 권한과 프로젝트에 멤버를 추가할 수 있는 권한이 있어야 합니다.
  • 프로젝트가 그룹에 속해야 하며, 그룹이 프로젝트에 멤버 추가를 막지 않아야 합니다.
  • 실험 및 베타 기능이 켜져 있어야 합니다.
  • 프로젝트, 그룹 또는 인스턴스에 대해 예약 자동화가 켜져 있어야 합니다.
  • AI 카탈로그의 커스텀 플로 또는 Developer Flow가 프로젝트에서 사용하도록 설정되어 있어야 합니다. 다른 기반 플로, 외부 에이전트, 구성 파일을 사용하는 플로는 일정에 따라 실행할 수 없습니다.

기존 예약 자동화의 플로를 변경하려면 다음이 필요합니다.

  • 프로젝트에 대한 권한이 자동화의 서비스 계정 권한과 같거나 더 높아야 합니다.
  • 프로젝트에 멤버를 추가할 수 있는 권한이 있어야 합니다.
  • 새 플로가 AI 카탈로그의 커스텀 플로 또는 Developer Flow여야 합니다.

일정, 이름 또는 지침을 변경할 때는 이러한 권한이 필요하지 않습니다.

예약 자동화를 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.

  3. New automation을 선택합니다.

  4. Name에 자동화의 이름을 입력합니다.

  5. Runs with 드롭다운 목록에서 플로를 선택합니다.

  6. Instructions 필드가 표시되면 플로가 각 실행에서 수행해야 할 작업을 입력합니다. Developer Flow에서는 지침이 필수입니다.

  7. Runs when에서 새 자동화는 요일과 시각이 이미 선택된 주간 일정으로 시작합니다. 열려 있는 일정이 없으면 Add trigger > On a schedule을 선택합니다.

  8. 빈도 드롭다운 목록에서 플로를 얼마나 자주 실행할지 선택합니다. 빈도에 따라 플로를 실행할 시점을 선택합니다.

    빈도 선택할 항목
    Every 15 minutes 없음
    Every 30 minutes 없음
    Hourly 정각 이후의 분.
    Daily 시와 분.
    Weekdays 월요일부터 금요일까지의 시와 분.
    Weekly 요일, 시, 분.
    Monthly 1일부터 28일까지의 일, 그리고 시와 분.

    시는 24시간제를 사용합니다. 분은 15분 단위입니다.

  9. 선택 사항. 15분 또는 30분 간격이 아닌 빈도에서 시간대를 변경하려면 Change를 선택한 다음 시간대를 선택합니다. 기본값은 프로필의 시간대이며, 프로필에 없으면 브라우저의 시간대입니다.

  10. Add schedule을 선택합니다.

  11. Create를 선택합니다.

GitLab이 부하를 분산하기 위해 예약 실행을 분산하므로 플로가 예약 시각보다 몇 분 늦게 실행될 수 있습니다.

예약 실행이 실패하는 경우#

예약 실행이 실패하면 GitLab은 프로젝트의 Owner 또는 Maintainer 권한을 가진 사용자에게 이메일을 보냅니다. 프로젝트에 이러한 권한을 가진 사용자가 없으면 그룹의 Owner 또는 Maintainer 권한을 가진 사용자에게 이메일을 보냅니다. 예를 들어 서비스 계정이 프로젝트에 없거나, 비활성 상태이거나, Owner 권한을 가지고 있거나, GitLab이 플로에 맞게 낮출 수 없는 권한을 가진 경우 실행이 실패합니다.

연속으로 세 번 실패하면 GitLab은 일정을 비활성화하고 실패 이메일 대신 비활성화 이메일을 보냅니다. 실행에 성공하면 횟수가 초기화됩니다.

다음의 경우 GitLab은 예약 실행을 건너뛰며 실패로 세지 않습니다.

  • 자동화가 꺼져 있습니다.
  • 그룹 또는 인스턴스에 대해 실험 및 베타 기능이 꺼져 있습니다.
  • 프로젝트, 그룹 또는 인스턴스에 대해 예약 자동화가 꺼져 있습니다.
  • 플로 실행이 꺼져 있습니다.
  • 네임스페이스에 남은 GitLab Credits가 없습니다.
  • 프로젝트가 보관되었거나 삭제 예정입니다.

비활성화된 일정을 다시 시작하려면 이메일에 안내된 원인을 해결한 다음 aiFlowScheduleUpdate GraphQL 뮤테이션으로 active를 true로 설정합니다. 일정의 ID를 가져오려면 자동화의 flowSchedules 필드를 쿼리합니다. 재활성화해도 실패 횟수는 초기화되지 않으므로, 한 번 더 실패하면 일정이 다시 비활성화됩니다. 자동화 토글은 일정을 다시 활성화하지 않습니다. GitLab이 일정을 비활성화한 뒤에도 자동화는 켜진 상태로 남지만 플로는 실행되지 않습니다.

예약 자동화 켜기 또는 끄기#

예약 자동화는 기본적으로 켜져 있습니다. 예약 자동화를 끄면 기존 일정은 실행을 멈추지만 GitLab이 보관합니다. 진행 중인 실행은 계속됩니다. 예약 자동화가 꺼져 있는 동안에는 자동화에 일정을 추가할 수 없습니다. 예약 자동화를 다시 켜면 일정은 다음 예약 시각부터 재개됩니다. GitLab은 건너뛴 실행을 보충하지 않습니다.

예약 자동화를 켜거나 끄려면 플로 실행이 켜져 있어야 합니다. 그룹 또는 인스턴스에 대해 예약 자동화가 꺼져 있으면 하위 그룹과 프로젝트는 이를 켤 수 없습니다.

사전 요구 사항:

  • 최상위 그룹의 경우 그룹에 대한 Owner 권한.
  • 프로젝트의 경우 프로젝트에 대한 Maintainer 또는 Owner 권한.

최상위 그룹에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Flow execution에서 Allow scheduled automations 확인란을 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

이 설정은 그룹의 하위 그룹과 프로젝트에 적용됩니다.

프로젝트에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo를 확장합니다.
  4. Allow scheduled automations 토글을 켜거나 끕니다.
  5. Save changes를 선택합니다.

사전 요구 사항:

  • 인스턴스의 경우 관리자 액세스.
  • 그룹의 경우 그룹에 대한 Owner 권한.
  • 프로젝트의 경우 프로젝트에 대한 Maintainer 또는 Owner 권한.

인스턴스에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Flow execution에서 Allow scheduled automations 확인란을 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

그룹에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo features를 확장합니다.
  4. Flow execution에서 Allow scheduled automations 확인란을 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

이 설정은 그룹의 하위 그룹과 프로젝트에 적용됩니다.

프로젝트에 대해 예약 자동화를 켜거나 끄려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab Duo를 확장합니다.
  4. Allow scheduled automations 토글을 켜거나 끕니다.
  5. Save changes를 선택합니다.

지침 추가#

히스토리
  • 각 조건의 지침이 GitLab 19.5에서 ai_flow_trigger_goals라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 19.7에서 일반 공급됩니다. 기능 플래그 ai_flow_trigger_goals가 제거되었습니다.

지침은 자동화가 실행될 때 플로가 무엇을 해야 하는지 알려 주는 텍스트입니다. 자동화에는 지침이 한 세트 있으며, 이 지침은 자동화의 모든 이벤트와 일정에 적용됩니다. 같은 플로를 다른 지침으로 실행하려면 다른 자동화를 만듭니다.

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  • 자동화가 커스텀 플로, 외부 에이전트, Developer Flow 또는 구성 파일을 실행해야 합니다. 다른 플로에서는 Instructions 필드가 나타나지 않습니다. Developer Flow에서는 지침이 필수입니다.

기존 자동화에 지침을 추가하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 변경하려는 자동화에서 More actions(⋮) > Edit automation을 선택합니다.
  4. Instructions 필드에 지침을 입력합니다. 4096자 이하로 입력합니다.
  5. Save changes를 선택합니다.

이벤트 기반 자동화를 만들 때, 예약 자동화를 만들 때 또는 플로를 사용하도록 설정할 때도 지침을 추가할 수 있습니다.

지침 작성#

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

플로는 다음 정보도 받습니다.

  • 언급 이벤트의 경우 사람이 작성한 코멘트.
  • 그 외 모든 이벤트의 경우 짧은 컨텍스트 블록. 이 블록은 머지 리퀘스트, 작업 항목 또는 프로젝트의 웹 주소를 제공하며, 발생한 액션도 제공합니다.
  • 일정의 경우 프로젝트의 웹 주소가 담긴 컨텍스트 블록.
Warning

플로는 서비스 계정의 권한으로 실행됩니다. 플로의 질문에 답할 사람이 없습니다. 플로가 혼자 완료할 수 있도록 지침을 작성합니다.

원하는 결과를 얻는 지침을 작성하려면 다음과 같이 합니다.

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

다음 표는 지침의 예를 보여 줍니다.

조건 지침
Mention Answer the question in a comment. Keep the reply under 200 words.
Merge request, Created 액션 Review the code changes and list any missing tests in a comment.
Work item, Created 액션 Add a severity label and a test plan.
Schedule, Weekly List the open issues with no activity in the last 30 days in a new issue.

자동화 편집#

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 변경하려는 자동화에서 More actions(⋮) > Edit automation을 선택합니다.
  4. 변경한 다음 Save changes를 선택합니다.

커스텀 플로의 구성 페이지에서 Trigger conditions 아래에서도 해당 플로의 자동화를 편집할 수 있습니다.

자동화 켜기 또는 끄기#

히스토리
  • GitLab 19.4에서 도입되었습니다.

자동화를 끄면 비활성화되며 구성은 유지됩니다. 자동화를 끄면 구성된 액션 뒤에 자동으로 실행되지 않으며, 자동화 목록에는 그대로 남습니다.

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 켜거나 끄려는 자동화의 오른쪽에서 토글을 선택합니다.

커스텀 플로의 구성 페이지에서 Trigger conditions 아래에서도 해당 플로의 자동화를 켜거나 끌 수 있습니다.

자동화 삭제#

사전 요구 사항:

  • 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Automations를 선택합니다.
  3. 삭제하려는 자동화에서 More actions(⋮) > Delete automation을 선택합니다.
  4. 확인 대화 상자에서 OK를 선택합니다.

커스텀 플로의 구성 페이지에서 Trigger conditions 아래에서도 해당 플로의 자동화를 삭제할 수 있습니다.

트리거된 플로의 GitLab Credits 사용량#

자동화가 시작한 플로는 서비스 계정으로 실행됩니다. 플로의 사용량은 트리거하는 동작을 수행한 사용자가 아니라 네임스페이스에 청구됩니다.

예를 들어 머지 리퀘스트가 필요한 승인을 모두 받으면 자동화가 플로를 실행하고, 해당 머지 리퀘스트에 승인이 세 개 필요하다고 가정합니다. 세 번째 승인자가 머지 리퀘스트를 승인하면 자동화는 구성된 서비스 계정으로 플로를 실행하고, 사용량은 세 번째 승인자가 아니라 네임스페이스에 청구됩니다.

이 청구 방식은 파이프라인 상태 변경, 작업 항목 상태 변경, 언급, 일정을 포함한 모든 이벤트 유형에 적용됩니다.

자세한 내용은 크레딧 사용량의 청구 대상을 참고합니다.

문제 해결#

오류: Event types contains event types not supported#

기반 플로의 자동화를 만들거나 편집할 때 다음 오류가 발생할 수 있습니다.

Event types contains event types not supported by this foundational flow

자동화에 플로가 받아들이지 않는 이벤트 유형이 포함되어 있습니다. 이 오류를 해결하려면 플로의 문서에서 지원하는 이벤트를 확인한 다음 다음 중 하나를 수행합니다.

  • 플로가 자동화를 사용하면 자동화를 편집하여 플로가 지원하지 않는 이벤트를 제거합니다. 예를 들어 Fix CI/CD Pipeline은 Pipeline events만 받아들입니다.
  • 플로가 다른 방식으로 시작되면 플로에 자동화가 필요 없으므로 자동화를 삭제합니다. 예를 들어 SAST False Positive Detection은 보안 스캔 후에 실행됩니다.

서비스 계정에 No triggers for this event가 표시됨#

서비스 계정을 머지 리퀘스트에 할당하거나 서비스 계정에 리뷰를 요청할 때 서비스 계정이 No triggers for this event 메시지와 함께 비활성화될 수 있습니다. 언급 자동 완성에서는 Mention 이벤트에 대한 자동화가 없는 서비스 계정은 표시되지 않습니다. 각 경우에 프로젝트에는 해당 서비스 계정과 이벤트에 대한 자동화가 없습니다.

  • 담당자 메뉴에는 Assign이 필요합니다.
  • 검토자 메뉴에는 Assign reviewer가 필요합니다.
  • 언급 자동 완성에는 Mention이 필요합니다.

이 문제를 해결하려면 다음과 같이 합니다.

  1. 프로젝트에서 AI > Automations를 선택합니다.
  2. 서비스 계정과 원하는 이벤트를 사용하는 자동화가 있는지 확인합니다.
  3. 플로의 문서에서 플로가 해당 이벤트를 지원하는지 확인합니다.
  4. 플로가 이벤트를 지원하면 해당 이벤트를 포함하도록 자동화를 만들거나 편집합니다. 지원하지 않으면 플로의 문서에 설명된 방법을 사용합니다.

자동화에 저장할 수 있는 이벤트가 반드시 플로가 실행할 수 있는 이벤트는 아닙니다. 예를 들어 Developer는 Pipeline events에서 실행할 수 없습니다. 서비스 계정을 선택할 수 있게 하려는 목적으로만 이벤트를 추가하지 말고 지원되는 이벤트를 사용합니다.

오류: Event types cannot combine autonomous event types#

일정과 이벤트가 모두 있는 자동화를 저장할 때 다음 오류가 발생할 수 있습니다.

Event types cannot combine autonomous event types (scheduled) with other event types. Create a separate automation for them.

일정이 있는 자동화에는 이벤트 조건을 둘 수 없으며, 둘 중 하나를 제거하기 전에는 자동화를 저장할 수 없습니다. 이 오류를 해결하려면 이벤트를 제거하고 해당 이벤트용 자동화를 별도로 만듭니다.

경고: Flow enabled without an automation#

플로를 사용하도록 설정하면서 동시에 일정을 추가하면 GitLab이 자동화 없이 플로를 사용하도록 설정하고 다음 경고를 표시할 수 있습니다.

The scheduled automation was not created. <reason>

이 경고는 GitLab이 예약 자동화용 서비스 계정을 만들 수 없을 때 발생합니다. 플로는 여전히 켜져 있지만 일정이 없습니다.

경고 메시지의 <reason>이 원인을 설명합니다.

일반적인 원인은 다음과 같습니다.

  • 프로젝트에서 서비스 계정을 만들거나 프로젝트에 멤버를 추가할 권한이 없습니다.
  • 프로젝트의 그룹이 프로젝트에 멤버가 추가되는 것을 막고 있습니다.
  • 플로의 서비스 계정이 Owner 권한이거나 사용자가 부여할 수 있는 것보다 높은 권한을 가지고 있습니다.

이 경고를 해결하려면 경고 메시지에 나온 원인을 해결한 다음 플로의 예약 자동화를 다시 만듭니다.

전체 요구 사항 목록은 예약 자동화 만들기의 사전 요구 사항을 참고합니다.

예약 실행 결과 조사#

사전 요구 사항:

  • 인스턴스 로그에 접근할 수 있어야 합니다.

Ai::RunFlowScheduleWorker는 완료하는 모든 예약 실행에 대해 한 줄을 기록합니다. 일정 UI에 설명할 수 없는 결과가 표시되거나, 실행이 세션을 전혀 만들지 않았을 때 이 줄을 사용합니다.

이 줄을 읽는 위치는 제공 방식에 따라 다릅니다.

이 줄에는 다음 필드가 포함됩니다.

필드 설명
outcome succeeded, skipped 또는 failed.
outcome_reason 실행이 그렇게 끝난 이유. succeeded에는 설정되지 않습니다.
error_message 해당 메시지로, 1024자로 잘립니다. 실패의 경우 일정의 마지막 실행에 있는 error이기도 합니다.
flow_schedule_id 일정. GitLab이 일정을 로드할 수 없는 경우에도 설정됩니다.
flow_trigger_id 일정이 속한 자동화.
gl_project_id, gl_root_namespace_id 프로젝트와 최상위 그룹.
duo_workflow_id 실행이 만든 세션. 실행이 세션을 만든 뒤 시작하지 못해 실패한 경우에도 설정됩니다. 실행이 세션을 만들기 전에 끝난 경우에는 설정되지 않습니다.
consecutive_failure_count, deactivated 실패의 경우 새 횟수와 임곗값을 넘었는지 여부.

GitLab이 건너뛰며 실패로 세지 않는 실행은 다음 이유를 사용합니다.

outcome_reason 의미
schedule_not_found, flow_trigger_not_found 실행이 대기열에 들어간 뒤 일정 또는 해당 자동화가 삭제되었습니다.
schedule_inactive 실행이 대기열에 들어간 뒤 일정이 꺼졌습니다.
trigger_inactive, trigger_not_scheduled 자동화가 꺼졌거나 더 이상 일정에 따라 실행되지 않습니다.
scheduled_automations_disabled, flow_execution_disabled 프로젝트에 대해 예약 자동화 또는 플로 실행이 꺼져 있습니다.
schedules_feature_flag_disabled 프로젝트에 대해 플로 일정이 활성화되어 있지 않습니다.
beta_features_unavailable 인스턴스 또는 그룹에 대해 실험 및 베타 기능이 꺼져 있습니다.
project_archived, project_pending_deletion, project_not_found 프로젝트가 플로를 실행할 수 없습니다.
next_run_in_future 실행이 예정 시각보다 먼저 대기열에 들어갔습니다.
usage_quota_exceeded 네임스페이스에 남은 GitLab Credits가 없습니다.
flow_disabled_by_feature_flag, non_human_trigger_not_permitted 플로가 실행을 거부했습니다.

실패한 실행은 일정을 비활성화하는 연속 세 번 실패에 포함됩니다. GitLab은 다음 이유를 지정합니다.

outcome_reason 의미
unsupported_target 플로가 일정 실행을 지원하지 않습니다.
excess_service_account_access 서비스 계정이 플로보다 많은 액세스 권한을 가지고 있으며 GitLab이 이를 낮출 수 없었습니다.
unexpected_error 실행에서 예외가 발생했습니다. 예외는 Sentry에도 있습니다.
run_service_error 플로가 이유를 지정하지 않은 사유로 실행이 세션을 만들기 전에 실패했습니다.

플로가 자체 이유를 지정하면 GitLab은 그 이유를 대신 기록합니다. 일반적인 값은 플로에 일정용 목표 템플릿이 없을 때의 unsupported_event, 자동화가 일정과 다른 이벤트 유형을 함께 사용할 때의 autonomous_trigger_source_not_permitted, 기반 플로가 실행을 거부했을 때의 run_not_eligible입니다. 자세한 내용은 같은 줄의 error_message를 읽습니다.

예정된 일정이 처리되었는지 확인하려면 대신 워커의 Sidekiq 작업을 찾습니다. sidekiq.log를 json.class: "Ai::RunFlowScheduleWorker"로 필터링한 다음 json.correlation_id를 결과 줄과 대조합니다.