InfoGrab Docs

사용자 정의 플로우

요약

이 기능의 가용성은 기능 플래그로 제어됩니다. 사용자 정의 플로우는 GitLab 프로젝트 전반에 걸쳐 복잡한 다단계 작업을 자동화하기 위해 만들고 구성하는 AI 기반 워크플로입니다. GitLab Duo Agent Platform 전제 조건을 충족합니다.

모델 정보
히스토리
  • GitLab 18.4에서 ai_catalog_flows이라는 플래그와 함께 실험으로 도입. 기본적으로 비활성화됨.
  • GitLab 18.7에서 베타로 변경.
  • GitLab 18.7에서 GitLab.com에서 활성화.
  • GitLab 18.8에서 GitLab Self-Managed 및 GitLab Dedicated에서 활성화.
  • GitLab 18.9에서 ai_flow_trigger_pipeline_hooks라는 플래그와 함께 파이프라인 이벤트 트리거가 실험으로 도입. 기본적으로 비활성화됨.
  • GitLab 18.10에서 ai_catalog_project_level_enablement이라는 플래그와 함께 Maintainer로서 프로젝트에서 직접 활성화하는 기능이 도입. GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 기본적으로 활성화됨.
  • GitLab 18.10에서 GitLab Credits를 사용하는 GitLab.com Free 티어에서 사용 가능.
  • GitLab 18.11에서 기능 플래그 ai_catalog_project_level_enablement 제거됨.
  • GitLab 19.0에서 머지 리퀘스트 준비 트리거 이벤트 유형이 merge_request_ready_flow_trigger라는 플래그와 함께 도입. 기본적으로 비활성화됨.
Feature flag

이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 이력을 참조합니다.

사용자 정의 플로우는 GitLab 프로젝트 전반에 걸쳐 복잡한 다단계 작업을 자동화하기 위해 만들고 구성하는 AI 기반 워크플로입니다.

전제 조건#

플로우 가시성#

히스토리
  • GitLab 18.7에서 비공개 플로우를 볼 수 있는 역할이 확장됨.

사용자 정의 플로우를 만들 때 관리 프로젝트를 선택하고 플로우를 공개 또는 비공개로 설정합니다.

공개 플로우:

  • 인스턴스의 누구나 볼 수 있으며 전제 조건을 충족하는 모든 프로젝트에서 활성화할 수 있습니다.

비공개 플로우:

  • 다음 사용자만 볼 수 있습니다:
    • Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 역할을 가진 관리 프로젝트 구성원.
    • 최상위 그룹에 대한 Owner 역할을 가진 사용자.
  • 관리 프로젝트 이외의 프로젝트 또는 최상위 그룹 이외의 그룹에서는 활성화할 수 없습니다.

플로우가 활성화된 경우 공개 플로우를 비공개로 변경할 수 없습니다.

프로젝트의 플로우 보기#

전제 조건:

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

프로젝트와 연결된 플로우 목록을 보려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
    • 프로젝트에서 활성화된 플로우를 보려면 활성화됨 탭을 선택합니다.
    • 프로젝트에서 관리되는 플로우를 보려면 관리됨 탭을 선택합니다.

플로우를 선택하면 세부 정보를 볼 수 있습니다.

플로우 만들기#

프로젝트에서 또는 AI 카탈로그를 사용하여 플로우를 만들 수 있습니다.

Note

프로젝트 또는 AI 카탈로그의 특정 사용자 정의 에이전트를 호출하도록 사용자 정의 플로우를 정의할 수 없습니다. 사용자 정의 플로우는 YAML 구성을 기반으로 자체 에이전트를 생성하고 사용합니다.

전제 조건:

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

