InfoGrab DocsInfoGrab Docs

사용자 정의 플로

요약

사용자 정의 플로는 GitLab 프로젝트 전반의 복잡한 다단계 작업을 자동화하도록 직접 만들고 구성하는 AI 기반 워크플로입니다. 사용자 정의 플로를 만들 때 이를 관리할 프로젝트를 선택하고 플로를 공개, 비공개, 제한 중 하나로 지정합니다.

Model information
히스토리
  • GitLab 18.4에서 ai_catalog_flows라는 기능 플래그와 함께 실험으로 도입됐습니다. 기본적으로 비활성화됩니다.
  • GitLab 18.7에서 베타로 변경됐습니다.
  • GitLab 18.7에서 GitLab.com에서 활성화됐습니다.
  • GitLab 18.8에서 GitLab Self-Managed와 GitLab Dedicated에서 활성화됐습니다.
  • GitLab 18.8에서 기능 플래그 ai_catalog_flows가 기본적으로 활성화됐습니다.
  • 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 트리거 이벤트 유형이 merge_request_ready_flow_trigger라는 플래그와 함께 도입됐습니다. 기본적으로 비활성화됩니다.
  • GitLab 19.1에서 Merge request code conflict 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.1에서 Approved 액션이 있는 Merge request 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.1에서 기능 플래그 ai_flow_trigger_pipeline_hooks가 제거됐습니다.
  • GitLab 19.1에서 Work item created 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.1에서 Merge request ready 트리거 이벤트 유형이 일반적으로 사용 가능해졌습니다. 기능 플래그 merge_request_ready_flow_trigger가 제거됐습니다.
  • GitLab 19.2에서 Work item status changed 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.2에서 기능 플래그 ai_catalog_flows가 제거됐습니다.
  • GitLab 19.2에서 일반적으로 사용 가능으로 변경됐습니다.
  • GitLab 19.4에서 Created 액션이 있는 Merge request 트리거 이벤트 유형이 도입됐습니다.

사용자 정의 플로는 GitLab 프로젝트 전반의 복잡한 다단계 작업을 자동화하도록 직접 만들고 구성하는 AI 기반 워크플로입니다.

사전 요구 사항#

플로 가시성#

히스토리
  • GitLab 18.7에서 비공개 플로를 볼 수 있는 권한이 확장됐습니다.
  • GitLab 19.3에서 ai_catalog_internal_visibility라는 기능 플래그와 함께 제한된 가시성이 도입됐습니다. 기본적으로 활성화됩니다.
  • GitLab 19.4에서 일반적으로 사용 가능해졌습니다. 기능 플래그 ai_catalog_internal_visibility가 제거됐습니다.

사용자 정의 플로를 만들 때 이를 관리할 프로젝트를 선택하고 플로를 공개, 비공개, 제한 중 하나로 지정합니다.

공개 플로:

  • 인스턴스의 누구나 볼 수 있고, 사전 요구 사항을 충족하는 모든 프로젝트에서 활성화할 수 있습니다.

제한된 플로:

  • 관리 프로젝트의 최상위 그룹에 속한 모든 프로젝트의 멤버가 보고 사용할 수 있습니다.
  • 같은 최상위 그룹의 다른 프로젝트에서 켤 수 있습니다.
  • 해당 최상위 그룹 밖에서는 보거나 켤 수 없습니다.
  • Explore의 AI Catalog에서는 볼 수 없습니다.
  • Explore의 AI Catalog가 아니라 프로젝트에서만 만들 수 있습니다.

해당 최상위 그룹 밖의 프로젝트가 플로를 켜 둔 경우에는 공개 플로를 제한 플로로 바꿀 수 없습니다.

비공개 플로:

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

관리 프로젝트 이외의 프로젝트가 플로를 켜 둔 경우에는 공개 또는 제한된 플로를 비공개로 바꿀 수 없습니다.

프로젝트의 플로 보기#

사전 요구 사항:

  • 프로젝트에 대한 Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

프로젝트와 연결된 플로 목록을 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
    • 프로젝트에서 활성화된 플로를 보려면 Enabled 탭을 선택합니다.
    • 프로젝트가 관리하는 플로를 보려면 Managed 탭을 선택합니다.

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

플로 만들기#

히스토리
  • GitLab 19.3에서 ai_catalog_internal_visibility라는 기능 플래그와 함께 제한된 가시성이 도입됐습니다. 기본적으로 활성화됩니다.
  • GitLab 19.3 릴리스 기간에 GitLab for VS Code 6.87.0에서 gitlab.featureFlags.flowBuilder라는 VS Code 확장 설정과 함께 GitLab flow builder가 도입됐습니다. 기본적으로 비활성화됩니다. 베타 기능입니다.
  • GitLab 19.4에서 일반적으로 사용 가능해졌습니다. 기능 플래그 ai_catalog_internal_visibility가 제거됐습니다.

VS Code의 GitLab flow builder는 VS Code 확장 설정 gitlab.featureFlags.flowBuilder로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

