머지 리퀘스트에서 GitLab Duo 사용
GitLab v19.2Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
이 페이지에는 개발 중인 제품, 기능에 대한 정보가 포함되어 있습니다. GitLab Duo는 머지 리퀘스트 라이프사이클 중에 컨텍스트에 맞는 관련 정보를 제공하도록 설계되었습니다. 머지 리퀘스트를 생성하거나 편집할 때 GitLab Duo Merge Request Summary를 사용하여 머지 리퀘스트 설명을 작성합니다.
이 페이지에는 개발 중인 제품, 기능에 대한 정보가 포함되어 있습니다. 이 정보는 참고 목적으로만 제공되며, 구매 또는 계획 시 이 정보에 의존하지 마십시오.
GitLab Duo는 머지 리퀘스트 라이프사이클 중에 컨텍스트에 맞는 관련 정보를 제공하도록 설계되었습니다.
코드 변경 사항 요약으로 설명 생성#
Model information
- Default LLM
- Available on GitLab Duo with self-hosted models
히스토리
머지 리퀘스트를 생성하거나 편집할 때 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 크레딧 사용. | GitLab Duo Enterprise |
| 컨텍스트 인식 | 저장소 구조 및 파일 간 의존성에 대한 향상된 이해 | 머지 리퀘스트 및 그 내부 파일 diff에 집중. |
| 분석 | 다단계 에이전트 추론 | 단일 패스 |
| 세션 생성 | [check-sm] | 아니요 |
| 자동 리뷰 | [check-sm] | [check-sm] |
| 사용자 지정 지시사항 | [check-sm] | [check-sm] |
| 사용자 지정 댓글 | [check-sm] | [check-sm] |
어떤 리뷰 기능이 실행될지 결정#
기본적으로 GitLab이 실행하는 코드 리뷰 기능은 리뷰를 시작하는 사용자에 따라 달라집니다.
| 리뷰 트리거 | 시작 사용자 |
|---|---|
| 수동으로 리뷰 요청 | 리뷰를 요청하는 사용자. |
| 머지 리퀘스트 생성 (초안 아님) | 머지 리퀘스트 작성자. |
| 초안 머지 리퀘스트를 준비 상태로 표시 | 머지 리퀘스트 작성자. |
시작 사용자에게 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 Duo Enterprise 시트 보유자가 GitLab 크레딧을 소비하는 기능을 사용하지 못하도록, 이들이 시작하는 모든 코드 리뷰는 기본적으로 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 크레딧을 소비합니다. 모든 리뷰를 GitLab Duo Code Review로 다시 전환하려면 Code Review Flow를 끄세요.
GitLab Duo로 토론 해결#
히스토리
- GitLab 19.2에서
resolve_discussion_with_duo라는 기능 플래그와 함께 베타로 도입됨. 기본적으로 활성화됨.
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
- Default LLM
- Available on GitLab Duo with self-hosted models
히스토리
머지 리퀘스트 검토를 완료하고 리뷰를 제출할 준비가 되면, GitLab Duo Code Review Summary를 사용하여 댓글 요약을 생성합니다.
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Code > Merge requests를 선택하고 검토할 머지 리퀘스트를 찾습니다.
- 리뷰를 제출할 준비가 되면 Finish review를 선택합니다.
- Add Summary를 선택합니다.
요약이 댓글 상자에 표시됩니다. 리뷰를 제출하기 전에 요약을 편집하고 다듬을 수 있습니다.
이슈 408991에서 이 실험적 기능에 대한 피드백을 제공하세요.
데이터 사용: 이 기능을 사용할 때 다음 데이터가 대형 언어 모델로 전송됩니다:
- 초안 댓글의 텍스트
머지 커밋 메시지 생성#
Model information
- Default LLM
- LLM for Amazon Q: Amazon Q Developer
- Available on GitLab Duo with self-hosted models
히스토리
- 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 시트 구매 후 해당 시트를 할당해달라고 요청하세요.