플로우를 만들려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
  3. 새 플로우를 선택합니다.
  4. 기본 정보 아래에서:
    1. 표시 이름에 이름을 입력합니다.
    2. 설명에 설명을 입력합니다.
  5. 가시성 및 액세스 아래에서 가시성에 비공개 또는 공개를 선택합니다.
  6. 구성 아래에서:
    1. 플로우를 선택합니다.
    2. 에디터에서 플로우 구성을 입력합니다. YAML 구문 및 스키마에 대한 자세한 내용은 사용자 정의 플로우 YAML 스키마를 참조합니다.
  7. 플로우 만들기를 선택합니다.
  1. 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
  2. AI 카탈로그를 선택한 다음 플로우 탭을 선택합니다.
  3. 새 플로우를 선택합니다.
  4. 기본 정보 아래에서:
    1. 표시 이름에 이름을 입력합니다.
    2. 설명에 설명을 입력합니다.
  5. 가시성 및 액세스 아래에서 가시성에 비공개 또는 공개를 선택합니다.
  6. 구성 아래에서:
    1. 플로우를 선택합니다.
    2. 에디터에서 플로우 구성을 입력합니다. YAML 구문 및 스키마에 대한 자세한 내용은 사용자 정의 플로우 YAML 스키마를 참조합니다.
  7. 플로우 만들기를 선택합니다.

플로우가 AI 카탈로그에 나타납니다.

플로우 활성화#

이슈, 머지 리퀘스트 또는 토론에서 트리거하려면 플로우를 활성화합니다.

프로젝트에서 플로우를 활성화하면 동시에 해당 프로젝트의 최상위 그룹에서도 활성화됩니다.

전제 조건:

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

플로우를 활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
  3. 관리됨 탭을 선택한 다음 활성화할 플로우를 선택합니다.
  4. 오른쪽 상단에서 활성화를 선택합니다.
  5. 프로젝트 아래에서 플로우를 활성화할 프로젝트를 선택합니다.
  6. 트리거 추가에서 플로우를 트리거하는 이벤트를 선택합니다:
    • 멘션: 이슈 또는 머지 리퀘스트의 댓글에서 서비스 계정 사용자가 멘션될 때.
    • 배정: 이슈 또는 머지 리퀘스트에 서비스 계정 사용자가 배정될 때.
    • 리뷰어 배정: 머지 리퀘스트에 서비스 계정 사용자가 리뷰어로 배정될 때.
    • 파이프라인 이벤트: 파이프라인이 상태를 변경할 때. 가능한 상태는 created, started, succeeded, failed입니다.
    • 머지 리퀘스트 준비: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때.
  7. 활성화를 선택합니다.

플로우를 활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
  2. AI 카탈로그를 선택한 다음 플로우 탭을 선택합니다.
  3. 활성화할 플로우를 선택합니다.
  4. 오른쪽 상단에서 활성화를 선택합니다.
  5. 프로젝트 아래에서 플로우를 활성화할 프로젝트를 선택합니다.
  6. 트리거 추가에서 플로우를 트리거하는 이벤트를 선택합니다:
    • 멘션: 이슈 또는 머지 리퀘스트의 댓글에서 서비스 계정 사용자가 멘션될 때.
    • 배정: 이슈 또는 머지 리퀘스트에 서비스 계정 사용자가 배정될 때.
    • 리뷰어 배정: 머지 리퀘스트에 서비스 계정 사용자가 리뷰어로 배정될 때.
    • 머지 리퀘스트 준비: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때.
  7. 활성화를 선택합니다.

플로우가 그룹 및 프로젝트 AI > 플로우 페이지에 나타납니다. 최상위 그룹의 모든 프로젝트 구성원이 이제 자신의 프로젝트에서 플로우를 활성화할 수 있습니다.

서비스 계정이 그룹에 생성됩니다. 계정 이름은 다음 명명 규칙을 따릅니다: ai-<flow>-<group>.

프로젝트에서 활성화#

플로우가 최상위 그룹에서 이미 활성화된 경우 그룹의 프로젝트에서 활성화할 수 있습니다.

전제 조건:

  • 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.
  • 플로우가 프로젝트의 최상위 그룹에서 활성화되어 있어야 합니다.