프로젝트에서, AI Catalog로, 또는 VS Code의 GitLab flow builder로 플로를 만들 수 있습니다.

Note

프로젝트나 AI Catalog에서 특정 사용자 정의 에이전트를 호출하도록 사용자 정의 플로를 정의할 수는 없습니다. 사용자 정의 플로는 자체 YAML 구성을 기반으로 자체 에이전트를 만들어 사용합니다.

사전 요구 사항:

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

플로를 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. New flow를 선택합니다.
  4. Basic information에서 다음과 같이 합니다.
    1. Display name에 이름을 입력합니다.
    2. Description에 설명을 입력합니다.
  5. Visibility & access의 Visibility에서 Private, Restricted, Public 중 하나를 선택합니다.
  6. Configuration에서 다음과 같이 합니다.

    1. Flow를 선택합니다.

    2. 에디터에 플로 구성을 입력합니다.

  7. Create flow를 선택합니다.
  1. 상단 바에서 Search or go to > Explore를 선택합니다.
  2. AI Catalog를 선택한 다음 Flows 탭을 선택합니다.
  3. New flow를 선택합니다.
  4. Basic information에서 다음과 같이 합니다.
    1. Display name에 이름을 입력합니다.
    2. Description에 설명을 입력합니다.
  5. Visibility & access의 Visibility에서 Private 또는 Public을 선택합니다.
  6. Configuration에서 다음과 같이 합니다.

    1. Flow를 선택합니다.

    2. 에디터에 플로 구성을 입력합니다.

  7. Create flow를 선택합니다.

사전 요구 사항:

  • GitLab for VS Code 확장을 설치하고 구성합니다.
  • gitlab.featureFlags.flowBuilder VS Code 확장 설정을 활성화합니다.
  • 플로를 실행하려면 프로젝트에 GitLab Duo Agent Platform 이 켜져 있어야 하고, 최소한 Developer 권한이 있어야 합니다.
  • 플로를 AI Catalog에 게시하려면 관리 프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
Note

GitLab flow builder에서 플로를 게시하면 Private과 Public 가시성 옵션만 사용할 수 있습니다. Restricted 가시성 옵션은 GitLab UI에서 플로를 만들 때만 사용할 수 있습니다.

VS Code에서는 GitLab flow builder로 사용자 정의 플로를 만들 수 있습니다.

  1. VS Code에서 프로젝트를 열고 새 YAML 파일을 엽니다.

  2. YAML 파일에 있는 상태에서 Open GitLab Flow Builder를 선택합니다.

  3. 플로를 구성할 다음 컴포넌트를 선택합니다. 필드를 입력합니다.

    • Agent: 도구를 사용해 다단계 추론을 수행하고 목표가 완료될 때까지 반복합니다.
    • Tool: 고정된 입력으로 특정 도구 하나를 실행합니다. 결정적이며 LLM 이 관여하지 않습니다.
    • AI Task: 결과 하나를 만드는 LLM 호출을 한 번 수행합니다(예: 요약, 분류, 초안 작성). 다단계 작업이 아니라 모델 응답 하나가 필요할 때는 Agent 대신 AI Task를 사용합니다. Agent는 루프로 실행되며 도구를 사용할 수 있고, AI Task는 모델을 한 번 호출해 결과 하나를 반환합니다.
    • Human Input: 플로를 일시 중지하고 계속하기 전에 사용자 입력이나 승인을 기다립니다.

  4. 선택 사항. YAML 파일을 편집해 플로를 업데이트하고, GitLab flow builder에서 플로를 확인합니다.

    [!note] 플로 YAML은 flow registry v1 명세 구문을 따라야 합니다.

  5. 플로를 테스트하려면 Run을 선택합니다. Execution Console에서 Execute를 선택합니다. 플로 출력을 확인하고 필요에 따라 플로를 업데이트합니다.

  6. 플로를 저장하려면 Save 또는 Save as를 선택합니다.

  7. 플로를 AI Catalog에 게시하려면 Publish를 선택하고 필드를 입력합니다.

Note

GitLab flow builder로 플로를 AI Catalog에 게시할 수 있지만, 프로젝트에서 플로를 활성화하고 트리거를 연결하는 작업은 GitLab UI 에서만 할 수 있습니다.

플로가 AI Catalog에 나타납니다.

플로 활성화#

히스토리
  • GitLab 19.2에서 ai_catalog_bulk_item_consumer_create라는 기능 플래그와 함께 여러 프로젝트에 대해 공개 플로를 활성화하는 기능이 도입됐습니다. 기본적으로 활성화됩니다.
  • GitLab 19.4에서 기능 플래그 ai_catalog_bulk_item_consumer_create가 제거됐습니다.

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

