GitLab Duo Agent Platform으로 전환
GitLab v19.3Offering: 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 비에이전틱 채팅 | 에이전틱 채팅 복잡한 질문에 답변하고 자율적으로 파일을 생성하고 편집합니다. Planner 및 Security Analyst 에이전트에 연결됩니다. 머지 리퀘스트 요약, 논의 요약, 코드 리팩터링, 테스트 생성이 이제 에이전틱 채팅의 일부입니다. |
| GitLab Duo 코드 리뷰 | 코드 리뷰 플로우 1 코드 리뷰 작업을 자동화하고 팀 전체에 코딩 표준을 적용합니다. |
| 근본 원인 분석 | CI/CD 파이프라인 수정 플로우 1 실패한 CI/CD 파이프라인을 진단하고 자동으로 수정합니다. |
| 취약점 설명 및 해결 | SAST 취약점 해결 플로우 1 SAST 취약점에 대한 수정 사항과 해결 단계를 자동으로 생성합니다. |
각주:
- 플로우를 실행하도록 구성된 러너가 필요합니다. 러너를 구성하지 않으면 Agent Platform으로 전환한 후 GitLab Duo(비에이전틱)에서 이러한 기능을 사용하던 사용자에게는 해당 기능이 사용할 수 없는 것으로 표시됩니다.
시작하기 전에#
GitLab 19.0 이상이 있어야 합니다.
환경 설정#
GitLab Duo(비에이전틱)와 달리 Agent Platform은 러너에서 플로우를 실행하고 서비스 계정을 사용하여 커밋과 파이프라인을 생성합니다. 이는 비에이전틱 기능에는 없던 구성 요구 사항입니다.
Agent Platform을 위한 환경을 설정하려면:
-
인스턴스를 구성합니다.
-
GitLab 인스턴스에서 아웃바운드 연결을 허용하도록 네트워크를 구성합니다.
-
플로우를 사용하도록 인스턴스 또는 그룹 러너를 구성합니다. CI/CD를 사용하는 플로우는 러너에서 실행됩니다. 에이전틱 채팅에는 러너가 필요하지 않습니다.
-
러너에서 GitLab 인스턴스로의 연결을 허용합니다.
-
온라인 라이선스가 있는 경우 구독 데이터를 동기화합니다.
구성 검증#
환경을 설정한 후 다음 진단 검사를 실행합니다:
Agent Platform 설정 구성#
환경을 설정한 후 다음 설정을 구성합니다:
-
기본 플로우에서 사용하는 서비스 계정에 대해 푸시 규칙을 구성합니다.
-
선택 사항. 일관성을 유지하고 비용을 제어하려면 기능에 대한 모델을 선택하여 모든 사용자가 해당 모델을 사용하도록 합니다. 요구 사항에 어떤 모델이 적합한지 잘 모르겠다면 올바른 모델 선택을 참조하세요.
사용량 검증#
대다수 사용자에게 Agent Platform을 롤아웃하기 전에 소규모 사용자 그룹에게 다음 결과를 확인하도록 요청합니다:
-
GitLab UI에서 에이전틱 채팅에 액세스하고 사용할 수 있습니다.
-
IDE에서 Agent Platform을 인증할 수 있습니다.
-
테스트 머지 리퀘스트에서 코드 리뷰 플로우를 실행할 수 있습니다.
-
구독에서 사용 가능한 다른 기본 플로우를 실행할 수 있습니다.
이러한 사용자가 일부 플로우를 실행한 후에는 크레딧 대시보드에서 크레딧 사용량도 확인해야 합니다.
청구#
구독을 GitLab Duo Pro 또는 Enterprise에서 사용량 기반 청구로 변경하면 좌석이 아니라 크레딧 사용량을 기준으로 요금이 청구됩니다.
팀의 크레딧 사용량을 추적하고 사용량 상한을 설정하려면 크레딧 대시보드를 사용합니다.
전환 중 발생하는 일반적인 문제#
인스턴스를 Agent Platform으로 처음 전환할 때 다음과 같은 문제가 발생할 수 있습니다.
| 문제 | 예상 원인 | 해결 방법 |
|---|---|---|
| UI에 플로우가 표시되지 않음 | GitLab Duo 또는 플로우 실행이 켜져 있지 않거나, 그룹에 플로우 사용 권한이 없거나, 프로젝트 수준에서 플로우가 활성화되지 않았습니다. | UI에 플로우가 표시되지 않음 |
| 어떤 러너도 잡을 가져가지 않아 플로우가 실행되지 않음 | gitlab--duo 태그가 있는 러너가 없거나, 러너가 플로우용으로 구성되지 않았습니다. | 러너 구성 |
| 세션이 created 상태에서 멈춤 | 푸시 규칙이 서비스 계정을 차단합니다. 커밋 작성자 이메일 또는 duo/feature/ 브랜치 접두사가 허용되지 않습니다. | 서비스 계정을 허용하도록 푸시 규칙 구성 |
| Error in creating workload: Insufficient permissions to create a new pipeline | 가져오기했거나 템플릿으로 만든 프로젝트가 존재하기 전에 기본 플로우 서비스 계정이 설정되었습니다. | 가져온 프로젝트에 대해 새 파이프라인을 생성할 권한 부족 |
| 기본 플로우가 켜져 있지만 아무 동작도 하지 않음 | 서비스 계정이 생성되지 않았거나, 그룹 멤버십 잠금으로 인해 서비스 계정을 프로젝트에 추가할 수 없습니다. | 기본 플로우 서비스 계정이 생성되지 않음 및 그룹 멤버십 잠금 |
| Agent Platform이 꺼져 있거나, GitLab Duo에 리뷰를 요청하는 중에 문제가 발생함 | 사용자가 여러 GitLab Duo 네임스페이스에 속해 있고 기본 네임스페이스가 설정되지 않았습니다. | 기본 GitLab Duo 네임스페이스가 설정되지 않음 |
| Your request was valid but Workflow failed to complete it | 리포지터리에 커밋이 없어 플로우가 기본 브랜치를 찾을 수 없습니다. | 오류: Your request was valid but Workflow failed to complete it |
| SSL certificate OpenSSL verify result: unable to get local issuer certificate (20) | 사용자 지정 또는 자체 서명 CA를 사용하는 GitLab Self-Managed에서 샌드박스 강화가 git clone 중 러너의 CA 주입을 차단합니다. | 오류: SSL certificate OpenSSL verify result |
| 전환 직후 모든 사용자에 대해 모든 GitLab Duo 기능이 실패함 | 사일런트 모드가 켜져 있어 GitLab이 AI 게이트웨이에 도달하지 못합니다. | 사일런트 모드 끄기 |
| 상태 확인 네트워크 테스트가 실패하거나, 전환 후 GitLab Duo 기능을 사용할 수 없음 | cloud.gitlab.com, customers.gitlab.com 또는 duo-workflow-svc.runway.gitlab.net으로의 아웃바운드 HTTPS가 방화벽 또는 프록시에 의해 차단되었습니다. | GitLab 인스턴스에서 GitLab Duo로의 아웃바운드 연결 허용 |
| 전환 직후 모든 사용자에 대해 Agent Platform 기능을 사용할 수 없음 | 사용량 기반 청구 약관에 동의하지 않았거나, 풀에 사용 가능한 크레딧이 없습니다. | 온디맨드 크레딧 |