GitLab Duo Agentic Chat
Offering: GitLab.com, GitLab Self-Managed
GitLab Duo Agentic Chat은 GitLab Duo Non-Agentic Chat의 향상된 버전입니다. Non-Agentic Chat이 단일 컨텍스트를 기반으로 질문에 답변하는 반면, Agentic Chat은 GitLab 프로젝트 전반에 걸쳐 여러 소스에서 정보를 검색, 조회 및 결합하여 더 포괄적이고 관련성 높은 답변을 제공합니다.
모델 정보
- 기본 LLM
- 자체 호스팅 모델을 사용하는 GitLab Duo에서 사용 가능
히스토리
- VS Code가
duo_agentic_chat이라는 플래그와 함께 실험으로 GitLab 18.1에서 GitLab.com에 도입. 기본적으로 비활성화됨. - VS Code가 GitLab 18.2에서 GitLab Self-Managed에 활성화.
- GitLab UI가
duo_workflow_workhorse및duo_workflow_web_chat_mutation_tools라는 플래그와 함께 GitLab 18.2에서 GitLab.com 및 GitLab Self-Managed에 도입. 두 플래그 모두 기본적으로 활성화됨. - GitLab 18.2에서 기능 플래그
duo_agentic_chat기본적으로 활성화됨. - JetBrains IDE가 GitLab 18.2에서 도입.
- GitLab 18.2에서 베타로 변경됨.
- Windows용 Visual Studio가 GitLab 18.3에서 도입.
- GitLab 18.3에서 GitLab Duo Core에 추가.
- GitLab 18.4에서 기능 플래그
duo_workflow_workhorse및duo_workflow_web_chat_mutation_tools제거. - GitLab 18.4에서 GitLab Self-Managed(자체 호스팅 모델 및 클라우드 연결 GitLab 모델 모두 포함)에서
self_hosted_agent_platform이라는 기능 플래그와 함께 실험으로 GitLab Duo Agent Platform 도입. 기본적으로 비활성화됨. - GitLab 18.5에서 GitLab Self-Managed의 GitLab Duo Agent Platform이 실험에서 베타로 변경됨.
- GitLab 18.6에서 기본 LLM을 Claude Sonnet 4.5로 업데이트.
- GitLab 18.7에서 기능 플래그
self_hosted_agent_platform활성화. - GitLab 18.7에서 기본 LLM을 Claude Haiku 4.5로 업데이트.
- GitLab 18.8에서
agentic_chat_ga및ai_duo_agent_platform_ga_rollout_self_managed라는 플래그와 함께 일반 공개. 두 플래그 모두 기본적으로 활성화됨. 기능 플래그duo_agentic_chat제거됨. - GitLab 18.10에서 기능 플래그
self_hosted_agent_platform,agentic_chat_ga,ai_duo_agent_platform_ga_rollout_self_managed제거됨. - GitLab 18.10에서 GitLab Credits를 사용하는 GitLab.com Free 티어에서 사용 가능.
GitLab Duo Agentic Chat은 GitLab Duo Non-Agentic Chat의 향상된 버전입니다. 이 새로운 Chat은 복잡한 질문에 더 포괄적으로 답변할 수 있도록 사용자 대신 자율적으로 작업을 수행할 수 있습니다.
Non-Agentic Chat이 단일 컨텍스트를 기반으로 질문에 답변하는 반면, Agentic Chat은 GitLab 프로젝트 전반에 걸쳐 여러 소스에서 정보를 검색, 조회 및 결합하여 더 포괄적이고 관련성 높은 답변을 제공합니다.
Agentic Chat은 다음을 수행할 수 있습니다:
- 키워드 기반 검색(의미론적 검색이 아님)을 사용하여 관련 이슈, 머지 리퀘스트 및 기타 아티팩트를 찾기 위해 프로젝트를 검색합니다.
- 파일 경로를 수동으로 지정하지 않고도 로컬 프로젝트의 파일에 액세스합니다.
- 여러 위치에서 파일을 생성하고 편집합니다.
- 이슈, 머지 리퀘스트, CI/CD 파이프라인과 같은 리소스를 가져옵니다.
- 완전한 답변을 제공하기 위해 여러 소스를 분석합니다. 외부 데이터 소스 및 도구에 연결하려면 Model Context Protocol을 사용합니다.
- 사용자 정의 규칙을 사용하여 맞춤형 응답을 제공합니다.
- GitLab UI에서 Chat을 사용할 때 커밋을 생성합니다.
개요를 보려면 GitLab Duo Chat (에이전틱)을 참조합니다.
GitLab Duo Chat 사용#
다음에서 GitLab Duo Chat을 사용할 수 있습니다:
- GitLab UI.
- VS Code.
- JetBrains IDE.
- Windows용 Visual Studio.
GitLab UI에서 GitLab Duo Chat 사용#
히스토리
전제 조건:
GitLab UI에서 Chat을 사용하려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
GitLab Duo 사이드바에서 새 채팅 추가 ([pencil-square]) 또는 현재 GitLab Duo Chat ([duo-chat])을 선택합니다.
새 채팅을 선택한 경우 드롭다운 목록에서 에이전트를 선택합니다.
화면 오른쪽의 GitLab Duo 사이드바에 Chat 대화가 열립니다.
-
Chat 텍스트 상자 아래에서 에이전틱 토글이 켜져 있는지 확인합니다.
-
Chat 텍스트 상자에 질문을 입력하고 Enter를 누르거나 보내기를 선택합니다.
- Chat에 대한 추가 컨텍스트를 제공할 수 있습니다.
- 대화형 AI Chat이 답변을 생성하는 데 몇 초가 걸릴 수 있습니다.
-
선택 사항. 다음을 수행할 수 있습니다:
- 후속 질문을 합니다.
- 다른 대화를 시작합니다.
열려 있는 웹 페이지를 다시 로드하거나 다른 웹 페이지로 이동하면 Chat이 가장 최근 대화를 기억하고 그 대화가 Chat 드로어에서 여전히 활성 상태입니다.
VS Code에서 GitLab Duo Chat 사용#
전제 조건:
- GitLab for VS Code 확장 버전 6.15.1 이상을 설치하고 구성합니다.
- GitLab Duo Agent Platform 전제 조건을 충족합니다.
- 기본 GitLab Duo 네임스페이스를 설정합니다.
GitLab Duo Chat을 켜려면:
- VS Code에서 설정 > 설정으로 이동합니다.
agent platform을 검색합니다.- GitLab > Duo Agent Platform: 활성화됨 아래에서 GitLab Duo Agent Platform 활성화 체크박스를 선택합니다.
그런 다음 GitLab Duo Chat을 사용하려면:
- 왼쪽 사이드바에서 GitLab Duo Agent Platform ([duo-agentic-chat])을 선택합니다.
- Chat 탭을 선택합니다.
- 메시지 상자에서 질문을 입력하고 Enter를 누르거나 보내기를 선택합니다.
JetBrains IDE에서 GitLab Duo Chat 사용#
전제 조건:
- JetBrains용 GitLab 플러그인 버전 3.11.1 이상을 설치하고 구성합니다.
- GitLab Duo Agent Platform 전제 조건을 충족합니다.
- 기본 GitLab Duo 네임스페이스를 설정합니다.
GitLab Duo Chat을 켜려면:
- JetBrains IDE에서 설정 > 도구 > GitLab Duo로 이동합니다.
- GitLab Duo Agent Platform 아래에서 GitLab Duo Agent Platform 활성화 체크박스를 선택합니다.
- 메시지가 표시되면 IDE를 재시작합니다.
그런 다음 GitLab Duo Chat을 사용하려면:
- 오른쪽 도구 창 표시줄에서 GitLab Duo Agent Platform ([duo-agentic-chat])을 선택합니다.
- Chat 탭을 선택합니다.
- 메시지 상자에서 질문을 입력하고 Enter를 누르거나 보내기를 선택합니다.
Visual Studio에서 GitLab Duo Chat 사용#
전제 조건:
- GitLab for Visual Studio 확장 버전 0.60.0 이상을 설치하고 구성합니다.
- GitLab Duo Agent Platform 전제 조건을 충족합니다.
- 기본 GitLab Duo 네임스페이스를 설정합니다.
GitLab Duo Chat을 켜려면:
- Visual Studio에서 도구 > 옵션 > GitLab으로 이동합니다.
- GitLab 아래에서 일반을 선택합니다.
- 에이전틱 Duo Chat 활성화에서 True를 선택한 다음 확인을 선택합니다.
그런 다음 GitLab Duo Chat을 사용하려면:
- 확장 > GitLab > 에이전틱 Chat 열기를 선택합니다.
- 메시지 상자에서 질문을 입력하고 Enter를 누릅니다.
채팅 기록 보기#
채팅 기록을 보려면:
-
GitLab UI에서 GitLab Duo 사이드바에서 GitLab Duo Chat 기록 ([history])을 선택합니다.
-
IDE에서 메시지 상자의 오른쪽 상단에서 채팅 기록 ([history])을 선택합니다.
GitLab UI에서 채팅 기록의 모든 대화가 표시됩니다.
IDE에서 마지막 20개의 대화가 표시됩니다. 이슈 1308에서 이를 변경하는 것을 제안합니다.
여러 대화 하기#
GitLab Duo Chat과 동시에 무제한으로 대화할 수 있습니다.
대화는 GitLab UI와 IDE의 GitLab Duo Chat 간에 동기화됩니다.
-
GitLab UI 또는 IDE에서 GitLab Duo Chat을 엽니다.
-
질문을 입력하고 Enter를 누르거나 보내기를 선택합니다.
-
새 Chat 대화를 만듭니다:
-
GitLab UI에서 다음 중 하나를 수행할 수 있습니다:
- 특정 에이전트로 새 대화를 만들려면 GitLab Duo 사이드바에서 새 채팅 추가 ([pencil-square])를 선택한 다음 드롭다운 목록에서 에이전트를 선택합니다.
- 기존 대화와 동일한 에이전트로 새 대화를 만들려면 메시지 상자에서
/new를 입력하고 Enter를 누르거나 보내기를 선택합니다.
새 Chat 대화가 이전 대화를 대체합니다.
-
Chat 텍스트 상자 아래에서 에이전틱 토글이 켜져 있는지 확인합니다.
-
IDE에서 메시지 상자의 오른쪽 상단에서 새 Chat (+)을 선택합니다.
-
-
질문을 입력하고 Enter를 누르거나 보내기를 선택합니다.
-
모든 대화를 보려면 채팅 기록을 확인합니다.
-
대화 간에 전환하려면 채팅 기록에서 적절한 대화를 선택합니다.
-
채팅 기록에서 특정 대화를 검색하려면:
- GitLab UI: 스레드 검색 텍스트 상자에 검색어를 입력합니다.
- IDE: 채팅 검색 텍스트 상자에 검색어를 입력합니다.
LLM 컨텍스트 창 제한으로 인해 대화는 각각 200,000 토큰(대략 800,000자)으로 잘립니다.
대화 삭제#
히스토리
- 대화 삭제 기능이 GitLab 18.2에서 도입.
- GitLab UI 또는 IDE에서 채팅 기록을 선택합니다.
- 기록에서 이 Chat 삭제 ([remove])를 선택합니다.
개별 대화는 30일 동안 비활성 상태이면 만료되어 자동으로 삭제됩니다.
로컬 환경에서 GitLab Duo Chat 사용자 정의#
코딩 스타일, 팀 관행, 프로젝트 요구사항을 반영하는 지침을 제공하여 로컬 환경에서 GitLab Duo Chat의 동작 방식을 사용자 정의합니다.
GitLab Duo Chat은 두 가지 접근 방식을 지원합니다:
chat-rules.md의 사용자 정의 규칙: GitLab 전용. 개인적인 선호도 및 팀 표준에 적합합니다.AGENTS.md의 공유 규칙:AGENTS.md사양을 지원하는 GitLab 및 기타 AI 도구용. 프로젝트 컨텍스트, 모노리포 구성, 디렉토리별 규칙에 적합합니다.
두 파일을 동시에 사용할 수 있습니다. GitLab Duo Chat은 사용 가능한 모든 규칙 파일의 지침을 적용합니다.
GitLab Duo 사용자 정의 방법에 대해 자세히 알아봅니다.
모델 선택#
히스토리
GitLab UI, VS Code 또는 JetBrains IDE에서 Chat을 사용하는 경우 대화에 사용할 모델을 선택할 수 있습니다.
채팅 기록에서 이전 채팅을 열고 대화를 계속하면 Chat은 이전에 선택한 모델을 사용합니다.
기존 대화에서 새 모델을 선택하면 Chat이 새 대화를 만듭니다.
전제 조건:
- 관리자가 인스턴스에 대한 모델을 선택하지 않았습니다. 인스턴스에 대해 모델이 선택된 경우 Chat의 모델을 변경할 수 없습니다.
- 인스턴스가 GitLab AI Gateway에 연결되어 있어야 합니다.
모델을 선택하려면:
- GitLab UI에서:
- Chat 텍스트 상자 아래에서 에이전틱 토글이 켜져 있는지 확인합니다.
- 드롭다운 목록에서 모델을 선택합니다.
- IDE에서:
- 사이드바에서 GitLab Duo Agent Platform ([duo-agentic-chat])을 선택합니다.
- Chat 탭을 선택합니다.
- 드롭다운 목록에서 모델을 선택합니다.
에이전트 선택#
GitLab UI의 프로젝트, VS Code 또는 JetBrains IDE에서 Chat을 사용할 때 Chat이 사용할 특정 에이전트를 선택할 수 있습니다.
전제 조건:
- 프로젝트에서 AI 카탈로그의 에이전트가 활성화되어 있어야 합니다.
- 에이전트가 활성화된 프로젝트의 구성원이어야 합니다.
- VS Code의 경우 GitLab for VS Code 확장 버전 6.49.12 이상을 설치하고 구성합니다.
- JetBrains IDE의 경우 JetBrains용 GitLab 플러그인 버전 3.22.0 이상을 설치하고 구성합니다.
에이전트를 선택하려면:
- GitLab UI 또는 IDE에서 GitLab Duo Chat에서 새 대화를 엽니다.
- GitLab UI에서 Chat 텍스트 상자 아래에서 에이전틱 토글이 켜져 있는지 확인합니다.
- 드롭다운 목록에서 에이전트를 선택합니다. 에이전트를 설정하지 않은 경우 드롭다운 목록이 없으며 Chat은 기본 GitLab Duo 에이전트를 사용합니다.
- 질문을 입력하고 Enter를 누르거나 보내기를 선택합니다.
에이전트와 함께 대화를 만든 후:
- 대화는 선택한 에이전트를 기억합니다. 해당 대화에서 다른 에이전트를 선택할 수 없습니다.
- 채팅 기록을 사용하여 동일한 대화로 돌아가면 동일한 에이전트를 사용합니다.
- 대화로 돌아갔을 때 연관된 에이전트를 더 이상 사용할 수 없는 경우 해당 대화를 계속할 수 없습니다.
프롬프트 캐싱#
히스토리
- GitLab 18.7에서 도입됨.
프롬프트 캐싱은 기본적으로 활성화되며, 선택된 Agentic Chat 모델이 Anthropic의 것이거나 Vertex를 통해 제공되는 Anthropic 모델인 경우에만 작동합니다.
프롬프트 캐싱이 활성화되면 채팅 프롬프트 데이터가 모델 공급업체의 메모리에 일시적으로 저장됩니다.
프롬프트 캐싱은 캐시된 프롬프트 및 입력 데이터를 재처리하지 않아도 되므로 지연 시간을 크게 개선합니다.
프롬프트 캐싱 끄기#
오퍼링에 따라 GitLab Duo 설정에서 프롬프트 캐싱을 끌 수 있습니다:
- GitLab.com에서는 개별 최상위 그룹에 대해 캐싱을 끌 수 있습니다.
- GitLab Self-Managed에서는 전체 인스턴스에 대해 캐싱을 끌 수 있습니다.
이렇게 하면 코드 제안의 프롬프트 캐싱도 꺼집니다.
도구 승인#
히스토리
- GitLab 19.0에서 도입.
- GitLab for VS Code 6.72.0에서 도입.
- JetBrains IDE용 GitLab Duo 플러그인 3.33.0에서 도입.
- GitLab Duo CLI 8.80.0에서 도입.
Agentic Chat이 사용자를 대신하여 도구를 사용하기 전에 승인이 필요합니다. 기본적으로 각 도구 호출마다 승인이 필요합니다.
도구를 신뢰하고 워크플로를 간소화하고 싶다면 전체 세션에 대해 한 번만 승인할 수 있습니다.
세션 승인은 Chat에만 적용되며, 흐름에는 적용되지 않습니다.
도구 승인 관리#
Owner 및 관리자는 사용자가 세션에 대해 도구를 승인할 수 있는지 여부를 제어할 수 있습니다. 설정은 인스턴스에서 그룹, 프로젝트로 cascading됩니다.
그룹 또는 인스턴스에 대해 다음 옵션 중 하나를 구성합니다:
- 기본적으로 켜기: 사용자가 세션에 대해 한 번 도구를 승인할 수 있습니다. 그룹 및 하위 그룹이 이를 끌 수 있습니다.
- 기본적으로 끄기: (기본값) 사용자가 각 도구 호출마다 승인해야 합니다. 그룹 및 하위 그룹이 이를 켤 수 있습니다.
- 항상 끄기: 사용자가 세션에 대해 도구를 승인할 수 없습니다. 그룹 및 하위 그룹이 이 설정을 재정의할 수 없습니다.
기본 설정 관리#
인스턴스 또는 최상위 그룹에 대한 기본 도구 승인 설정을 구성합니다.
전제 조건:
- 최상위 그룹에 대한 Owner 역할.
기본 도구 승인 설정을 구성하려면:
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 설정 > GitLab Duo를 선택합니다.
- 세션에 대한 도구 승인 드롭다운 목록에서 원하는 옵션을 선택합니다.
전제 조건:
- 관리자 액세스.
기본 도구 승인 설정을 구성하려면:
- 오른쪽 상단 모서리에서 Admin을 선택합니다.
- GitLab Duo를 선택합니다.
- 세션에 대한 도구 승인 드롭다운 목록에서 원하는 옵션을 선택합니다.
전제 조건:
- 관리자 액세스.
기본 도구 승인 설정을 구성하려면:
- 오른쪽 상단 모서리에서 Admin을 선택합니다.
- GitLab Duo를 선택합니다.
- 세션에 대한 도구 승인 드롭다운 목록에서 원하는 옵션을 선택합니다.
그룹 또는 프로젝트 설정 관리#
특정 그룹 또는 프로젝트에 대한 도구 승인 설정을 구성합니다.
전제 조건:
- 그룹에 대한 Owner 역할 또는 프로젝트에 대한 Maintainer 역할.
도구 승인 설정을 구성하려면:
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
- 설정 > GitLab Duo를 선택합니다.
- 그룹의 경우 세션에 대한 도구 승인 드롭다운 목록에서 원하는 옵션을 선택합니다.
- 프로젝트의 경우 세션에 대한 도구 승인 허용 체크박스를 선택하거나 해제합니다.
로컬 환경에서 도구 승인#
전제 조건:
- 그룹 또는 인스턴스에 대해 도구 승인이 켜져 있어야 합니다.
- 로컬 환경의 GitLab Duo Chat의 경우 다음 중 하나를 설치하고 구성합니다:
- GitLab for VS Code 6.72.0 이상.
- JetBrains IDE용 GitLab Duo 플러그인 3.33.0 이상.
- GitLab Duo CLI 8.80.0 이상.
현재 세션에 대해 도구를 승인하려면:
- 도구 승인 프롬프트가 나타나면 승인 버튼 옆의 드롭다운을 선택합니다.
- 세션에 대해 승인을 선택합니다.
승인은 Chat 세션이 끝날 때까지 유지되며 새 대화를 시작하면 초기화됩니다.
Chat 기능 비교#
| 기능 | GitLab Duo Non-Agentic Chat | GitLab Duo Agentic Chat |
|---|---|---|
| 일반 프로그래밍 질문 | 예 | 예 |
| 에디터의 열린 파일에 대한 답변 | 예 | 예. 질문에 파일 경로를 제공합니다. |
| 지정된 파일에 대한 컨텍스트 제공 | 예. 대화에 파일을 추가하려면 /include를 사용합니다.1 |
예. 질문에 파일 경로를 제공합니다. |
| 프로젝트 내용 자율 검색 | 아니요 | 예 |
| 자율적으로 파일 생성 및 변경 | 아니요 | 예. 파일을 변경하도록 요청합니다. 아직 커밋하지 않은 수동 변경사항을 덮어쓸 수 있습니다. |
| ID를 지정하지 않고 이슈 및 MR 검색 | 아니요 | 예. 다른 기준으로 검색합니다. 예를 들어 MR 또는 이슈의 제목이나 담당자. |
| 여러 소스의 정보 결합 | 아니요 | 예 |
| 파이프라인 로그 분석 | 예. GitLab Duo Enterprise 애드온 필요. | 예 |
| 대화 재시작 | 예. /new 또는 /reset 사용. |
예. /new 사용, UI에서는 /reset도 사용 가능. |
| 대화 삭제 | 예, 채팅 기록에서. | 예, 채팅 기록에서. |
| 이슈 및 MR 생성 | 아니요 | 예 |
| Git 읽기 전용 명령 사용 | 아니요 | 예 |
| Git 쓰기 명령 사용 | 아니요 | 예, UI 전용 |
| 셸 명령 실행 | 아니요 | 예, IDE 전용 |
| MCP 도구 실행 | 아니요 | 예, IDE 전용 |
| 세션에 대한 도구 승인 | 아니요 | 예, IDE 전용 |
각주:
문제 해결#
GitLab Duo Chat 사용 시 문제가 발생할 수 있습니다.
이러한 문제 해결에 대한 정보는 문제 해결을 참조합니다.
피드백#
피드백은 이 기능을 개선하는 데 중요합니다. 이슈 542198에서 경험, 제안 또는 문제를 공유합니다.
관련 주제#
Footnotes
-
Web IDE에서 GitLab Duo Non-Agentic Chat을 사용할 때는 사용할 수 없습니다. ↩