프로젝트에서 플로를 활성화하면 다음과 같이 동작합니다.

  • 해당 프로젝트의 최상위 그룹에서도 동시에 플로가 활성화됩니다.
  • 어떤 이벤트가 플로를 트리거할지 지정하는 트리거를 추가합니다. 일부 트리거 이벤트에는 서비스 계정 사용자가 관여합니다. 자세한 내용은 복합 ID를 참고합니다.

사전 요구 사항:

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

플로를 활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. Managed 탭을 선택한 다음 활성화할 플로를 선택합니다.
  4. 오른쪽 상단에서 Enable을 선택합니다.
  5. Project에서 플로를 활성화할 프로젝트를 선택합니다.
  6. Add triggers에서 다음을 선택합니다.
  7. 선택 사항. 이벤트의 경우 Goal 필드에 플로가 수행할 작업을 지시하는 텍스트를 입력합니다. 자세한 내용은 목표 추가를 참고합니다.
  8. Enable을 선택합니다.

플로를 활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to > Explore를 선택합니다.

  2. AI Catalog를 선택한 다음 Flows 탭을 선택합니다.

  3. 활성화할 플로를 선택합니다.

  4. 오른쪽 상단에서 Enable을 선택합니다.

  5. Project에서 플로를 활성화할 프로젝트를 선택합니다.

    여러 프로젝트에 대해 공개 또는 제한된 플로를 활성화하려면 Project 드롭다운 목록에서 해당 프로젝트를 선택합니다. 최대 100 개 프로젝트를 선택할 수 있습니다.

  6. Add triggers에서 다음을 선택합니다.

  7. 선택 사항. 이벤트의 경우 Goal 필드에 플로가 수행할 작업을 지시하는 텍스트를 입력합니다. 자세한 내용은 목표 추가를 참고합니다.

  8. Enable을 선택합니다.

플로가 그룹과 프로젝트의 AI > Flows 페이지에 나타납니다. 이제 최상위 그룹에 속한 모든 프로젝트의 멤버가 자신의 프로젝트에서 플로를 활성화할 수 있습니다.

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

프로젝트에서 활성화#

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

사전 요구 사항:

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

프로젝트에서 플로를 활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 오른쪽 상단에서 Enable flow from group을 선택합니다.
  4. 드롭다운 목록에서 활성화할 플로를 선택합니다.
  5. Add triggers에서 다음을 선택합니다.
  6. 선택 사항. 이벤트의 경우 Goal 필드에 플로가 수행할 작업을 지시하는 텍스트를 입력합니다. 자세한 내용은 목표 추가를 참고합니다.
  7. Enable을 선택합니다.

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

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

트리거 조건 관리#

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

플로의 구성 페이지에서 해당 플로의 트리거를 관리할 수 있습니다.

트리거를 만드는 방법을 포함한 트리거에 대한 자세한 내용은 트리거를 참고합니다.

사전 요구 사항:

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

트리거 켜기 또는 끄기#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 관리하려는 플로를 선택합니다.
  4. Trigger conditions 섹션에서 켜거나 끄려는 트리거의 토글을 선택합니다.

트리거 편집#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 관리하려는 플로를 선택합니다.
  4. Trigger conditions 섹션에서 변경하려는 트리거의 Trigger actions(⋮) > Edit를 선택합니다.
  5. 변경한 뒤 Save changes를 선택합니다.

트리거 삭제#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 관리하려는 플로를 선택합니다.
  4. Trigger conditions 섹션에서 삭제하려는 트리거의 Trigger actions(⋮) > Delete를 선택합니다.
  5. 확인 대화 상자에서 Delete를 선택합니다.

플로 비활성화#

사전 요구 사항:

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

플로를 비활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 제거할 플로를 찾아 Actions (⋮) > Disable을 선택합니다.
  4. 확인 대화 상자에서 Disable을 선택합니다.

플로는 더 이상 프로젝트나 그룹에 나타나지 않으며 실행할 수 없습니다. 플로와 연결된 서비스 계정과 트리거도 함께 제거됩니다.

플로 사용#

사전 요구 사항:

  • 프로젝트에 대한 Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.
  • 플로가 프로젝트에서 활성화되어 있어야 합니다.

플로를 사용하려면 다음과 같이 합니다.

  1. 프로젝트에서 이슈, 머지 리퀘스트, 에픽 중 하나를 엽니다.

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

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

  3. 플로가 작업을 완료하면 확인 메시지와 함께 머지 준비가 된 변경 사항이나 인라인 댓글이 표시됩니다.

플로가 프로젝트에 대해 켜져 있다면 GitLab Duo Agentic Chat 슬래시 명령으로 플로를 시작할 수도 있습니다.

Warning

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

  • 사용자가 액세스할 수 있는 프로젝트.
  • 플로가 추가된 프로젝트.

플로 복제#

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

사전 요구 사항:

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

플로를 복제하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to > Explore를 선택합니다.
  2. AI Catalog를 선택한 다음 Flows 탭을 선택합니다.
  3. 복제할 플로를 선택합니다.
  4. 오른쪽 상단에서 Actions (⋮) > Duplicate를 선택합니다.
  5. 플로를 복제할 프로젝트를 선택합니다.
  6. 선택 사항. 변경할 필드를 편집합니다.
  7. Create flow를 선택합니다.

