GitLab Duo Agent Platform으로 전환
GitLab v19.4Offering: GitLab Self-Managed, GitLab Dedicated
요약
GitLab Duo(비에이전트형)에서 Agent Platform으로 전환하면 소프트웨어 개발 수명 주기 전반에서 여러 어시스턴트(에이전트라고 합니다)를 사용할 수 있습니다. 인스턴스를 Agent Platform으로 전환하려면 다음 단계를 수행합니다.
GitLab Duo(비에이전트형)에서 Agent Platform으로 전환하면 소프트웨어 개발 수명 주기 전반에서 여러 어시스턴트(에이전트라고 합니다)를 사용할 수 있습니다.
인스턴스를 Agent Platform으로 전환하려면 다음 단계를 수행합니다.
- 환경을 설정합니다
- 구성을 검증합니다
- Agent Platform 설정을 구성합니다
- 사용량을 검증합니다
전환 후 사용할 수 있는 기능#
다음 표는 GitLab Duo의 비에이전트형 기능과, Agent Platform으로 이동한 뒤 사용자가 사용할 수 있는 에이전트형 버전을 정리한 것입니다. Agent Platform의 전체 기능 목록은 일반 공급 기능과 베타 및 실험 기능을 참고합니다.
| 비에이전트형 기능 | Agent Platform |
|---|---|
| GitLab Duo Non-Agentic Chat | Agentic Chat 복잡한 질문에 답하고 파일을 자율적으로 생성하고 편집합니다. Planner 및 Security Analyst 에이전트에 연결됩니다. 머지 리퀘스트 요약, 토론 요약, 코드 리팩터링, 테스트 생성이 이제 Agentic Chat의 일부입니다. |
| GitLab Duo Code Review | Code Review Flow 1 코드 리뷰 작업을 자동화하고 팀 전체에 코딩 표준을 적용합니다. |
| Root cause analysis | Fix CI/CD pipeline flow 1 실패한 CI/CD 파이프라인을 진단하고 자동으로 수정합니다. |
| Vulnerability explanation and resolution | SAST vulnerability resolution flow 1 SAST 취약점에 대한 수정 사항과 조치 단계를 자동으로 생성합니다. |
각주:
- 플로를 실행하도록 구성된 러너가 필요합니다. 러너를 구성하지 않으면 Agent Platform으로 전환한 뒤, GitLab Duo(비에이전트형)에서 해당 기능을 사용하던 사용자에게 이 기능이 사용할 수 없는 상태로 표시됩니다.
시작하기 전에#
GitLab 19.0 이상이 필요합니다.
환경 설정#
GitLab Duo(비에이전트형)와 달리 Agent Platform은 러너에서 플로를 실행하고 서비스 계정을 사용해 커밋과 파이프라인을 생성합니다. 이 때문에 비에이전트형 기능에는 없던 구성이 필요합니다.
Agent Platform을 위한 환경을 설정하려면 다음을 수행합니다.
- 인스턴스를 구성합니다.
- GitLab 인스턴스에서 나가는 연결을 허용하도록 네트워크를 구성합니다.
- 플로를 사용하도록 인스턴스 러너 또는 그룹 러너를 구성합니다. CI/CD를 사용하는 플로는 러너에서 실행됩니다. Agentic Chat에는 러너가 필요하지 않습니다.
- 러너에서 GitLab 인스턴스로의 연결을 허용합니다.
- 온라인 라이선스를 사용하는 경우 구독 데이터를 동기화합니다.
구성 검증#
환경을 설정한 뒤 다음 진단 점검을 실행합니다.
Agent Platform 설정 구성#
환경을 설정한 뒤 다음 설정을 구성합니다.
- Agent Platform을 켭니다.
- 기반 플로를 켭니다.
- 기반 플로가 사용하는 서비스 계정에 대해 푸시 규칙을 구성합니다.
- 기본 GitLab Duo 네임스페이스를 설정합니다.
- 선택 사항. 일관성을 유지하고 비용을 통제하려면 기능에 사용할 모델을 선택해 모든 사용자가 해당 모델을 사용하도록 합니다. 어떤 모델이 요구 사항에 맞는지 확실하지 않다면 적합한 모델 선택을 참고합니다.
사용량 검증#
대다수 사용자에게 Agent Platform을 배포하기 전에, 소규모 사용자 그룹에 다음 결과를 확인하도록 요청합니다.
- GitLab UI에서 Agentic Chat에 접근해 사용할 수 있습니다.
- IDE에서 Agent Platform을 인증할 수 있습니다.
- 테스트용 머지 리퀘스트에서 Code Review Flow를 실행할 수 있습니다.
- 구독에서 사용할 수 있는 다른 기반 플로를 실행할 수 있습니다.
이 사용자들이 플로를 몇 차례 실행한 뒤에는 Credits Dashboard에서 크레딧 사용량도 확인합니다.
청구#
구독을 GitLab Duo Pro 또는 Enterprise에서 사용량 기반 청구로 변경하면 시트가 아니라 크레딧 사용량을 기준으로 요금이 부과됩니다.
팀의 크레딧 사용량을 추적하고 사용량 상한을 설정하려면 Credits Dashboard를 사용합니다.
전환 과정에서 자주 발생하는 문제#
인스턴스를 Agent Platform으로 처음 전환할 때 다음과 같은 문제가 발생할 수 있습니다.
| 문제 | 예상 원인 | 해결 방법 |
|---|---|---|
| UI에 플로가 보이지 않음 | GitLab Duo 또는 플로 실행이 켜져 있지 않거나, 그룹에 플로 사용 권한이 없거나, 프로젝트 수준에서 플로가 활성화되지 않았습니다. | Flows not visible in the UI |
| job을 가져가는 러너가 없어 플로가 실행되지 않음 | gitlab--duo 태그를 가진 러너가 없거나, 러너가 플로용으로 구성되지 않았습니다. |
러너 구성 |
세션이 created 상태에서 멈춤 |
푸시 규칙이 서비스 계정을 차단합니다. 커밋 작성자 이메일 또는 duo/feature/ 브랜치 접두사가 허용되지 않습니다. |
Configure push rules to allow a service account |
Error in creating workload: Insufficient permissions to create a new pipeline |
가져오기 또는 템플릿 기반 프로젝트가 존재하기 전에 기반 플로 서비스 계정이 설정되었습니다. | Insufficient permissions to create a new pipeline for imported projects |
| 기반 플로가 켜져 있지만 아무 동작도 하지 않음 | 서비스 계정이 생성되지 않았거나, 그룹 멤버십 잠금 때문에 서비스 계정을 프로젝트에 추가하지 못합니다. | Foundational flow service account not created 및 Group membership locked |
Agent Platform 이 꺼져 있거나 Something went wrong while requesting a review from GitLab Duo가 표시됨 |
사용자가 여러 GitLab Duo 네임스페이스에 속해 있고 기본 네임스페이스가 설정되지 않았습니다. | Default GitLab Duo namespace not set |
Your request was valid but Workflow failed to complete it |
리포지터리에 커밋이 없어 플로가 기본 브랜치를 찾지 못합니다. | Error: Your request was valid but Workflow failed to complete it |
SSL certificate OpenSSL verify result: unable to get local issuer certificate (20) |
사용자 지정 CA 또는 자체 서명 CA를 사용하는 GitLab Self-Managed에서 샌드박스 강화 설정이 git clone 중 러너의 CA 주입을 차단합니다. |
Error: SSL certificate OpenSSL verify result |
| 전환 직후 모든 사용자의 GitLab Duo 기능이 모두 실패함 | Silent Mode가 켜져 있어 GitLab 이 AI 게이트웨이에 연결하지 못합니다. | Silent Mode 끄기 |
| 상태 점검의 네트워크 테스트가 실패하거나 전환 후 GitLab Duo 기능을 사용할 수 없음 | cloud.gitlab.com, customers.gitlab.com, duo-workflow-svc.runway.gitlab.net으로 나가는 HTTPS 연결이 방화벽이나 프록시에 의해 차단되었습니다. |
GitLab 인스턴스에서 GitLab Duo로 나가는 연결 허용 |
| 전환 직후 모든 사용자가 Agent Platform 기능을 사용할 수 없음 | 사용량 기반 청구 약관에 동의하지 않았거나, 풀에 사용할 수 있는 크레딧이 없습니다. | 온디맨드 크레딧 |