프로젝트에서 플로우를 활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
  3. 오른쪽 상단에서 그룹에서 플로우 활성화를 선택합니다.
  4. 드롭다운 목록에서 활성화할 플로우를 선택합니다.
  5. 트리거 추가에서 플로우를 트리거하는 이벤트를 선택합니다:
    • 멘션: 이슈 또는 머지 리퀘스트의 댓글에서 서비스 계정 사용자가 멘션될 때.
    • 배정: 이슈 또는 머지 리퀘스트에 서비스 계정 사용자가 배정될 때.
    • 리뷰어 배정: 머지 리퀘스트에 서비스 계정 사용자가 리뷰어로 배정될 때.
    • 머지 리퀘스트 준비: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때.
  6. 활성화를 선택합니다.

플로우가 프로젝트의 AI > 플로우 목록에 나타납니다.

최상위 그룹의 서비스 계정이 프로젝트에 추가됩니다. 이 계정에는 Developer 역할이 부여됩니다.

플로우 비활성화#

전제 조건:

  • 그룹의 경우 Maintainer 또는 Owner 역할이 있어야 합니다.
  • 프로젝트의 경우 Maintainer 또는 Owner 역할이 있어야 합니다.

플로우를 비활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 제거할 플로우를 찾고 작업 (⋮) > 비활성화를 선택합니다.
  4. 확인 대화 상자에서 비활성화를 선택합니다.

플로우가 더 이상 프로젝트 또는 그룹에 나타나지 않으며 실행할 수 없습니다. 플로우와 관련된 서비스 계정이나 트리거도 제거됩니다.

트리거 만들기#

이제 플로우가 실행되는 시점을 결정하는 트리거를 만들어야 합니다.

예를 들어 토론에서 플로우 서비스 계정 사용자를 멘션할 때 또는 서비스 계정을 리뷰어로 배정할 때 플로우가 트리거되도록 지정할 수 있습니다.

프로젝트에서 플로우를 활성화할 때도 트리거를 만듭니다.

플로우 사용#

전제 조건:

  • 프로젝트에 대한 Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  • 플로우가 프로젝트에서 활성화되어 있어야 합니다.

플로우를 사용하려면:

  1. 프로젝트에서 이슈, 머지 리퀘스트 또는 에픽을 엽니다.

  2. 플로우를 트리거하려면 플로우 서비스 계정 사용자를 멘션, 배정 또는 리뷰를 요청합니다. 기본적으로 사용자 이름은 ai-<flow>-<group>입니다.

    예를 들어 GitLab Duo 그룹에서 Security scanner라는 플로우를 활성화하면 서비스 계정 사용자는 ai-security-scanner-gitlab-duo입니다.

  3. 플로우가 작업을 완료하면 확인이 표시되고, 병합 준비가 된 변경 사항 또는 인라인 댓글이 표시됩니다.

Warning

서비스 계정은 다음 두 가지 조건을 모두 충족하는 모든 프로젝트에 액세스할 수 있습니다:

  • 액세스 권한이 있는 프로젝트.
  • 플로우가 추가된 프로젝트.

플로우 복제#

원본을 덮어쓰지 않고 플로우를 변경하려면 기존 플로우의 복사본을 만듭니다.

전제 조건:

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

플로우를 복제하려면:

  1. 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
  2. AI 카탈로그를 선택한 다음 플로우 탭을 선택합니다.
  3. 복제할 플로우를 선택합니다.
  4. 오른쪽 상단에서 작업 (⋮) > 복제를 선택합니다.
  5. 선택 사항. 변경하려는 필드를 편집합니다.
  6. 플로우 만들기를 선택합니다.

플로우 편집#

플로우 구성을 변경하기 위해 플로우를 편집합니다.

전제 조건:

  • 관리 프로젝트의 구성원이고 Maintainer 또는 Owner 역할이 있어야 합니다.
  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 편집할 플로우를 선택합니다.
  4. 오른쪽 상단에서 편집을 선택합니다.
  5. 변경하려는 필드를 편집한 다음 변경 사항 저장을 선택합니다.