GitLab flow builder에는 전용 복제 동작이 없습니다. 플로의 복사본을 만들려면 Save As를 사용합니다. 열려 있는 플로가 새 파일로 저장됩니다. 복사한 YAML 파일을 flow builder에서 바로 열 수도 있습니다.

Note

복사본을 게시하면 원본과 연결되지 않은 새 카탈로그 항목이 만들어집니다.

플로 편집#

플로 구성을 변경하려면 플로를 편집합니다.

사전 요구 사항:

  • 관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 편집할 플로를 선택합니다.
  4. 오른쪽 상단에서 Edit를 선택합니다.
  5. 변경할 필드를 편집한 다음 Save changes를 선택합니다.
  1. VS Code에서 프로젝트를 열고 플로의 YAML 파일을 엽니다.
  2. YAML 파일에 있는 상태에서 Open GitLab Flow Builder를 선택합니다.
  3. GitLab flow builder에서 플로를 편집합니다.
  4. 플로를 테스트하려면 Run을 선택합니다. Execution console에서 Execute를 선택합니다. 플로 출력을 확인하고 필요에 따라 플로를 업데이트합니다.
  5. 플로를 저장하려면 Save 또는 Save as를 선택합니다.

플로 숨기기#

AI Catalog에서 플로를 제거하려면 플로를 숨깁니다.

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

사전 요구 사항:

  • 관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.

플로를 숨기려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 숨길 플로를 찾아 Actions (⋮) > Hide를 선택합니다.
  4. 확인 대화 상자에서 Confirm을 선택합니다.

플로 삭제#

플로를 삭제하면 인스턴스에서 제거됩니다. 관리 프로젝트가 아닌 다른 프로젝트가 해당 플로를 꺼 둔 경우에는 플로가 제거되지 않고 숨겨집니다.

사전 요구 사항:

  • 관리자여야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 삭제할 플로를 찾아 Actions (⋮) > Delete를 선택합니다.
  4. 확인 대화 상자에서 Delete를 선택합니다.

GitLab API 인증#

사용자 정의 플로에는 GITLAB_TOKEN으로 사용할 수 있는 GitLab OAuth 토큰이 있습니다(GITLAB_OAUTH_TOKEN으로도 노출됩니다). 이 토큰은 부여된 범위로 제한됩니다. ai_workflows 범위를 가진 GitLab API 엔드포인트에만 액세스할 수 있습니다. 토큰을 올바르게 보내더라도 그 범위를 벗어난 엔드포인트는 거부됩니다.

GitLab API를 직접 호출하는 스크립트를 작성한다면 토큰을 Authorization: Bearer 토큰으로 보냅니다. PRIVATE-TOKEN 헤더로 토큰을 보내면 API가 401 Unauthorized를 반환합니다.

curl --header "Authorization: Bearer $GITLAB_TOKEN" \
  "$GITLAB_BASE_URL/api/v4/user"

플로의 내장 도구와 glab CLI는 API를 올바르게 호출합니다.

그룹 공유와 플로#

그룹에서 플로를 활성화하면 관련 서비스 계정이 자동으로 만들어집니다. 이 서비스 계정은 다음과 같습니다.

  • 복합 ID 인증을 사용해 플로가 플로를 실행하는 사용자보다 더 많은 대상에 액세스하지 못하도록 보장합니다.
  • 플로를 활성화하는 최상위 그룹 아래의 모든 프로젝트에 멤버로 추가되므로, 플로는 해당 그룹 밖의 리소스에 액세스할 수 없습니다.
  • 최상위 그룹과 공유된 추가 그룹에 대한 액세스 권한을 부여받습니다. 그룹 공유에서 서비스 계정은 다른 그룹 멤버와 동일하게 취급됩니다.
Note

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

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

히스토리
  • GitLab 19.0에서 도입됐습니다.

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

사용자 정의 플로를 끄면 다음과 같이 동작합니다.

  • 사용자는 사용자 정의 플로를 만들거나 활성화하거나 비활성화하거나 실행할 수 없습니다.
  • 기존 사용자 정의 플로가 프로젝트의 AI > Flows > Enabled에 더 이상 보이지 않습니다.
  • 프로젝트에서 만든 사용자 정의 플로는 AI > Flows > Managed에 나타나지만 실행할 수 없습니다.
  • 파운데이셔널 플로는 계속 사용할 수 있습니다.

사전 요구 사항:

  • 그룹에 대한 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Custom and external agents and flows에서 Allow custom flows 체크박스를 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

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

사전 요구 사항:

  • 관리자여야 합니다.
  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Custom and external agents and flows에서 Allow custom flows 체크박스를 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

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

사용자 정의 플로

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

요약

