GitLab Duo Agent Platform 가용성 제어
GitLab v19.2Offering: GitLab Self-Managed
GitLab Duo Agent Platform은 기본적으로 켜져 있습니다. Agent Platform을 켜거나 끌 수 있습니다: GitLab.com: 최상위 그룹의 경우. GitLab Self-Managed: 인스턴스의 경우.
GitLab Duo Agent Platform은 기본적으로 켜져 있습니다. Agent Platform에는 기능 집합이 포함됩니다.
Agent Platform을 켜거나 끌 수 있습니다:
-
GitLab.com: 최상위 그룹의 경우.
-
GitLab Self-Managed: 인스턴스의 경우.
Agent Platform에 대한 도구 거버넌스를 구성하려면 에이전트 도구 거버넌스를 참조하세요.
GitLab Duo Agent Platform 켜기 또는 끄기#
GitLab.com에서#
히스토리
- GitLab 18.10에서 GitLab Credits가 있는 GitLab.com Free 티어에서 사용 가능.
사전 조건:
- 최상위 그룹에 대한 Owner 권한.
최상위 그룹에 대해 Agent Platform을 켜거나 끄려면:
-
상단 바에서 검색 또는 이동을 선택하고 최상위 그룹을 찾습니다.
-
설정 > GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo Agent Platform 아래에서 GitLab Duo 에이전틱 Chat, 에이전트 및 플로우 켜기 확인란을 선택하거나 해제합니다.
-
변경 사항 저장을 선택합니다.
Agent Platform 가용성이 모든 서브그룹과 프로젝트에 대해 변경됩니다.
Agent Platform이 꺼지면 다음 기능이 숨겨집니다:
-
플로우 및 기본 에이전트에 대한 관련 설정.
-
AI Catalog.
GitLab Self-Managed에서#
사전 조건:
- 관리자 액세스.
인스턴스에 대해 Agent Platform을 켜거나 끄려면:
-
오른쪽 상단 모서리에서 관리자를 선택합니다.
-
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo Agent Platform 아래에서 GitLab Duo 에이전틱 Chat, 에이전트 및 플로우 켜기 확인란을 선택하거나 해제합니다.
-
변경 사항 저장을 선택합니다.
Agent Platform이 꺼지면 다음 기능이 숨겨집니다:
-
플로우 및 기본 에이전트에 대한 관련 설정.
-
AI Catalog.
GitLab Duo 항상 켜기로 잠그기#
히스토리
- GitLab 19.1에서 도입됨.
그룹 또는 프로젝트 설정에 관계없이 모든 사용자에 대해 GitLab Duo를 켭니다.
GitLab Duo 가용성을 항상 켜짐으로 설정하면 실험 및 베타 기능은 자동으로 켜지지 않습니다. 실험 및 베타 기능을 사용하려면 별도로 켜야 합니다.
사전 조건:
- 최상위 그룹에 대한 Owner 권한.
최상위 그룹에 대해 GitLab Duo를 항상 켜기로 잠그려면:
-
상단 바에서 검색 또는 이동을 선택하고 최상위 그룹을 찾습니다.
-
왼쪽 사이드바에서 설정 > GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo 가용성 아래에서 항상 켜짐을 선택합니다.
-
변경 사항 저장을 선택합니다.
GitLab Duo가 모든 서브그룹과 프로젝트에 대해 항상 켜짐으로 잠깁니다. 서브그룹 또는 프로젝트에 대한 Owner 권한이 있는 사용자는 GitLab Duo를 끌 수 없습니다.
사전 조건:
- 관리자 액세스.
인스턴스에 대해 GitLab Duo를 항상 켜기로 잠그려면:
-
오른쪽 상단 모서리에서 관리자를 선택합니다.
-
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo 가용성 아래에서 항상 켜짐을 선택합니다.
-
변경 사항 저장을 선택합니다.
GitLab Duo가 모든 그룹, 서브그룹, 프로젝트에 대해 항상 켜짐으로 잠깁니다. 그룹, 서브그룹 또는 프로젝트에 대한 Owner 권한이 있는 사용자는 GitLab Duo를 끌 수 없습니다.
GitLab Duo 켜기 또는 끄기#
GitLab Duo는 기본적으로 켜져 있습니다. GitLab Duo를 켜거나 끌 수 있습니다:
-
GitLab.com: 최상위 그룹, 다른 그룹 또는 서브그룹, 프로젝트의 경우.
-
GitLab Self-Managed: 인스턴스, 그룹 또는 서브그룹, 프로젝트의 경우.
GitLab.com에서#
히스토리
- GitLab 18.10에서 GitLab Credits가 있는 GitLab.com Free 티어에서 사용 가능.
최상위 그룹의 경우#
사전 조건:
- 최상위 그룹에 대한 Owner 권한.
최상위 그룹에 대한 GitLab Duo 가용성을 변경하려면:
-
상단 바에서 검색 또는 이동을 선택하고 최상위 그룹을 찾습니다.
-
설정 > GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo 가용성 아래에서 옵션을 선택합니다.
-
변경 사항 저장을 선택합니다.
GitLab Duo 가용성이 모든 서브그룹과 프로젝트에 대해 변경됩니다.
그룹 또는 서브그룹의 경우#
사전 조건:
- 그룹 또는 서브그룹에 대한 Owner 권한.
그룹 또는 서브그룹에 대한 GitLab Duo 가용성을 변경하려면:
-
상단 바에서 검색 또는 이동을 선택하고 그룹 또는 서브그룹을 찾습니다.
-
설정 > 일반을 선택합니다.
-
GitLab Duo 기능을 확장합니다.
-
GitLab Duo 가용성 아래에서 옵션을 선택합니다.
-
변경 사항 저장을 선택합니다.
GitLab Duo 가용성이 모든 서브그룹과 프로젝트에 대해 변경됩니다.
프로젝트의 경우#
사전 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 권한.
프로젝트에 대한 GitLab Duo 가용성을 변경하려면:
-
상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
왼쪽 사이드바에서 설정 > 일반을 선택합니다.
-
GitLab Duo를 확장합니다.
-
GitLab Duo 토글을 켜거나 끕니다.
-
변경 사항 저장을 선택합니다.
GitLab Self-Managed에서#
인스턴스의 경우#
사전 조건:
- 관리자 액세스.
인스턴스에 대한 GitLab Duo 가용성을 변경하려면:
-
오른쪽 상단 모서리에서 관리자를 선택합니다.
-
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo 가용성 아래에서 옵션을 선택합니다.
-
변경 사항 저장을 선택합니다.
그룹 또는 서브그룹의 경우#
사전 조건:
- 그룹 또는 서브그룹에 대한 Owner 권한.
그룹 또는 서브그룹에 대한 GitLab Duo 가용성을 변경하려면:
-
상단 바에서 검색 또는 이동을 선택하고 그룹 또는 서브그룹을 찾습니다.
-
설정 > 일반을 선택합니다.
-
GitLab Duo 기능을 확장합니다.
-
GitLab Duo 가용성 아래에서 옵션을 선택합니다.
-
변경 사항 저장을 선택합니다.
GitLab Duo 가용성이 모든 서브그룹과 프로젝트에 대해 변경됩니다.
프로젝트의 경우#
사전 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 권한.
프로젝트에 대한 GitLab Duo 가용성을 변경하려면:
-
상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
왼쪽 사이드바에서 설정 > 일반을 선택합니다.
-
GitLab Duo를 확장합니다.
-
GitLab Duo 토글을 켜거나 끕니다.
-
변경 사항 저장을 선택합니다.
GitLab Duo Core 켜기 또는 끄기#
GitLab Duo Core는 Premium 및 Ultimate 구독에 포함됩니다.
-
GitLab 17.11 이하의 기존 고객이라면 GitLab Duo Core 기능을 켜야 합니다.
-
GitLab 18.0 이상의 신규 고객이라면 GitLab Duo Core가 자동으로 켜지므로 추가 작업이 필요 없습니다.
2025년 5월 15일 이전에 Premium 또는 Ultimate 구독을 사용하던 기존 고객의 경우 GitLab 18.0 이상으로 업그레이드할 때 GitLab Duo Core를 사용하려면 켜야 합니다.
GitLab.com에서#
히스토리
- GitLab 18.10에서 GitLab Credits가 있는 GitLab.com Free 티어에서 사용 가능.
사전 조건:
- 최상위 그룹에 대한 Owner 권한.
최상위 그룹에 대한 GitLab Duo Core 가용성을 변경하려면:
-
상단 바에서 검색 또는 이동을 선택하고 최상위 그룹을 찾습니다.
-
설정 > GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo 가용성 아래에서 옵션을 선택합니다.
-
GitLab Duo Core 아래에서 GitLab Duo Core 기능 켜기 확인란을 선택하거나 해제합니다. GitLab Duo 가용성으로 항상 꺼짐을 선택한 경우 이 설정에 액세스할 수 없습니다.
-
변경 사항 저장을 선택합니다.
변경 사항이 적용되는 데 최대 10분이 걸릴 수 있습니다.
GitLab Self-Managed에서#
사전 조건:
- 관리자 액세스.
인스턴스에 대한 GitLab Duo Core 가용성을 변경하려면:
-
오른쪽 상단 모서리에서 관리자를 선택합니다.
-
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
GitLab Duo 가용성 아래에서 옵션을 선택합니다.
-
GitLab Duo Core 아래에서 GitLab Duo Core 기능 켜기 확인란을 선택하거나 해제합니다. GitLab Duo 가용성으로 항상 꺼짐을 선택한 경우 이 설정에 액세스할 수 없습니다.
-
변경 사항 저장을 선택합니다.
베타 및 실험 기능 켜기#
실험 및 베타 상태인 GitLab Duo 기능은 기본적으로 꺼져 있습니다. 이 기능들은 테스팅 계약의 적용을 받습니다.
GitLab.com에서#
히스토리
- GitLab 18.10에서 GitLab Credits가 있는 GitLab.com Free 티어에서 사용 가능.
사전 조건:
- 최상위 그룹에 대한 Owner 권한.
최상위 그룹에 대해 GitLab Duo 실험 및 베타 기능을 켜려면:
-
상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 설정 > GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
기능 미리보기 아래에서 실험 및 베타 GitLab Duo 기능 켜기를 선택합니다.
-
변경 사항 저장을 선택합니다.
이 설정은 그룹에 속한 모든 프로젝트로 연속됩니다.
GitLab Self-Managed에서#
GitLab 17.4 이상에서는 다음 지침에 따라 GitLab Self-Managed 인스턴스에 대해 GitLab Duo 실험 및 베타 기능을 켜세요.
사전 조건:
- 관리자 액세스.
인스턴스에 대해 GitLab Duo 실험 및 베타 기능을 켜려면:
-
오른쪽 상단 모서리에서 관리자를 선택합니다.
-
왼쪽 사이드바에서 설정 > GitLab Duo를 선택합니다.
-
구성 변경을 확장합니다.
-
기능 미리보기 아래에서 실험 및 베타 GitLab Duo 기능 사용을 선택합니다.
-
변경 사항 저장을 선택합니다.
사전 조건:
인스턴스에 대해 GitLab Duo 실험 및 베타 기능을 켜려면:
-
오른쪽 상단 모서리에서 관리자를 선택합니다.
-
왼쪽 사이드바에서 설정 > GitLab Duo를 선택합니다.
-
구성 변경을 확장합니다.
-
기능 미리보기 아래에서 실험 및 베타 GitLab Duo 기능 사용을 선택합니다.
-
변경 사항 저장을 선택합니다.
-
GitLab Duo Chat이 즉시 작동하도록 하려면 구독을 수동으로 동기화합니다.
구독을 수동으로 동기화하지 않으면 인스턴스에서 GitLab Duo Chat을 활성화하는 데 최대 24시간이 걸릴 수 있습니다.
문제 해결#
Agent Platform을 켜거나 끌 때 다음 문제가 발생할 수 있습니다.
GitLab Self-Managed에서 구성 변경이 표시되지 않음#
GitLab Self-Managed에서 구성 변경이 표시되지 않을 수 있습니다. 구성 변경은 인스턴스에 다음 중 하나가 있을 때만 표시됩니다:
-
활성 GitLab Duo Pro, Enterprise, 또는 Self-Hosted 애드온(유료 라이선스 포함)
-
활성 GitLab Credits
이러한 요구 사항이 없으면 UI를 통해 GitLab Duo 가용성을 제어할 수 없습니다. GitLab Duo를 끄려면 Rails 콘솔 또는 API를 대신 사용하세요.
Rails 콘솔 세션에서 다음 명령어를 실행합니다:
ApplicationSetting.current.update!(duo_features_enabled: false, lock_duo_features_enabled: true)
변경 사항을 확인하려면 다음 명령어를 실행합니다:
Gitlab::CurrentSettings.duo_features_enabled # => false
Gitlab::CurrentSettings.duo_never_on? # => true
또는 api 범위가 있는 관리자 토큰으로 애플리케이션 설정 API에 PUT 요청을 보냅니다:
curl --request PUT \
--header "PRIVATE-TOKEN: <admin_token>" \
--data "duo_availability=never_on" \
"https://<your-gitlab-host>/api/v4/application_settings"
GitLab Duo 패널이 사라지기 전에 브라우저를 새로 고쳐야 할 수 있습니다.