머지 리퀘스트에서 GitLab Duo 사용
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 페이지에는 개발 중인 제품, 기능에 대한 정보가 포함되어 있습니다. GitLab Duo는 머지 리퀘스트의 수명 주기 동안 맥락에 맞는 정보를 제공하도록 설계되었습니다. 머지 리퀘스트를 생성하거나 편집할 때 GitLab Duo Merge Request Summary를 사용해 머지 리퀘스트 설명을 작성합니다.
이 페이지에는 개발 중인 제품, 기능에 대한 정보가 포함되어 있습니다. 이 정보는 참고 목적으로만 제공되며, 구매 또는 계획 시 이 정보에 의존하지 마십시오.
GitLab Duo는 머지 리퀘스트의 수명 주기 동안 맥락에 맞는 정보를 제공하도록 설계되었습니다.
코드 변경 사항 요약으로 설명 생성#
Model information
히스토리
- GitLab 16.2에서 실험 기능으로 도입되었습니다.
- GitLab 16.10에서 베타로 변경되었습니다.
- GitLab 17.6 이상에서 GitLab Duo 애드온을 요구하도록 변경되었습니다.
- GitLab 17.10에서 LLM이 Claude 3.7 Sonnet으로 업데이트되었습니다
- GitLab 17.11에서 피처 플래그
add_ai_summary_for_new_mr가 기본적으로 활성화되었습니다. - GitLab 18.0에서 Premium을 포함하도록 변경되었습니다.
- GitLab 18.1에서 LLM이 Claude 4.0 Sonnet으로 업데이트되었습니다.
머지 리퀘스트를 생성하거나 편집할 때 GitLab Duo Merge Request Summary를 사용해 머지 리퀘스트 설명을 작성합니다.
-
Description 필드에서 설명을 넣을 위치에 커서를 둡니다.
-
텍스트 영역 위 툴바에서 Summarize code changes([tanuki-ai])를 선택합니다.
커서가 있던 위치에 설명이 삽입됩니다.
이 기능에 대한 피드백은 이슈 443236에 남길 수 있습니다.
데이터 사용: 소스 브랜치의 헤드와 대상 브랜치 간 변경 diff가 대형 언어 모델로 전송됩니다.
GitLab Duo를 사용하여 코드 리뷰#
GitLab Duo는 머지 리퀘스트에 잠재적 오류가 있는지 검토하고 표준 준수 여부에 대한 피드백을 제공할 수 있습니다.
GitLab Duo에 리뷰를 요청하면 애드온에 따라 두 가지 코드 리뷰 기능 중 하나가 자동으로 실행됩니다. 그룹에 대한 Owner 권한이 있는 사용자는 모든 사용자에게 적용할 기능을 구성할 수 있습니다.
| 항목 | Code Review Flow | GitLab Duo Code Review |
|---|---|---|
| 리뷰어 | @GitLabDuo |
@GitLabDuo |
| 유형 | 에이전트 방식 | 비에이전트 방식 |
| 필수 애드온 | 없음. GitLab Credits를 사용합니다. | GitLab Duo Enterprise |
| 컨텍스트 인식 | 리포지터리 구조와 파일 간 의존성에 대한 향상된 이해 | 머지 리퀘스트와 그 안의 파일 diff에 집중 |
| 분석 | 다단계 에이전트 추론 | 단일 패스 |
| 후속 리뷰 | 이전 GitLab Duo 스레드와 답글을 사용해 새 변경 사항을 평가합니다 | ❌ |
| 세션 생성 | ✅ | ❌ |
| 자동 리뷰 | ✅ | ✅ |
| 사용자 지정 지시 사항 | ✅ | ✅ |
| 사용자 지정 댓글 | ✅ | ✅ |
실행되는 리뷰 기능 결정#
기본적으로 GitLab이 실행하는 코드 리뷰 기능은 리뷰를 시작한 사용자에 따라 달라집니다.
| 리뷰 트리거 | 시작 사용자 |
|---|---|
| 수동으로 리뷰 요청 | 리뷰를 요청한 사용자. |
| 머지 리퀘스트 생성(초안 아님) | 머지 리퀘스트 작성자. |
| 초안 머지 리퀘스트를 준비 상태로 표시 | 머지 리퀘스트 작성자. |
| Start a new review on push가 켜진 상태에서 소스 브랜치에 새 커밋 푸시. Code Review Flow에만 해당합니다. | 머지 리퀘스트 작성자. |
시작한 사용자에게 GitLab Duo Enterprise 시트가 있으면 GitLab Duo Code Review가 실행됩니다. 없으면 Code Review Flow가 실행됩니다. 두 기능은 같은 프로젝트에서 함께 실행될 수 있습니다.
그룹에 대한 Owner 권한이 있는 사용자는 시트 유형과 관계없이 모든 리뷰가 Code Review Flow를 사용하도록 구성할 수 있습니다. Code Review Flow가 실행되면 크레딧 사용량은 리뷰를 시작한 사용자에게 귀속됩니다.
어떤 기능이 리뷰를 실행하는지 확인하려면 머지 리퀘스트의 활동 피드를 확인합니다. Code Review Flow는 실행될 때 리뷰 세션을 시작합니다. 리뷰 세션이 표시되지 않으면 GitLab Duo Code Review가 리뷰를 실행한 것입니다.
리뷰가 끝난 뒤에는 프로젝트 세션에서 Code Review Flow 세션을 찾아볼 수도 있습니다.
GitLab Duo Enterprise 시트에 대해 Code Review Flow 켜기#
히스토리
- GitLab 19.2에서
duo_code_review_dap_routing_consent_enabled라는 피처 플래그와 함께 도입되었습니다. 기본적으로 활성화됩니다. - GitLab 19.3에서 일반적으로 사용 가능합니다. 피처 플래그
duo_code_review_dap_routing_consent_enabled가 제거되었습니다.
GitLab Duo Enterprise 시트 보유자가 GitLab Credits를 소비하는 기능을 사용하지 않도록, 이들이 시작하는 코드 리뷰는 기본적으로 GitLab Duo Code Review를 사용합니다. 이 동작은 Owner 권한이 있는 사용자가 그룹에 Code Review Flow를 켠 경우에도 그대로 적용됩니다.
이 기본값을 변경하여 사용자의 시트와 관계없이 모든 코드 리뷰가 Code Review Flow를 사용하도록 구성할 수 있습니다.
GitLab Duo Enterprise 시트의 기본 코드 리뷰 기능을 재정의하려면 다음 단계를 수행합니다:
사전 요구 사항:
- 최상위 그룹에 대한 Owner 권한.
- 최상위 그룹에서 Code Review Flow가 켜져 있고 올바르게 구성되어 있어야 합니다.
- 상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
- Settings > GitLab Duo를 선택합니다.
- Change configuration을 선택합니다.
- Flow execution > Allow foundational flows 아래에서 Code Review Flow 체크박스를 선택 해제한 다음 다시 선택합니다.
- 확인 대화 상자에서 Enable Code Review Flow를 선택합니다.
사전 요구 사항:
- 그룹에 대한 Maintainer 또는 Owner 권한.
- 인스턴스에서 Code Review Flow가 켜져 있고 올바르게 구성되어 있어야 합니다.
- 상단 바에서 Search or go to를 선택하고 그룹 또는 하위 그룹을 찾습니다.
- Settings > General을 선택합니다.
- GitLab Duo features를 확장합니다.
- Flow execution 아래에서 Code Review Flow 체크박스를 선택 해제하고 Save changes를 선택합니다.
- GitLab Duo features를 다시 확장한 다음, Flow execution 아래에서 Code Review Flow 체크박스를 선택합니다.
- 확인 대화 상자에서 Enable Code Review Flow를 선택합니다.
- Save changes를 선택합니다.
이제 그룹의 모든 코드 리뷰에서 Code Review Flow가 실행되며 GitLab Credits를 소비합니다. 모든 리뷰를 다시 GitLab Duo Code Review로 되돌리려면 Code Review Flow를 끕니다.
GitLab Duo와 상호작용#
히스토리
GitLab Duo는 머지 리퀘스트 댓글 스레드에서 바로 질문에 답하고 피드백을 논의할 수 있습니다.
GitLab Duo와 상호작용하려면 머지 리퀘스트에서 @GitLabDuo를 멘션합니다:
- 변경 사항에 대해 질문하려면 새 댓글 스레드에서 멘션합니다.
- 설명이나 대안을 요청하려면 리뷰 댓글의 답글에서 멘션합니다.
댓글에서의 상호작용은 Code Review Flow에 선택된 모델을 사용하며, 플로와 별개로 GitLab Credits를 소비합니다.
다만 @GitLabDuo에 리뷰를 요청하면 GitLab Duo가 Code Review Flow를 시작하므로 해당 플로의 과금이
적용됩니다.
GitLab Duo에 제공한 피드백은 다른 머지 리퀘스트의 이후 리뷰에 영향을 주지 않습니다. 이 기능 추가는 이슈 560116에서 제안되었습니다.
GitLab Duo로 토론 해결#
히스토리
- GitLab 19.2에서
resolve_discussion_with_duo라는 피처 플래그와 함께 베타로 도입되었습니다. 기본적으로 활성화됩니다. - GitLab 19.3에서 일반적으로 사용 가능합니다.
- 기능 플래그
resolve_discussion_with_duo가 GitLab 19.5에서 제거되었습니다.
GitLab Duo를 사용해 머지 리퀘스트의 리뷰 토론을 해결합니다.
GitLab Duo에 토론 해결을 요청하면 리뷰 댓글과 주변 코드를 읽고 소스 브랜치에 요청된 변경을 적용한 다음, 변경 사항을 커밋하고 푸시합니다. 그런 다음 GitLab Duo가 변경 사항 요약과 함께 토론에 답글을 달고 스레드를 해결합니다.
이 기능은 GitLab Duo Agent Platform의 Developer Flow를 사용합니다.
사전 요구 사항:
- 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한.
- GitLab Duo Agent Platform의 사전 요구 사항.
- 최상위 그룹에서 Allow foundational flows와 Developer가 켜져 있어야 합니다.
- 서비스 계정을 허용하도록 구성된 푸시 규칙.
- 자체 러너 구성 또는 프로젝트에 켜져 있는 GitLab 호스팅 러너.
GitLab Duo로 토론을 해결하려면 다음 단계를 수행합니다:
- 머지 리퀘스트에서 해결되지 않은 토론으로 이동합니다.
- Resolve thread 옆에서 More resolve options([chevron-down])를 선택합니다.
- Resolve with GitLab Duo를 선택합니다.
GitLab Duo가 세션을 시작하며, 이 세션은 프로젝트 세션에서 추적할 수 있습니다.
코드 리뷰 요약#
Model information
히스토리
머지 리퀘스트 리뷰를 마치고 리뷰를 제출할 준비가 되면, GitLab Duo Code Review Summary를 사용해 작성한 댓글의 요약을 생성합니다.
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Code > Merge requests를 선택하고 리뷰할 머지 리퀘스트를 찾습니다.
- 리뷰를 제출할 준비가 되면 Finish review를 선택합니다.
- Add Summary를 선택합니다.
요약이 댓글 상자에 표시됩니다. 리뷰를 제출하기 전에 요약을 편집하고 다듬을 수 있습니다.
이 실험 기능에 대한 피드백은 이슈 408991에 남길 수 있습니다.
데이터 사용: 이 기능을 사용하면 다음 데이터가 대형 언어 모델로 전송됩니다:
- 초안 댓글의 텍스트
머지 커밋 메시지 생성#
Model information
- Default LLM
- Amazon Q용 LLM: Amazon Q Developer
- 자체 호스팅 모델을 사용하는 GitLab Duo에서 사용 가능
히스토리
- GitLab 16.2에서
generate_commit_message_flag라는 피처 플래그와 함께 실험 기능으로 도입되었습니다. 기본적으로 비활성화됩니다. - GitLab 17.2에서 피처 플래그
generate_commit_message_flag가 기본적으로 활성화되었습니다. - GitLab 17.7에서 피처 플래그
generate_commit_message_flag가 제거되었습니다. - GitLab 18.0에서 Premium을 포함하도록 변경되었습니다.
- GitLab 18.1에서 LLM이 Claude 4.0 Sonnet으로 업데이트되었습니다.
- GitLab 18.3에서 Amazon Q를 지원하도록 변경되었습니다.
머지 리퀘스트를 머지할 준비를 할 때 GitLab Duo Merge Commit Message Generation을 사용해 제안된 머지 커밋 메시지를 편집합니다.
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Code > Merge requests를 선택하고 머지 리퀘스트를 찾습니다.
- 머지 위젯에서 Edit commit message 체크박스를 선택합니다.
- Generate commit message를 선택합니다.
- 제공된 커밋 메시지를 검토하고 Insert를 선택해 커밋에 추가합니다.
데이터 사용: 이 기능을 사용하면 다음 데이터가 대형 언어 모델로 전송됩니다:
- 파일의 내용
- 파일 이름
관련 주제#
문제 해결#
머지 리퀘스트에서 GitLab Duo를 사용할 때 다음 문제가 발생할 수 있습니다.
응답이 수신되지 않음#
@GitLabDuo를 멘션하거나 그 댓글에 답글을 달아 GitLab Duo에 리뷰를 요청했는데
응답을 받지 못했다면, 적절한 GitLab Duo 애드온이 없기 때문일 수
있습니다.
GitLab Duo 애드온을 확인하려면 그룹 Owner에게 그룹의 GitLab Duo 시트 할당 확인을 요청합니다.
GitLab Duo 애드온을 변경하려면 관리자에게 문의합니다.
GitLab Duo를 리뷰어로 할당할 수 없음#
GitLab Duo를 리뷰어로 할당할 수 없다면 적절한 GitLab Duo 애드온이 없기 때문일 수 있습니다.
GitLab Duo 애드온을 확인하려면 그룹 Owner에게 그룹의 GitLab Duo 시트 할당 확인을 요청합니다.
GitLab Duo 애드온을 변경하려면 관리자에게 문의합니다.
오류: GitLab Duo Code Review was not automatically added...#
GitLab Duo의 자동 리뷰가 켜진 상태에서 머지 리퀘스트를 생성하려고 하면 다음 오류 메시지가 표시될 수 있습니다:
GitLab Duo Code Review was not automatically added because your account requires
GitLab Duo Enterprise. Contact your administrator to upgrade your account.
관리자에게 연락해 GitLab Duo Enterprise 시트 구매와 본인에게 할당해 줄 것을 요청합니다.