플로우 숨기기#

AI 카탈로그에서 플로우를 제거하려면 플로우를 숨깁니다.

플로우를 숨기면 사용자가 활성화할 수 없습니다. 그러나 이미 활성화된 그룹 및 프로젝트에서는 플로우를 계속 트리거할 수 있습니다.

전제 조건:

  • 관리 프로젝트의 구성원이고 Maintainer 또는 Owner 역할이 있어야 합니다.

플로우를 숨기려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 숨길 플로우를 찾고 작업 (⋮) > 숨기기를 선택합니다.
  4. 확인 대화 상자에서 확인을 선택합니다.

플로우 삭제#

인스턴스에서 플로우를 영구적으로 제거하려면 플로우를 삭제합니다.

전제 조건:

  • 관리자여야 합니다.
  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 삭제할 플로우를 찾고 작업 (⋮) > 삭제를 선택합니다.
  4. 확인 대화 상자에서 삭제를 선택합니다.

그룹 공유 및 플로우#

그룹에서 플로우를 활성화하면 관련 서비스 계정이 자동으로 생성됩니다. 서비스 계정은:

  • 복합 ID 인증을 사용하여 플로우가 플로우를 실행하는 사용자보다 더 많은 권한을 절대 가질 수 없도록 합니다.
  • 플로우를 활성화하는 최상위 그룹 아래의 모든 프로젝트에 구성원으로 추가되므로 플로우가 해당 그룹 외부의 리소스에 액세스할 수 없습니다.
  • 최상위 그룹과 공유된 추가 그룹에 대한 액세스 권한이 부여됩니다. 서비스 계정은 그룹 공유를 위한 다른 그룹 구성원처럼 취급됩니다.
Note

여러 최상위 그룹에서 플로우 서비스 계정을 공유하면 의도하지 않은 액세스 권한 및 보안 위험이 생길 수 있습니다.

사용자 정의 플로우 켜기 또는 끄기#

히스토리

기본적으로 사용자 정의 플로우는 켜져 있습니다. 최상위 그룹 또는 인스턴스에 대해 켜거나 끌 수 있습니다.

사용자 정의 플로우가 꺼지면:

  • 사용자는 사용자 정의 플로우를 만들거나 활성화하거나 비활성화하거나 수정하거나 실행할 수 없습니다.

  • 기존 사용자 정의 플로우가 AI > 플로우 > 활성화됨 아래에서 더 이상 보이지 않습니다.

  • 프로젝트에서 만든 사용자 정의 플로우가 AI > 플로우 > 관리됨 아래에 나타나지만 수정하거나 실행할 수 없습니다.

  • 파운데이셔널 플로우는 계속 사용할 수 있습니다.

전제 조건:

  • 그룹에 대한 Owner 역할이 있어야 합니다.

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

  2. 왼쪽 사이드바에서 설정 > GitLab Duo를 선택합니다.

  3. 구성 변경을 선택합니다.

  4. 사용자 정의 에이전트 및 플로우 아래에서 사용자 정의 플로우 허용 체크박스를 선택하거나 선택 취소합니다.

  5. 변경 사항 저장을 선택합니다.

이 설정은 그룹의 모든 하위 그룹에 전파됩니다.

전제 조건:

  • 관리자여야 합니다.

  1. 오른쪽 상단에서 관리자를 선택합니다.

  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.

  3. 구성 변경을 선택합니다.

  4. 사용자 정의 에이전트 및 플로우 아래에서 사용자 정의 플로우 허용 체크박스를 선택하거나 선택 취소합니다.

  5. 변경 사항 저장을 선택합니다.

인스턴스 수준 설정이 꺼지면 그룹 수준 설정으로 재정의할 수 없습니다.

사용자 정의 플로우