사용자 정의 플로는 GitLab 프로젝트 전반의 복잡한 다단계 작업을 자동화하도록 직접 만들고 구성하는 AI 기반 워크플로입니다. 사용자 정의 플로를 만들 때 이를 관리할 프로젝트를 선택하고 플로를 공개, 비공개, 제한 중 하나로 지정합니다.

Model information
히스토리
  • GitLab 18.4에서 ai_catalog_flows라는 기능 플래그와 함께 실험으로 도입됐습니다. 기본적으로 비활성화됩니다.
  • GitLab 18.7에서 베타로 변경됐습니다.
  • GitLab 18.7에서 GitLab.com에서 활성화됐습니다.
  • GitLab 18.8에서 GitLab Self-Managed와 GitLab Dedicated에서 활성화됐습니다.
  • GitLab 18.8에서 기능 플래그 ai_catalog_flows가 기본적으로 활성화됐습니다.
  • 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 트리거 이벤트 유형이 merge_request_ready_flow_trigger라는 플래그와 함께 도입됐습니다. 기본적으로 비활성화됩니다.
  • GitLab 19.1에서 Merge request code conflict 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.1에서 Approved 액션이 있는 Merge request 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.1에서 기능 플래그 ai_flow_trigger_pipeline_hooks가 제거됐습니다.
  • GitLab 19.1에서 Work item created 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.1에서 Merge request ready 트리거 이벤트 유형이 일반적으로 사용 가능해졌습니다. 기능 플래그 merge_request_ready_flow_trigger가 제거됐습니다.
  • GitLab 19.2에서 Work item status changed 트리거 이벤트 유형이 도입됐습니다.
  • GitLab 19.2에서 기능 플래그 ai_catalog_flows가 제거됐습니다.
  • GitLab 19.2에서 일반적으로 사용 가능으로 변경됐습니다.
  • GitLab 19.4에서 Created 액션이 있는 Merge request 트리거 이벤트 유형이 도입됐습니다.

사용자 정의 플로는 GitLab 프로젝트 전반의 복잡한 다단계 작업을 자동화하도록 직접 만들고 구성하는 AI 기반 워크플로입니다.

사전 요구 사항#

플로 가시성#

히스토리
  • GitLab 18.7에서 비공개 플로를 볼 수 있는 권한이 확장됐습니다.
  • GitLab 19.3에서 ai_catalog_internal_visibility라는 기능 플래그와 함께 제한된 가시성이 도입됐습니다. 기본적으로 활성화됩니다.
  • GitLab 19.4에서 일반적으로 사용 가능해졌습니다. 기능 플래그 ai_catalog_internal_visibility가 제거됐습니다.

사용자 정의 플로를 만들 때 이를 관리할 프로젝트를 선택하고 플로를 공개, 비공개, 제한 중 하나로 지정합니다.

공개 플로:

  • 인스턴스의 누구나 볼 수 있고, 사전 요구 사항을 충족하는 모든 프로젝트에서 활성화할 수 있습니다.

제한된 플로:

  • 관리 프로젝트의 최상위 그룹에 속한 모든 프로젝트의 멤버가 보고 사용할 수 있습니다.
  • 같은 최상위 그룹의 다른 프로젝트에서 켤 수 있습니다.
  • 해당 최상위 그룹 밖에서는 보거나 켤 수 없습니다.
  • Explore의 AI Catalog에서는 볼 수 없습니다.
  • Explore의 AI Catalog가 아니라 프로젝트에서만 만들 수 있습니다.

해당 최상위 그룹 밖의 프로젝트가 플로를 켜 둔 경우에는 공개 플로를 제한 플로로 바꿀 수 없습니다.

비공개 플로:

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

관리 프로젝트 이외의 프로젝트가 플로를 켜 둔 경우에는 공개 또는 제한된 플로를 비공개로 바꿀 수 없습니다.

프로젝트의 플로 보기#

사전 요구 사항:

  • 프로젝트에 대한 Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

프로젝트와 연결된 플로 목록을 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
    • 프로젝트에서 활성화된 플로를 보려면 Enabled 탭을 선택합니다.
    • 프로젝트가 관리하는 플로를 보려면 Managed 탭을 선택합니다.

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

플로 만들기#

히스토리
  • GitLab 19.3에서 ai_catalog_internal_visibility라는 기능 플래그와 함께 제한된 가시성이 도입됐습니다. 기본적으로 활성화됩니다.
  • GitLab 19.3 릴리스 기간에 GitLab for VS Code 6.87.0에서 gitlab.featureFlags.flowBuilder라는 VS Code 확장 설정과 함께 GitLab flow builder가 도입됐습니다. 기본적으로 비활성화됩니다. 베타 기능입니다.
  • GitLab 19.4에서 일반적으로 사용 가능해졌습니다. 기능 플래그 ai_catalog_internal_visibility가 제거됐습니다.

VS Code의 GitLab flow builder는 VS Code 확장 설정 gitlab.featureFlags.flowBuilder로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

프로젝트에서, AI Catalog로, 또는 VS Code의 GitLab flow builder로 플로를 만들 수 있습니다.

