사용자 정의 에이전트
Offering: 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를 선택합니다.
-
새 에이전트를 선택합니다.
-
기본 정보 아래에서:
- 표시 이름에 에이전트 이름을 입력합니다.
- 설명에 에이전트 설명을 입력합니다.
-
가시성 및 액세스 아래에서 가시성에 비공개 또는 공개를 선택합니다.
-
프롬프트 아래에서 시스템 프롬프트에 에이전트의 성격, 전문성 및 동작을 정의하는 프롬프트를 입력합니다.
-
선택 사항. 사용 가능한 도구 아래에서 도구 드롭다운 목록에서 에이전트가 액세스할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 자동으로 이슈를 만들도록 하려면 이슈 생성을 선택합니다.
[!note] 일부 도구는 IDE 확장이 필요하며 웹 UI에서는 사용할 수 없습니다. 자세한 내용은 에이전트 도구 목록을 참조합니다.
-
에이전트 만들기를 선택합니다.
에이전트를 만들려면:
-
상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
-
AI 카탈로그를 선택한 다음 에이전트 탭을 선택합니다.
-
새 에이전트를 선택합니다.
-
기본 정보 아래에서:
- 표시 이름에 에이전트 이름을 입력합니다.
- 설명에 에이전트 설명을 입력합니다.
-
가시성 및 액세스 아래에서:
- 관리자 드롭다운 목록에서 에이전트의 프로젝트를 선택합니다.
- 가시성에 비공개 또는 공개를 선택합니다.
-
프롬프트 아래에서 시스템 프롬프트에 에이전트의 성격, 전문성 및 동작을 정의하는 프롬프트를 입력합니다.
-
선택 사항. 사용 가능한 도구 아래에서 도구 드롭다운 목록에서 에이전트가 액세스할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 자동으로 이슈를 만들도록 하려면 이슈 생성을 선택합니다.
사용 가능한 도구 목록은 내장 도구 정의를 참조합니다.
-
에이전트 만들기를 선택합니다.
에이전트가 AI 카탈로그에 나타납니다. Chat과 함께 에이전트를 사용하려면 활성화해야 합니다.
에이전트 활성화#
에이전트를 활성화하여 Chat과 함께 사용합니다.
프로젝트에서 에이전트를 활성화하면 동시에 해당 프로젝트의 최상위 그룹에서도 활성화됩니다.
전제 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.
에이전트를 활성화하려면:
- 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- AI > Agents를 선택합니다.
- 관리됨 탭을 선택한 다음 활성화할 에이전트를 선택합니다.
- 오른쪽 상단에서 활성화를 선택합니다.
- 프로젝트 아래에서 에이전트를 활성화할 프로젝트를 선택합니다.
- 활성화를 선택합니다.
에이전트를 활성화하려면:
- 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
- AI 카탈로그를 선택한 다음 에이전트 탭을 선택합니다.
- 활성화할 에이전트를 선택합니다.
- 오른쪽 상단에서 활성화를 선택합니다.
- 프로젝트 아래에서 에이전트를 활성화할 프로젝트를 선택합니다.
- 활성화를 선택합니다.
에이전트가 그룹 및 프로젝트 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 이상을 설치하고 구성합니다.
- 기본 GitLab Duo 네임스페이스를 설정합니다.
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 네임스페이스를 설정합니다.
먼저 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를 선택합니다.
- 제거할 에이전트를 찾고 작업 (⋮) > 비활성화를 선택합니다.
- 확인 대화 상자에서 비활성화를 선택합니다.
에이전트가 더 이상 프로젝트에 나타나지 않으며 Chat에서 사용할 수 없습니다.
에이전트 복제#
원본을 덮어쓰지 않고 에이전트를 변경하려면 기존 에이전트의 복사본을 만듭니다.
전제 조건:
- 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.
에이전트를 복제하려면:
- 상단 표시줄에서 검색 또는 이동 > 탐색을 선택합니다.
- AI 카탈로그를 선택한 다음 에이전트 탭을 선택합니다.
- 복제할 에이전트를 선택합니다.
- 오른쪽 상단에서 작업 (⋮) > 복제를 선택합니다.
- 선택 사항. 변경하려는 필드를 편집합니다.
- 에이전트 만들기를 선택합니다.
에이전트 편집#
에이전트 구성을 변경하기 위해 에이전트를 편집합니다.
전제 조건:
- 관리 프로젝트의 구성원이고 Maintainer 또는 Owner 역할이 있어야 합니다.
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
- AI > Agents를 선택합니다.
- 편집할 에이전트를 선택합니다.
- 오른쪽 상단에서 편집을 선택합니다.
- 변경하려는 필드를 편집한 다음 변경 사항 저장을 선택합니다.
에이전트 숨기기#
AI 카탈로그에서 에이전트를 제거하려면 에이전트를 숨깁니다.
에이전트를 숨기면 사용자가 활성화할 수 없습니다. 그러나 이미 활성화된 그룹 및 프로젝트에서는 에이전트와 계속 상호 작용할 수 있습니다.
전제 조건:
- 관리 프로젝트의 구성원이고 Maintainer 또는 Owner 역할이 있어야 합니다.
에이전트를 숨기려면:
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
- AI > Agents를 선택합니다.
- 숨길 에이전트를 찾고 작업 (⋮) > 숨기기를 선택합니다.
- 확인 대화 상자에서 확인을 선택합니다.
에이전트 삭제#
인스턴스에서 에이전트를 영구적으로 제거하려면 에이전트를 삭제합니다.
전제 조건:
- 관리자여야 합니다.
- 상단 표시줄에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
- AI > Agents를 선택합니다.
- 삭제할 에이전트를 찾고 작업 (⋮) > 삭제를 선택합니다.
- 확인 대화 상자에서 삭제를 선택합니다.
사용자 정의 에이전트 켜기/끄기#
히스토리
- GitLab 19.0에서 도입됨.
기본적으로 사용자 정의 에이전트는 켜져 있습니다. 최상위 그룹 또는 인스턴스에 대해 켜거나 끌 수 있습니다.
사용자 정의 에이전트가 꺼지면:
-
사용자가 사용자 정의 에이전트를 생성, 활성화, 비활성화, 수정 또는 실행할 수 없습니다.
-
기존 사용자 정의 에이전트가 AI > Agents > Enabled 아래 프로젝트에 더 이상 표시되지 않습니다.
-
프로젝트에서 생성된 사용자 정의 에이전트는 AI > Agents > Managed 아래에 나타나지만 수정하거나 실행할 수 없습니다.
전제 조건:
- 그룹에 대한 Owner 역할이 있어야 합니다.
- 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
- 구성 변경을 선택합니다.
- 사용자 정의 에이전트 및 플로우 아래에서 사용자 정의 에이전트 허용 체크박스를 선택하거나 지웁니다.
- 변경 사항 저장을 선택합니다.
이 설정은 그룹의 모든 하위 그룹에 적용됩니다.
전제 조건:
- 관리자여야 합니다.
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
- 구성 변경을 선택합니다.
- 사용자 정의 에이전트 및 플로우 아래에서 사용자 정의 에이전트 허용 체크박스를 선택하거나 지웁니다.
- 변경 사항 저장을 선택합니다.
인스턴스 수준 설정이 꺼져 있으면 그룹 수준 설정으로 재정의할 수 없습니다.