Tier: [Free](/19.0/subscriptions/gitlab_credits/#for-the-free-tier), Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기
요약

이 기능의 가용성은 기능 플래그로 제어됩니다. 사용자 정의 플로우는 GitLab 프로젝트 전반에 걸쳐 복잡한 다단계 작업을 자동화하기 위해 만들고 구성하는 AI 기반 워크플로입니다. GitLab Duo Agent Platform 전제 조건을 충족합니다.

모델 정보
히스토리
  • GitLab 18.4에서 ai_catalog_flows이라는 플래그와 함께 실험으로 도입. 기본적으로 비활성화됨.
  • GitLab 18.7에서 베타로 변경.
  • GitLab 18.7에서 GitLab.com에서 활성화.
  • GitLab 18.8에서 GitLab Self-Managed 및 GitLab Dedicated에서 활성화.
  • GitLab 18.9에서 ai_flow_trigger_pipeline_hooks라는 플래그와 함께 파이프라인 이벤트 트리거가 실험으로 도입. 기본적으로 비활성화됨.
  • GitLab 18.10에서 ai_catalog_project_level_enablement이라는 플래그와 함께 Maintainer로서 프로젝트에서 직접 활성화하는 기능이 도입. GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 기본적으로 활성화됨.
  • GitLab 18.10에서 GitLab Credits를 사용하는 GitLab.com Free 티어에서 사용 가능.
  • GitLab 18.11에서 기능 플래그 ai_catalog_project_level_enablement 제거됨.
  • GitLab 19.0에서 머지 리퀘스트 준비 트리거 이벤트 유형이 merge_request_ready_flow_trigger라는 플래그와 함께 도입. 기본적으로 비활성화됨.
Feature flag

이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 이력을 참조합니다.

사용자 정의 플로우는 GitLab 프로젝트 전반에 걸쳐 복잡한 다단계 작업을 자동화하기 위해 만들고 구성하는 AI 기반 워크플로입니다.

전제 조건#

플로우 가시성#

히스토리
  • GitLab 18.7에서 비공개 플로우를 볼 수 있는 역할이 확장됨.

사용자 정의 플로우를 만들 때 관리 프로젝트를 선택하고 플로우를 공개 또는 비공개로 설정합니다.

공개 플로우:

  • 인스턴스의 누구나 볼 수 있으며 전제 조건을 충족하는 모든 프로젝트에서 활성화할 수 있습니다.

비공개 플로우:

  • 다음 사용자만 볼 수 있습니다:
    • Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 역할을 가진 관리 프로젝트 구성원.
    • 최상위 그룹에 대한 Owner 역할을 가진 사용자.
  • 관리 프로젝트 이외의 프로젝트 또는 최상위 그룹 이외의 그룹에서는 활성화할 수 없습니다.

플로우가 활성화된 경우 공개 플로우를 비공개로 변경할 수 없습니다.

프로젝트의 플로우 보기#

전제 조건:

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

프로젝트와 연결된 플로우 목록을 보려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
    • 프로젝트에서 활성화된 플로우를 보려면 활성화됨 탭을 선택합니다.
    • 프로젝트에서 관리되는 플로우를 보려면 관리됨 탭을 선택합니다.

플로우를 선택하면 세부 정보를 볼 수 있습니다.

플로우 만들기#

프로젝트에서 또는 AI 카탈로그를 사용하여 플로우를 만들 수 있습니다.

Note

프로젝트 또는 AI 카탈로그의 특정 사용자 정의 에이전트를 호출하도록 사용자 정의 플로우를 정의할 수 없습니다. 사용자 정의 플로우는 YAML 구성을 기반으로 자체 에이전트를 생성하고 사용합니다.

전제 조건:

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

플로우를 만들려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
  3. 새 플로우를 선택합니다.
  4. 기본 정보 아래에서:
    1. 표시 이름에 이름을 입력합니다.
    2. 설명에 설명을 입력합니다.
  5. 가시성 및 액세스 아래에서 가시성에 비공개 또는 공개를 선택합니다.
  6. 구성 아래에서:
    1. 플로우를 선택합니다.
    2. 에디터에서 플로우 구성을 입력합니다. YAML 구문 및 스키마에 대한 자세한 내용은 사용자 정의 플로우 YAML 스키마를 참조합니다.
  7. 플로우 만들기를 선택합니다.
  1. 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
  2. AI 카탈로그를 선택한 다음 플로우 탭을 선택합니다.
  3. 새 플로우를 선택합니다.
  4. 기본 정보 아래에서:
    1. 표시 이름에 이름을 입력합니다.
    2. 설명에 설명을 입력합니다.
  5. 가시성 및 액세스 아래에서 가시성에 비공개 또는 공개를 선택합니다.
  6. 구성 아래에서:
    1. 플로우를 선택합니다.
    2. 에디터에서 플로우 구성을 입력합니다. YAML 구문 및 스키마에 대한 자세한 내용은 사용자 정의 플로우 YAML 스키마를 참조합니다.
  7. 플로우 만들기를 선택합니다.

플로우가 AI 카탈로그에 나타납니다.

플로우 활성화#

이슈, 머지 리퀘스트 또는 토론에서 트리거하려면 플로우를 활성화합니다.

프로젝트에서 플로우를 활성화하면 동시에 해당 프로젝트의 최상위 그룹에서도 활성화됩니다.

전제 조건:

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

플로우를 활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
  3. 관리됨 탭을 선택한 다음 활성화할 플로우를 선택합니다.
  4. 오른쪽 상단에서 활성화를 선택합니다.
  5. 프로젝트 아래에서 플로우를 활성화할 프로젝트를 선택합니다.
  6. 트리거 추가에서 플로우를 트리거하는 이벤트를 선택합니다:
    • 멘션: 이슈 또는 머지 리퀘스트의 댓글에서 서비스 계정 사용자가 멘션될 때.
    • 배정: 이슈 또는 머지 리퀘스트에 서비스 계정 사용자가 배정될 때.
    • 리뷰어 배정: 머지 리퀘스트에 서비스 계정 사용자가 리뷰어로 배정될 때.
    • 파이프라인 이벤트: 파이프라인이 상태를 변경할 때. 가능한 상태는 created, started, succeeded, failed입니다.
    • 머지 리퀘스트 준비: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때.
  7. 활성화를 선택합니다.

플로우를 활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
  2. AI 카탈로그를 선택한 다음 플로우 탭을 선택합니다.
  3. 활성화할 플로우를 선택합니다.
  4. 오른쪽 상단에서 활성화를 선택합니다.
  5. 프로젝트 아래에서 플로우를 활성화할 프로젝트를 선택합니다.
  6. 트리거 추가에서 플로우를 트리거하는 이벤트를 선택합니다:
    • 멘션: 이슈 또는 머지 리퀘스트의 댓글에서 서비스 계정 사용자가 멘션될 때.
    • 배정: 이슈 또는 머지 리퀘스트에 서비스 계정 사용자가 배정될 때.
    • 리뷰어 배정: 머지 리퀘스트에 서비스 계정 사용자가 리뷰어로 배정될 때.
    • 머지 리퀘스트 준비: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때.
  7. 활성화를 선택합니다.

플로우가 그룹 및 프로젝트 AI > 플로우 페이지에 나타납니다. 최상위 그룹의 모든 프로젝트 구성원이 이제 자신의 프로젝트에서 플로우를 활성화할 수 있습니다.

서비스 계정이 그룹에 생성됩니다. 계정 이름은 다음 명명 규칙을 따릅니다: ai-<flow>-<group>.

프로젝트에서 활성화#

플로우가 최상위 그룹에서 이미 활성화된 경우 그룹의 프로젝트에서 활성화할 수 있습니다.

전제 조건:

  • 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.
  • 플로우가 프로젝트의 최상위 그룹에서 활성화되어 있어야 합니다.

프로젝트에서 플로우를 활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > 플로우를 선택합니다.
  3. 오른쪽 상단에서 그룹에서 플로우 활성화를 선택합니다.
  4. 드롭다운 목록에서 활성화할 플로우를 선택합니다.
  5. 트리거 추가에서 플로우를 트리거하는 이벤트를 선택합니다:
    • 멘션: 이슈 또는 머지 리퀘스트의 댓글에서 서비스 계정 사용자가 멘션될 때.
    • 배정: 이슈 또는 머지 리퀘스트에 서비스 계정 사용자가 배정될 때.
    • 리뷰어 배정: 머지 리퀘스트에 서비스 계정 사용자가 리뷰어로 배정될 때.
    • 머지 리퀘스트 준비: 드래프트 머지 리퀘스트가 리뷰 준비 완료로 표시될 때.
  6. 활성화를 선택합니다.

플로우가 프로젝트의 AI > 플로우 목록에 나타납니다.

최상위 그룹의 서비스 계정이 프로젝트에 추가됩니다. 이 계정에는 Developer 역할이 부여됩니다.

플로우 비활성화#

전제 조건:

  • 그룹의 경우 Maintainer 또는 Owner 역할이 있어야 합니다.
  • 프로젝트의 경우 Maintainer 또는 Owner 역할이 있어야 합니다.

플로우를 비활성화하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 제거할 플로우를 찾고 작업 (⋮) > 비활성화를 선택합니다.
  4. 확인 대화 상자에서 비활성화를 선택합니다.

플로우가 더 이상 프로젝트 또는 그룹에 나타나지 않으며 실행할 수 없습니다. 플로우와 관련된 서비스 계정이나 트리거도 제거됩니다.

트리거 만들기#

이제 플로우가 실행되는 시점을 결정하는 트리거를 만들어야 합니다.

예를 들어 토론에서 플로우 서비스 계정 사용자를 멘션할 때 또는 서비스 계정을 리뷰어로 배정할 때 플로우가 트리거되도록 지정할 수 있습니다.

프로젝트에서 플로우를 활성화할 때도 트리거를 만듭니다.

플로우 사용#

전제 조건:

  • 프로젝트에 대한 Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  • 플로우가 프로젝트에서 활성화되어 있어야 합니다.

플로우를 사용하려면:

  1. 프로젝트에서 이슈, 머지 리퀘스트 또는 에픽을 엽니다.

  2. 플로우를 트리거하려면 플로우 서비스 계정 사용자를 멘션, 배정 또는 리뷰를 요청합니다. 기본적으로 사용자 이름은 ai-<flow>-<group>입니다.

    예를 들어 GitLab Duo 그룹에서 Security scanner라는 플로우를 활성화하면 서비스 계정 사용자는 ai-security-scanner-gitlab-duo입니다.

  3. 플로우가 작업을 완료하면 확인이 표시되고, 병합 준비가 된 변경 사항 또는 인라인 댓글이 표시됩니다.

Warning

서비스 계정은 다음 두 가지 조건을 모두 충족하는 모든 프로젝트에 액세스할 수 있습니다:

  • 액세스 권한이 있는 프로젝트.
  • 플로우가 추가된 프로젝트.

플로우 복제#

원본을 덮어쓰지 않고 플로우를 변경하려면 기존 플로우의 복사본을 만듭니다.

전제 조건:

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

플로우를 복제하려면:

  1. 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
  2. AI 카탈로그를 선택한 다음 플로우 탭을 선택합니다.
  3. 복제할 플로우를 선택합니다.
  4. 오른쪽 상단에서 작업 (⋮) > 복제를 선택합니다.
  5. 선택 사항. 변경하려는 필드를 편집합니다.
  6. 플로우 만들기를 선택합니다.

플로우 편집#

플로우 구성을 변경하기 위해 플로우를 편집합니다.

전제 조건:

  • 관리 프로젝트의 구성원이고 Maintainer 또는 Owner 역할이 있어야 합니다.
  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 편집할 플로우를 선택합니다.
  4. 오른쪽 상단에서 편집을 선택합니다.
  5. 변경하려는 필드를 편집한 다음 변경 사항 저장을 선택합니다.

플로우 숨기기#

AI 카탈로그에서 플로우를 제거하려면 플로우를 숨깁니다.

플로우를 숨기면 사용자가 활성화할 수 없습니다. 그러나 이미 활성화된 그룹 및 프로젝트에서는 플로우를 계속 트리거할 수 있습니다.

전제 조건:

  • 관리 프로젝트의 구성원이고 Maintainer 또는 Owner 역할이 있어야 합니다.

플로우를 숨기려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 숨길 플로우를 찾고 작업 (⋮) > 숨기기를 선택합니다.
  4. 확인 대화 상자에서 확인을 선택합니다.

플로우 삭제#

인스턴스에서 플로우를 영구적으로 제거하려면 플로우를 삭제합니다.

전제 조건:

  • 관리자여야 합니다.
  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. AI > 플로우를 선택합니다.
  3. 삭제할 플로우를 찾고 작업 (⋮) > 삭제를 선택합니다.
  4. 확인 대화 상자에서 삭제를 선택합니다.

그룹 공유 및 플로우#

그룹에서 플로우를 활성화하면 관련 서비스 계정이 자동으로 생성됩니다. 서비스 계정은:

  • 복합 ID 인증을 사용하여 플로우가 플로우를 실행하는 사용자보다 더 많은 권한을 절대 가질 수 없도록 합니다.
  • 플로우를 활성화하는 최상위 그룹 아래의 모든 프로젝트에 구성원으로 추가되므로 플로우가 해당 그룹 외부의 리소스에 액세스할 수 없습니다.
  • 최상위 그룹과 공유된 추가 그룹에 대한 액세스 권한이 부여됩니다. 서비스 계정은 그룹 공유를 위한 다른 그룹 구성원처럼 취급됩니다.
Note

여러 최상위 그룹에서 플로우 서비스 계정을 공유하면 의도하지 않은 액세스 권한 및 보안 위험이 생길 수 있습니다.

사용자 정의 플로우 켜기 또는 끄기#

히스토리

기본적으로 사용자 정의 플로우는 켜져 있습니다. 최상위 그룹 또는 인스턴스에 대해 켜거나 끌 수 있습니다.

사용자 정의 플로우가 꺼지면:

  • 사용자는 사용자 정의 플로우를 만들거나 활성화하거나 비활성화하거나 수정하거나 실행할 수 없습니다.

  • 기존 사용자 정의 플로우가 AI > 플로우 > 활성화됨 아래에서 더 이상 보이지 않습니다.

  • 프로젝트에서 만든 사용자 정의 플로우가 AI > 플로우 > 관리됨 아래에 나타나지만 수정하거나 실행할 수 없습니다.

  • 파운데이셔널 플로우는 계속 사용할 수 있습니다.

전제 조건:

  • 그룹에 대한 Owner 역할이 있어야 합니다.

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

  2. 왼쪽 사이드바에서 설정 > GitLab Duo를 선택합니다.

  3. 구성 변경을 선택합니다.

  4. 사용자 정의 에이전트 및 플로우 아래에서 사용자 정의 플로우 허용 체크박스를 선택하거나 선택 취소합니다.

  5. 변경 사항 저장을 선택합니다.

이 설정은 그룹의 모든 하위 그룹에 전파됩니다.

전제 조건:

  • 관리자여야 합니다.

  1. 오른쪽 상단에서 관리자를 선택합니다.

  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.

  3. 구성 변경을 선택합니다.

  4. 사용자 정의 에이전트 및 플로우 아래에서 사용자 정의 플로우 허용 체크박스를 선택하거나 선택 취소합니다.

  5. 변경 사항 저장을 선택합니다.

인스턴스 수준 설정이 꺼지면 그룹 수준 설정으로 재정의할 수 없습니다.