Note

프로젝트나 AI Catalog에서 특정 사용자 정의 에이전트를 호출하도록 사용자 정의 플로를 정의할 수는 없습니다. 사용자 정의 플로는 자체 YAML 구성을 기반으로 자체 에이전트를 만들어 사용합니다.

사전 요구 사항:

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

플로를 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. New flow를 선택합니다.
  4. Basic information에서 다음과 같이 합니다.
    1. Display name에 이름을 입력합니다.
    2. Description에 설명을 입력합니다.
  5. Visibility & access의 Visibility에서 Private, Restricted, Public 중 하나를 선택합니다.
  6. Configuration에서 다음과 같이 합니다.

    1. Flow를 선택합니다.

    2. 에디터에 플로 구성을 입력합니다.

  7. Create flow를 선택합니다.
  1. 상단 바에서 Search or go to > Explore를 선택합니다.
  2. AI Catalog를 선택한 다음 Flows 탭을 선택합니다.
  3. New flow를 선택합니다.
  4. Basic information에서 다음과 같이 합니다.
    1. Display name에 이름을 입력합니다.
    2. Description에 설명을 입력합니다.
  5. Visibility & access의 Visibility에서 Private 또는 Public을 선택합니다.
  6. Configuration에서 다음과 같이 합니다.

    1. Flow를 선택합니다.

    2. 에디터에 플로 구성을 입력합니다.

  7. Create flow를 선택합니다.

사전 요구 사항:

  • GitLab for VS Code 확장을 설치하고 구성합니다.
  • gitlab.featureFlags.flowBuilder VS Code 확장 설정을 활성화합니다.
  • 플로를 실행하려면 프로젝트에 GitLab Duo Agent Platform 이 켜져 있어야 하고, 최소한 Developer 권한이 있어야 합니다.
  • 플로를 AI Catalog에 게시하려면 관리 프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
Note

GitLab flow builder에서 플로를 게시하면 Private과 Public 가시성 옵션만 사용할 수 있습니다. Restricted 가시성 옵션은 GitLab UI에서 플로를 만들 때만 사용할 수 있습니다.

VS Code에서는 GitLab flow builder로 사용자 정의 플로를 만들 수 있습니다.

  1. VS Code에서 프로젝트를 열고 새 YAML 파일을 엽니다.

  2. YAML 파일에 있는 상태에서 Open GitLab Flow Builder를 선택합니다.

  3. 플로를 구성할 다음 컴포넌트를 선택합니다. 필드를 입력합니다.

    • Agent: 도구를 사용해 다단계 추론을 수행하고 목표가 완료될 때까지 반복합니다.
    • Tool: 고정된 입력으로 특정 도구 하나를 실행합니다. 결정적이며 LLM 이 관여하지 않습니다.
    • AI Task: 결과 하나를 만드는 LLM 호출을 한 번 수행합니다(예: 요약, 분류, 초안 작성). 다단계 작업이 아니라 모델 응답 하나가 필요할 때는 Agent 대신 AI Task를 사용합니다. Agent는 루프로 실행되며 도구를 사용할 수 있고, AI Task는 모델을 한 번 호출해 결과 하나를 반환합니다.
    • Human Input: 플로를 일시 중지하고 계속하기 전에 사용자 입력이나 승인을 기다립니다.

  4. 선택 사항. YAML 파일을 편집해 플로를 업데이트하고, GitLab flow builder에서 플로를 확인합니다.

    [!note] 플로 YAML은 flow registry v1 명세 구문을 따라야 합니다.

  5. 플로를 테스트하려면 Run을 선택합니다. Execution Console에서 Execute를 선택합니다. 플로 출력을 확인하고 필요에 따라 플로를 업데이트합니다.

  6. 플로를 저장하려면 Save 또는 Save as를 선택합니다.

  7. 플로를 AI Catalog에 게시하려면 Publish를 선택하고 필드를 입력합니다.

Note

GitLab flow builder로 플로를 AI Catalog에 게시할 수 있지만, 프로젝트에서 플로를 활성화하고 트리거를 연결하는 작업은 GitLab UI 에서만 할 수 있습니다.

플로가 AI Catalog에 나타납니다.

플로 활성화#

히스토리
  • GitLab 19.2에서 ai_catalog_bulk_item_consumer_create라는 기능 플래그와 함께 여러 프로젝트에 대해 공개 플로를 활성화하는 기능이 도입됐습니다. 기본적으로 활성화됩니다.
  • GitLab 19.4에서 기능 플래그 ai_catalog_bulk_item_consumer_create가 제거됐습니다.

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

프로젝트에서 플로를 활성화하면 다음과 같이 동작합니다.

  • 해당 프로젝트의 최상위 그룹에서도 동시에 플로가 활성화됩니다.
  • 어떤 이벤트가 플로를 트리거할지 지정하는 트리거를 추가합니다. 일부 트리거 이벤트에는 서비스 계정 사용자가 관여합니다. 자세한 내용은 복합 ID를 참고합니다.

