사용자 정의 에이전트
GitLab v19.2Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
에이전트는 AI를 사용하여 작업을 수행하고 복잡한 질문에 답변합니다. 에이전트와 상호 작용할 준비가 되면 활성화하고 GitLab UI, VS Code, JetBrains IDE에서 GitLab Duo Chat과 함께 사용하기 시작합니다.
모델 정보
- 자체 호스팅 모델을 사용하는 GitLab Duo에서 사용 가능
히스토리
- GitLab 18.5에서
global_ai_catalog이라는 플래그와 함께 도입. GitLab.com에서 활성화됨. - GitLab 18.7에서
ai_catalog_agents라는 플래그와 함께 그룹에서의 활성화가 도입. GitLab.com에서 활성화됨. - GitLab 18.7에서 베타로 변경.
- GitLab 18.8에서 일반 공개.
- GitLab 18.9에서 기능 플래그
ai_catalog_agents제거. - 18.10에서 기능 플래그
global_ai_catalog제거. - GitLab 18.10에서
ai_catalog_project_level_enablement이라는 플래그와 함께 Maintainer로서 프로젝트에서 직접 활성화하는 기능이 도입. GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 기본적으로 활성화됨. - GitLab 18.10에서 GitLab Credits를 사용하는 GitLab.com Free 티어에서 사용 가능.
- GitLab 18.11에서 기능 플래그
ai_catalog_project_level_enablement제거.
에이전트는 AI를 사용하여 작업을 수행하고 복잡한 질문에 답변합니다. 머지 리퀘스트 생성 또는 코드 리뷰와 같은 특정 작업을 수행하는 사용자 정의 에이전트를 만들거나, AI 카탈로그를 사용하여 GitLab에서 만든 에이전트를 찾아볼 수 있습니다.
에이전트와 상호 작용할 준비가 되면 활성화하고 GitLab UI, VS Code, JetBrains IDE에서 GitLab Duo Chat과 함께 사용하기 시작합니다.
전제 조건#
에이전트 가시성#
히스토리
- GitLab 18.7에서 비공개 에이전트를 볼 수 있는 역할이 확장됨.
사용자 정의 에이전트를 만들 때 관리 프로젝트를 선택하고 에이전트를 공개 또는 비공개로 설정합니다.
공개 에이전트:
- 누구나 볼 수 있으며 전제 조건을 충족하는 모든 프로젝트에서 활성화할 수 있습니다.
비공개 에이전트:
-
Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한을 가진 관리 프로젝트 구성원만 볼 수 있습니다.
-
관리 프로젝트 이외의 프로젝트에서는 활성화할 수 없습니다.
에이전트가 현재 활성화되어 있는 경우 공개 에이전트를 비공개로 변경할 수 없습니다.
프로젝트의 에이전트 보기#
전제 조건:
- 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
프로젝트와 연결된 에이전트 목록을 보려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
왼쪽 사이드바에서 AI > Agents를 선택합니다.
활성화된 에이전트를 보려면 활성화됨 탭을 선택합니다.
- 프로젝트에서 관리되는 에이전트를 보려면 관리됨 탭을 선택합니다.
에이전트를 선택하면 세부 정보를 볼 수 있습니다.
에이전트 만들기#
프로젝트에서 또는 AI 카탈로그를 사용하여 에이전트를 만들 수 있습니다.
전제 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
에이전트를 만들려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
왼쪽 사이드바에서 AI > Agents를 선택합니다.
-
새 에이전트를 선택합니다.
-
기본 정보 아래에서:
표시 이름에 에이전트 이름을 입력합니다.
- 설명에 에이전트 설명을 입력합니다.
-
가시성 및 액세스 아래에서 가시성에 비공개 또는 공개를 선택합니다.
-
프롬프트 아래에서 시스템 프롬프트에 에이전트의 성격, 전문성 및 동작을 정의하는 프롬프트를 입력합니다.
-
선택 사항. 사용 가능한 도구 아래에서 도구 드롭다운 목록에서 에이전트가 액세스할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 자동으로 이슈를 만들도록 하려면 이슈 생성을 선택합니다.
일부 도구는 IDE 확장이 필요하며 웹 UI에서는 사용할 수 없습니다. 자세한 내용은 에이전트 도구 목록을 참조합니다.
-
에이전트 만들기를 선택합니다.
에이전트를 만들려면:
-
상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
-
AI 카탈로그를 선택한 다음 에이전트 탭을 선택합니다.
-
새 에이전트를 선택합니다.
-
기본 정보 아래에서:
표시 이름에 에이전트 이름을 입력합니다.
- 설명에 에이전트 설명을 입력합니다.
-
가시성 및 액세스 아래에서:
관리자 드롭다운 목록에서 에이전트의 프로젝트를 선택합니다.
- 가시성에 비공개 또는 공개를 선택합니다.
-
프롬프트 아래에서 시스템 프롬프트에 에이전트의 성격, 전문성 및 동작을 정의하는 프롬프트를 입력합니다.
-
선택 사항. 사용 가능한 도구 아래에서 도구 드롭다운 목록에서 에이전트가 액세스할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 자동으로 이슈를 만들도록 하려면 이슈 생성을 선택합니다.
사용 가능한 도구 목록은 내장 도구 정의를 참조합니다.
-
에이전트 만들기를 선택합니다.
에이전트가 AI 카탈로그에 나타납니다. Chat과 함께 에이전트를 사용하려면 활성화해야 합니다.
에이전트 활성화#
히스토리
이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참조하세요.
에이전트를 활성화하여 Chat과 함께 사용합니다.
프로젝트에서 에이전트를 활성화하면 동시에 해당 프로젝트의 최상위 그룹에서도 활성화됩니다.
전제 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
에이전트를 활성화하려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
왼쪽 사이드바에서 AI > Agents를 선택합니다.
-
관리됨 탭을 선택한 다음 활성화할 에이전트를 선택합니다.
-
오른쪽 상단에서 활성화를 선택합니다.
-
프로젝트 아래에서 에이전트를 활성화할 프로젝트를 선택합니다.
-
활성화를 선택합니다.
에이전트를 활성화하려면:
-
상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
-
AI 카탈로그를 선택한 다음 에이전트 탭을 선택합니다.
-
활성화할 에이전트를 선택합니다.
-
오른쪽 상단에서 활성화를 선택합니다.
-
프로젝트 아래에서 에이전트를 활성화할 프로젝트를 선택합니다.
공개 에이전트를 여러 프로젝트에 대해 활성화하려면 프로젝트 드롭다운 목록에서 관련 프로젝트를 선택합니다. 최대 100개의 프로젝트를 선택할 수 있습니다.
-
활성화를 선택합니다.
에이전트가 그룹 및 프로젝트 AI > Agents 페이지에 표시됩니다. 최상위 그룹의 모든 프로젝트 구성원이 이제 자신의 프로젝트에서 에이전트를 활성화할 수 있습니다.
프로젝트에서 에이전트와 새 채팅을 시작할 수 있습니다. 자세한 내용은 에이전트 선택을 참조합니다.
프로젝트에서 활성화#
에이전트가 최상위 그룹에서 이미 활성화된 경우 그룹의 프로젝트에서 활성화할 수 있습니다.
전제 조건:
-
프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
-
에이전트가 프로젝트의 최상위 그룹에서 활성화되어 있어야 합니다.
프로젝트에서 에이전트를 활성화하려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
왼쪽 사이드바에서 AI > Agents를 선택합니다.
-
오른쪽 상단에서 그룹에서 에이전트 활성화를 선택합니다.
-
드롭다운 목록에서 활성화할 에이전트를 선택합니다.
-
활성화를 선택합니다.
에이전트가 프로젝트의 AI > Agents 페이지에 나타납니다.
프로젝트에서 에이전트와 새 채팅을 시작할 수 있습니다.
에이전트 사용#
GitLab UI, VS Code, JetBrains IDE에서 사용자 정의 에이전트를 사용할 수 있습니다.
GitLab UI에서#
전제 조건:
- 사용하려는 프로젝트에서 에이전트를 활성화합니다.
GitLab UI에서 사용자 정의 에이전트를 사용하려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
-
이슈, 에픽 또는 머지 리퀘스트를 엽니다.
-
GitLab Duo 사이드바에서 새 채팅 추가 ( pencil-square )를 선택합니다.
-
드롭다운 목록에서 사용자 정의 에이전트를 선택합니다.
화면 오른쪽의 GitLab Duo 사이드바에 Chat 대화가 열립니다.
- 질문 또는 요청을 입력합니다.
VS Code에서#
전제 조건:
-
사용하려는 프로젝트에서 에이전트를 활성화합니다.
-
GitLab for VS Code 버전 6.47.0 이상을 설치하고 구성합니다.
VS Code에서 사용자 정의 에이전트를 사용하려면:
-
VS Code의 왼쪽 사이드바에서 GitLab Duo Agent Platform ( duo-agentic-chat )을 선택합니다.
-
Chat 탭을 선택합니다.
-
새 Chat ( duo-chat-new ) 드롭다운 목록에서 사용자 정의 에이전트를 선택합니다.
-
질문 또는 요청을 입력합니다.
JetBrains IDE에서#
전제 조건:
-
사용하려는 프로젝트에서 에이전트를 활성화합니다.
-
JetBrains IDE용 GitLab Duo 플러그인 버전 3.19.0 이상을 설치하고 구성합니다.
먼저 GitLab Duo Agent Platform을 활성화합니다:
-
JetBrains IDE에서 설정 > 도구 > GitLab Duo로 이동합니다.
-
GitLab Duo Agent Platform 아래에서 GitLab Duo Agent Platform 활성화 체크박스를 선택합니다.
-
메시지가 표시되면 IDE를 재시작합니다.
그런 다음 사용자 정의 에이전트를 사용하려면:
-
JetBrains IDE에서 오른쪽 도구 창 표시줄에서 GitLab Duo Agent Platform ( duo-agentic-chat )을 선택합니다.
-
Chat 탭을 선택합니다.
-
새 Chat ( duo-chat-new ) 드롭다운 목록에서 사용자 정의 에이전트를 선택합니다.
-
질문 또는 요청을 입력합니다.
에이전트 비활성화#
전제 조건:
-
그룹의 경우 Maintainer 또는 Owner 권한이 있어야 합니다.
-
프로젝트의 경우 Maintainer 또는 Owner 권한이 있어야 합니다.
에이전트를 비활성화하려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
-
AI > Agents를 선택합니다.
-
제거할 에이전트를 찾고 작업 ( ellipsis_v ) > 비활성화를 선택합니다.
-
확인 대화 상자에서 비활성화를 선택합니다.
에이전트가 더 이상 프로젝트에 나타나지 않으며 Chat에서 사용할 수 없습니다.
에이전트 복제#
원본을 덮어쓰지 않고 에이전트를 변경하려면 기존 에이전트의 복사본을 만듭니다.
전제 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
에이전트를 복제하려면:
-
상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
-
AI 카탈로그를 선택한 다음 에이전트 탭을 선택합니다.
-
복제할 에이전트를 선택합니다.
-
오른쪽 상단에서 작업 ( ellipsis_v ) > 복제를 선택합니다.
-
선택 사항. 변경하려는 필드를 편집합니다.
-
에이전트 만들기를 선택합니다.
에이전트 편집#
에이전트 구성을 변경하기 위해 에이전트를 편집합니다.
전제 조건:
-
관리 프로젝트의 구성원이고 Maintainer 또는 Owner 권한이 있어야 합니다.
-
상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
-
AI > Agents를 선택합니다.
-
편집할 에이전트를 선택합니다.
-
오른쪽 상단에서 편집을 선택합니다.
-
변경하려는 필드를 편집한 다음 변경 사항 저장을 선택합니다.
에이전트 숨기기#
AI 카탈로그에서 에이전트를 제거하려면 에이전트를 숨깁니다.
에이전트를 숨기면 사용자가 활성화할 수 없습니다. 그러나 이미 활성화된 그룹 및 프로젝트에서는 에이전트와 계속 상호 작용할 수 있습니다.
전제 조건:
- 관리 프로젝트의 구성원이고 Maintainer 또는 Owner 권한이 있어야 합니다.
에이전트를 숨기려면:
-
상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
-
AI > Agents를 선택합니다.
-
숨길 에이전트를 찾고 작업 ( ellipsis_v ) > 숨기기를 선택합니다.
-
확인 대화 상자에서 확인을 선택합니다.
에이전트 삭제#
인스턴스에서 에이전트를 영구적으로 제거하려면 에이전트를 삭제합니다.
전제 조건:
-
관리자여야 합니다.
-
상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
-
AI > Agents를 선택합니다.
-
삭제할 에이전트를 찾고 작업 ( ellipsis_v ) > 삭제를 선택합니다.
-
확인 대화 상자에서 삭제를 선택합니다.
사용자 정의 에이전트 켜기/끄기#
히스토리
- GitLab 19.0에서 도입됨.
기본적으로 사용자 정의 에이전트는 켜져 있습니다. 최상위 그룹 또는 인스턴스에 대해 켜거나 끌 수 있습니다.
사용자 정의 에이전트가 꺼지면:
-
사용자가 사용자 정의 에이전트를 생성, 활성화, 비활성화 또는 실행할 수 없습니다.
-
기존 사용자 정의 에이전트가 AI > Agents > Enabled 아래 프로젝트에 더 이상 표시되지 않습니다.
-
프로젝트에서 생성된 사용자 정의 에이전트는 AI > Agents > Managed 아래에 나타나지만 실행할 수 없습니다.
전제 조건:
-
그룹에 대한 Owner 권한이 있어야 합니다.
-
상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
-
왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
사용자 정의 에이전트 및 외부 에이전트, 플로우 아래에서 사용자 정의 에이전트 허용 체크박스를 선택하거나 지웁니다.
-
변경 사항 저장을 선택합니다.
이 설정은 그룹의 모든 하위 그룹에 적용됩니다.
전제 조건:
-
관리자여야 합니다.
-
오른쪽 상단에서 관리자를 선택합니다.
-
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
-
구성 변경을 선택합니다.
-
사용자 정의 에이전트 및 외부 에이전트, 플로우 아래에서 사용자 정의 에이전트 허용 체크박스를 선택하거나 지웁니다.
-
변경 사항 저장을 선택합니다.
인스턴스 수준 설정이 꺼져 있으면 그룹 수준 설정으로 재정의할 수 없습니다.