모든 GitLab Duo 기능은 기본 모델을 사용합니다. GitLab은 성능 최적화를 위해 기본 모델을 업데이트할 수 있습니다. 일부 기능의 경우 변경할 때까지 유지되는 다른 모델을 선택할 수 있습니다.

기본 모델#

이 표에는 에이전트 플랫폼의 각 기능에 대한 기본 모델이 나열되어 있습니다.

지원되는 모델#

이 표에는 에이전트 플랫폼의 기능에 대해 선택할 수 있는 모델이 나열되어 있습니다.

각주:

• 이 모델은 제한된 벤더 측 데이터 보존 대상입니다.

기능에 대한 모델 선택#

DETAILS: Offering: GitLab.com

• GitLab 18.4에서 베타로 변경됨.

• GitLab 18.4에서 활성화됨.

• GitLab 18.4에서 duo_agent_platform_model_selection이라는 플래그와 함께 GitLab Duo 에이전트 플랫폼의 모델 선택이 도입됨. 기본적으로 비활성화됨.

• GitLab 18.5에서 일반 제공. 기능 플래그 ai_model_switching 활성화됨.

• GitLab 18.6에서 기능 플래그 duo_agent_platform_model_selection 활성화됨.

• GitLab 18.7에서 기능 플래그 ai_model_switching 제거됨.

• GitLab 18.9에서 기능 플래그 duo_agent_platform_model_selection 제거됨.

• GitLab 19.1에서 Code Review Flow에 대한 LLM이 Claude Sonnet 4.6 Vertex로 업데이트됨.

• GitLab 19.1에서 Code Review Flow에 대해 GitLab Duo 코드 리뷰와 별도의 모델 선택이 도입됨. Agentic Code Review 설정을 사용합니다.

• GitLab 19.1에서 Code Review Flow에 대한 선택 가능한 모델로 GPT-5.2 및 GPT-5.3 Codex가 추가됨.

• GitLab 19.1에서 GitLab Duo 에이전틱 Chat을 특정 모델로 제한하는 기능이 추가됨.

• GitLab 19.2에서 Security Review Flow가 모델 선택에 추가됨.

최상위 그룹에서 기능에 대한 기본 모델을 선택할 수 있습니다. 선택한 모델은 모든 하위 그룹 및 프로젝트의 해당 기능에 적용됩니다.

사전 요구 사항:

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

• 모델을 선택하는 그룹이 최상위 그룹이어야 합니다.

• GitLab 18.3 이상에서 여러 GitLab Duo 네임스페이스에 속하는 경우 기본 네임스페이스를 설정해야 합니다.

에이전틱 Chat의 모델 선택#

에이전틱 Chat의 모델을 선택하려면:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

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

3. Manage models를 선택합니다.

4. GitLab Duo Agentic Chat 섹션으로 이동합니다.

5. 드롭다운 목록에서 모델을 선택하여 기본 모델로 설정합니다.

6. 선택 사항. 에이전틱 Chat에서 사용자가 선택할 수 있는 모델을 제한하려면:

   Available models 아래에서 Configure를 선택합니다.

   • Available models: Agentic Chat 대화 상자에서 Restrict to specific models 체크박스를 선택합니다.

   • 에이전틱 Chat에서 사용할 모델을 선택합니다.

   • Save를 선택합니다.

   에이전틱 Chat을 특정 모델로 제한하지 않으면, 사용자는 GitLab이 관리하는 모든 모델 중에서 선택할 수 있습니다.

비에이전틱 Chat 기능의 모델 선택#

에이전틱 Chat 외의 기능에 대한 모델을 선택하려면:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

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

3. Configure features를 선택합니다.

4. GitLab Duo Agent Platform 섹션으로 이동합니다.

5. 드롭다운 목록에서 모델을 선택하여 기본 모델로 설정합니다.

6. 선택 사항. 섹션의 모든 기능에 모델을 적용하려면 Apply to all을 선택합니다.

GitLab Duo CLI의 모델을 지정하려면 모델 선택을 참조하세요.

적합한 모델 선택#

많은 사용 사례에서 Claude Haiku 4.5 또는 GPT-5.4 Mini와 같이 더 빠르고 비용 효율적인 모델로 시작하는 것이 최적의 접근 방식일 수 있습니다. 이 접근 방식을 위해:

• Claude Haiku 4.5 또는 GPT-5.4 Mini를 선택합니다.

• 사용 사례를 철저히 테스트합니다.

• 성능이 요구 사항을 충족하는지 평가합니다.

• 특정 기능 격차에 필요한 경우에만 업그레이드합니다.

다음 경우에 이 접근 방식을 사용할 수 있습니다:

• 탐색적이거나 대용량 작업

• 엄격한 지연 시간 요구 사항이 있는 애플리케이션

• 비용에 민감한 구현

문제 해결#

기본값 이외의 모델을 선택할 때 다음과 같은 문제가 발생할 수 있습니다.

모델을 사용할 수 없음#

GitLab Duo AI 네이티브 기능에 기본 GitLab 모델을 사용하는 경우 GitLab은 사용자에게 알리지 않고 최적의 성능과 신뢰성을 유지하기 위해 기본 모델을 변경할 수 있습니다.

GitLab Duo AI 네이티브 기능에 특정 모델을 선택했는데 해당 모델을 사용할 수 없는 경우 자동 폴백이 없습니다. 이 모델을 사용하는 기능을 사용할 수 없습니다.

기본 GitLab Duo 네임스페이스 없음#

선택된 모델과 함께 GitLab Duo 기능을 사용할 때 기본 GitLab Duo 네임스페이스를 설정해야 한다는 오류가 발생할 수 있습니다.

이 문제는 여러 GitLab Duo 네임스페이스에 속하거나 GitLab 원격이 구성되지 않은 로컬 프로젝트에서 작업할 때 발생합니다.

이를 해결하려면 기본 GitLab Duo 네임스페이스를 설정합니다.

IDE에서 에이전틱 Chat의 모델 선택이 작동하지 않음#

IDE에서 에이전틱 Chat의 모델을 선택할 때 모델 선택이 작동하지 않을 수 있습니다.

이를 해결하려면:

• IDE의 연결 유형이 WebSocket으로 설정되어 있는지 확인합니다.

• 네트워크 관리자에게 GitLab 인스턴스로의 WebSocket 트래픽이 허용되는지 확인을 요청합니다.