사전 요구 사항:

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

플로를 활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. Managed 탭을 선택한 다음 활성화할 플로를 선택합니다.
  4. 오른쪽 상단에서 Enable을 선택합니다.
  5. Project에서 플로를 활성화할 프로젝트를 선택합니다.
  6. Add triggers에서 다음을 선택합니다.
  7. 선택 사항. 이벤트의 경우 Goal 필드에 플로가 수행할 작업을 지시하는 텍스트를 입력합니다. 자세한 내용은 목표 추가를 참고합니다.
  8. Enable을 선택합니다.

플로를 활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to > Explore를 선택합니다.

  2. AI Catalog를 선택한 다음 Flows 탭을 선택합니다.

  3. 활성화할 플로를 선택합니다.

  4. 오른쪽 상단에서 Enable을 선택합니다.

  5. Project에서 플로를 활성화할 프로젝트를 선택합니다.

    여러 프로젝트에 대해 공개 또는 제한된 플로를 활성화하려면 Project 드롭다운 목록에서 해당 프로젝트를 선택합니다. 최대 100 개 프로젝트를 선택할 수 있습니다.

  6. Add triggers에서 다음을 선택합니다.

  7. 선택 사항. 이벤트의 경우 Goal 필드에 플로가 수행할 작업을 지시하는 텍스트를 입력합니다. 자세한 내용은 목표 추가를 참고합니다.

  8. Enable을 선택합니다.

플로가 그룹과 프로젝트의 AI > Flows 페이지에 나타납니다. 이제 최상위 그룹에 속한 모든 프로젝트의 멤버가 자신의 프로젝트에서 플로를 활성화할 수 있습니다.

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

프로젝트에서 활성화#

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

사전 요구 사항:

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

프로젝트에서 플로를 활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 오른쪽 상단에서 Enable flow from group을 선택합니다.
  4. 드롭다운 목록에서 활성화할 플로를 선택합니다.
  5. Add triggers에서 다음을 선택합니다.
  6. 선택 사항. 이벤트의 경우 Goal 필드에 플로가 수행할 작업을 지시하는 텍스트를 입력합니다. 자세한 내용은 목표 추가를 참고합니다.
  7. Enable을 선택합니다.

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

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

트리거 조건 관리#

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

플로의 구성 페이지에서 해당 플로의 트리거를 관리할 수 있습니다.

트리거를 만드는 방법을 포함한 트리거에 대한 자세한 내용은 트리거를 참고합니다.

사전 요구 사항:

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

트리거 켜기 또는 끄기#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 관리하려는 플로를 선택합니다.
  4. Trigger conditions 섹션에서 켜거나 끄려는 트리거의 토글을 선택합니다.

트리거 편집#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 관리하려는 플로를 선택합니다.
  4. Trigger conditions 섹션에서 변경하려는 트리거의 Trigger actions(⋮) > Edit를 선택합니다.
  5. 변경한 뒤 Save changes를 선택합니다.

트리거 삭제#

  1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 AI > Flows를 선택합니다.
  3. 관리하려는 플로를 선택합니다.
  4. Trigger conditions 섹션에서 삭제하려는 트리거의 Trigger actions(⋮) > Delete를 선택합니다.
  5. 확인 대화 상자에서 Delete를 선택합니다.

플로 비활성화#

사전 요구 사항:

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

플로를 비활성화하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 제거할 플로를 찾아 Actions (⋮) > Disable을 선택합니다.
  4. 확인 대화 상자에서 Disable을 선택합니다.

플로는 더 이상 프로젝트나 그룹에 나타나지 않으며 실행할 수 없습니다. 플로와 연결된 서비스 계정과 트리거도 함께 제거됩니다.

플로 사용#

사전 요구 사항:

  • 프로젝트에 대한 Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.
  • 플로가 프로젝트에서 활성화되어 있어야 합니다.

플로를 사용하려면 다음과 같이 합니다.

  1. 프로젝트에서 이슈, 머지 리퀘스트, 에픽 중 하나를 엽니다.

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

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

  3. 플로가 작업을 완료하면 확인 메시지와 함께 머지 준비가 된 변경 사항이나 인라인 댓글이 표시됩니다.

플로가 프로젝트에 대해 켜져 있다면 GitLab Duo Agentic Chat 슬래시 명령으로 플로를 시작할 수도 있습니다.

Warning

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

  • 사용자가 액세스할 수 있는 프로젝트.
  • 플로가 추가된 프로젝트.

플로 복제#

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

사전 요구 사항:

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

플로를 복제하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to > Explore를 선택합니다.
  2. AI Catalog를 선택한 다음 Flows 탭을 선택합니다.
  3. 복제할 플로를 선택합니다.
  4. 오른쪽 상단에서 Actions (⋮) > Duplicate를 선택합니다.
  5. 플로를 복제할 프로젝트를 선택합니다.
  6. 선택 사항. 변경할 필드를 편집합니다.
  7. Create flow를 선택합니다.

GitLab flow builder에는 전용 복제 동작이 없습니다. 플로의 복사본을 만들려면 Save As를 사용합니다. 열려 있는 플로가 새 파일로 저장됩니다. 복사한 YAML 파일을 flow builder에서 바로 열 수도 있습니다.

Note

복사본을 게시하면 원본과 연결되지 않은 새 카탈로그 항목이 만들어집니다.

플로 편집#

플로 구성을 변경하려면 플로를 편집합니다.

사전 요구 사항:

  • 관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 편집할 플로를 선택합니다.
  4. 오른쪽 상단에서 Edit를 선택합니다.
  5. 변경할 필드를 편집한 다음 Save changes를 선택합니다.
  1. VS Code에서 프로젝트를 열고 플로의 YAML 파일을 엽니다.
  2. YAML 파일에 있는 상태에서 Open GitLab Flow Builder를 선택합니다.
  3. GitLab flow builder에서 플로를 편집합니다.
  4. 플로를 테스트하려면 Run을 선택합니다. Execution console에서 Execute를 선택합니다. 플로 출력을 확인하고 필요에 따라 플로를 업데이트합니다.
  5. 플로를 저장하려면 Save 또는 Save as를 선택합니다.

플로 숨기기#

AI Catalog에서 플로를 제거하려면 플로를 숨깁니다.

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

사전 요구 사항:

  • 관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.

플로를 숨기려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 숨길 플로를 찾아 Actions (⋮) > Hide를 선택합니다.
  4. 확인 대화 상자에서 Confirm을 선택합니다.

플로 삭제#

플로를 삭제하면 인스턴스에서 제거됩니다. 관리 프로젝트가 아닌 다른 프로젝트가 해당 플로를 꺼 둔 경우에는 플로가 제거되지 않고 숨겨집니다.

사전 요구 사항:

  • 관리자여야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 그룹이나 프로젝트를 찾습니다.
  2. AI > Flows를 선택합니다.
  3. 삭제할 플로를 찾아 Actions (⋮) > Delete를 선택합니다.
  4. 확인 대화 상자에서 Delete를 선택합니다.

GitLab API 인증#

사용자 정의 플로에는 GITLAB_TOKEN으로 사용할 수 있는 GitLab OAuth 토큰이 있습니다(GITLAB_OAUTH_TOKEN으로도 노출됩니다). 이 토큰은 부여된 범위로 제한됩니다. ai_workflows 범위를 가진 GitLab API 엔드포인트에만 액세스할 수 있습니다. 토큰을 올바르게 보내더라도 그 범위를 벗어난 엔드포인트는 거부됩니다.

GitLab API를 직접 호출하는 스크립트를 작성한다면 토큰을 Authorization: Bearer 토큰으로 보냅니다. PRIVATE-TOKEN 헤더로 토큰을 보내면 API가 401 Unauthorized를 반환합니다.

curl --header "Authorization: Bearer $GITLAB_TOKEN" \
  "$GITLAB_BASE_URL/api/v4/user"

플로의 내장 도구와 glab CLI는 API를 올바르게 호출합니다.

그룹 공유와 플로#

그룹에서 플로를 활성화하면 관련 서비스 계정이 자동으로 만들어집니다. 이 서비스 계정은 다음과 같습니다.

  • 복합 ID 인증을 사용해 플로가 플로를 실행하는 사용자보다 더 많은 대상에 액세스하지 못하도록 보장합니다.
  • 플로를 활성화하는 최상위 그룹 아래의 모든 프로젝트에 멤버로 추가되므로, 플로는 해당 그룹 밖의 리소스에 액세스할 수 없습니다.
  • 최상위 그룹과 공유된 추가 그룹에 대한 액세스 권한을 부여받습니다. 그룹 공유에서 서비스 계정은 다른 그룹 멤버와 동일하게 취급됩니다.
Note

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

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

히스토리
  • GitLab 19.0에서 도입됐습니다.

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

사용자 정의 플로를 끄면 다음과 같이 동작합니다.

  • 사용자는 사용자 정의 플로를 만들거나 활성화하거나 비활성화하거나 실행할 수 없습니다.
  • 기존 사용자 정의 플로가 프로젝트의 AI > Flows > Enabled에 더 이상 보이지 않습니다.
  • 프로젝트에서 만든 사용자 정의 플로는 AI > Flows > Managed에 나타나지만 실행할 수 없습니다.
  • 파운데이셔널 플로는 계속 사용할 수 있습니다.

사전 요구 사항:

  • 그룹에 대한 Owner 권한이 있어야 합니다.
  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Custom and external agents and flows에서 Allow custom flows 체크박스를 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

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

사전 요구 사항:

  • 관리자여야 합니다.
  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Custom and external agents and flows에서 Allow custom flows 체크박스를 선택하거나 선택 해제합니다.
  5. Save changes를 선택합니다.

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