사용자 정의 에이전트

요약

에이전트는 AI를 사용해 작업을 수행하고 복잡한 질문에 답합니다. 에이전트를 사용할 준비가 되면 에이전트를 활성화한 뒤 GitLab UI, VS Code, JetBrains IDE의 GitLab Duo Chat에서 사용합니다.

Model information

GitLab Duo with self-hosted models에서 사용할 수 있습니다.

히스토리

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 제거.
Maintainer가 프로젝트에서 직접 활성화하는 기능은 GitLab 18.10에서 ai_catalog_project_level_enablement 기능 플래그와 함께 도입. 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 Catalog에서 GitLab 이 만든 에이전트를 찾아볼 수 있습니다.

에이전트를 사용할 준비가 되면 에이전트를 활성화한 뒤 GitLab UI, VS Code, JetBrains IDE의 GitLab Duo Chat에서 사용합니다.

사전 요구 사항#

GitLab Duo Agent Platform의 사전 요구 사항을 충족해야 합니다.
커스텀 에이전트가 켜져 있어야 합니다.

에이전트 가시성#

히스토리

비공개 에이전트를 볼 수 있는 권한 범위가 GitLab 18.7에서 확대.
제한 가시성은 GitLab 19.3에서 ai_catalog_internal_visibility 기능 플래그와 함께 도입. 기본적으로 활성화.
GitLab 19.4에서 일반 공개. 기능 플래그 ai_catalog_internal_visibility 제거.

커스텀 에이전트를 만들 때는 에이전트를 관리할 프로젝트를 선택하고, 에이전트를 공개·비공개·제한 중 어느 가시성으로 둘지 지정합니다.

공개 에이전트의 특징은 다음과 같습니다.

누구나 볼 수 있으며, 사전 요구 사항을 충족하는 모든 프로젝트에서 활성화할 수 있습니다.

제한 에이전트의 특징은 다음과 같습니다.

관리 프로젝트가 속한 최상위 그룹의 모든 프로젝트 멤버가 보고 사용할 수 있습니다.
같은 최상위 그룹의 다른 프로젝트에서 활성화할 수 있습니다.
해당 최상위 그룹 밖에서는 보거나 켤 수 없습니다.
Explore의 AI Catalog에서는 볼 수 없습니다.
Explore의 AI Catalog가 아니라 프로젝트에서만 만들 수 있습니다.

해당 최상위 그룹 밖의 프로젝트가 이미 켠 공개 에이전트는 제한 에이전트로 바꿀 수 없습니다.

비공개 에이전트의 특징은 다음과 같습니다.

관리 프로젝트의 멤버 중 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한을 가진 사용자만 볼 수 있습니다.
관리 프로젝트 외의 프로젝트에서는 활성화할 수 없습니다.

관리 프로젝트가 아닌 다른 프로젝트가 이미 켠 공개 또는 제한 에이전트는 비공개로 바꿀 수 없습니다.

프로젝트의 에이전트 보기#

사전 요구 사항:

프로젝트에 대한 Developer, Maintainer, Owner 중 하나의 권한이 있어야 합니다.

프로젝트에 연결된 에이전트 목록을 보려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
- 프로젝트에서 활성화된 에이전트를 보려면 Enabled 탭을 선택합니다.
- 프로젝트가 관리하는 에이전트를 보려면 Managed 탭을 선택합니다.

에이전트를 선택하면 세부 정보를 볼 수 있습니다.

에이전트 생성#

히스토리

제한 가시성은 GitLab 19.3에서 ai_catalog_internal_visibility 기능 플래그와 함께 도입. 기본적으로 활성화.
GitLab 19.4에서 일반 공개. 기능 플래그 ai_catalog_internal_visibility 제거.

에이전트는 프로젝트에서 만들거나 AI Catalog를 사용해 만들 수 있습니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 만들려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
New agent를 선택합니다.
Basic information에서 다음을 수행합니다.
1. Display name에 에이전트 이름을 입력합니다.
2. Description에 에이전트 설명을 입력합니다.
Visibility & access의 Visibility에서 Private, Restricted, Public 중 하나를 선택합니다.
Prompts의 System prompt에 에이전트의 성격, 전문 영역, 동작을 정의하는 프롬프트를 입력합니다.
선택 사항입니다. Available tools의 Tools 드롭다운 목록에서 에이전트가 사용할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 이슈를 자동으로 생성하도록 하려면 Create issue를 선택합니다.

[!note] 일부 도구는 IDE 확장이 필요하며 GitLab UI에서는 사용할 수 없습니다. 자세한 내용은 에이전트 도구 목록을 참고합니다.
Create agent를 선택합니다.

에이전트를 만들려면 다음을 수행합니다.

상단 바에서 Search or go to > Explore를 선택합니다.
AI Catalog를 선택한 다음 Agents 탭을 선택합니다.
New agent를 선택합니다.
Basic information에서 다음을 수행합니다.
1. Display name에 에이전트 이름을 입력합니다.
2. Description에 에이전트 설명을 입력합니다.
Visibility & access에서 다음을 수행합니다.
1. Managed by 드롭다운 목록에서 에이전트를 관리할 프로젝트를 선택합니다.
2. Visibility에서 Private 또는 Public을 선택합니다.
Prompts의 System prompt에 에이전트의 성격, 전문 영역, 동작을 정의하는 프롬프트를 입력합니다.
선택 사항입니다. Available tools의 Tools 드롭다운 목록에서 에이전트가 사용할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 이슈를 자동으로 생성하도록 하려면 Create issue를 선택합니다.

[!note] 일부 도구는 IDE 확장이 필요하며 GitLab UI에서는 사용할 수 없습니다. 자세한 내용은 에이전트 도구 목록을 참고합니다.
Create agent를 선택합니다.

에이전트가 AI Catalog에 표시됩니다. Chat에서 에이전트를 사용하려면 먼저 활성화해야 합니다.

에이전트 활성화#

히스토리

공개 에이전트를 여러 프로젝트에서 활성화하는 기능은 GitLab 19.2에서 ai_catalog_bulk_item_consumer_create 기능 플래그와 함께 도입. 기본적으로 활성화.
GitLab 19.4에서 기능 플래그 ai_catalog_bulk_item_consumer_create 제거.

Chat에서 사용하려면 에이전트를 활성화합니다.

프로젝트에서 에이전트를 활성화하면 해당 프로젝트의 최상위 그룹에서도 동시에 활성화됩니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
Managed 탭을 선택한 다음 활성화할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Enable을 선택합니다.
Project에서 에이전트를 활성화할 프로젝트를 선택합니다.
Enable을 선택합니다.

에이전트를 활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to > Explore를 선택합니다.
AI Catalog를 선택한 다음 Agents 탭을 선택합니다.
활성화할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Enable을 선택합니다.
Project에서 에이전트를 활성화할 프로젝트를 선택합니다.

공개 또는 제한 에이전트를 여러 프로젝트에서 켜려면 Project 드롭다운 목록에서 해당 프로젝트를 선택합니다. 최대 100개 프로젝트를 선택할 수 있습니다.
Enable을 선택합니다.

에이전트가 그룹과 프로젝트의 AI > Agents 페이지에 표시됩니다. 이제 최상위 그룹에 속한 모든 프로젝트의 멤버가 자신의 프로젝트에서 에이전트를 활성화할 수 있습니다.

프로젝트에서 에이전트와 새 채팅을 시작할 수 있습니다. 자세한 내용은 에이전트 선택을 참고합니다.

프로젝트에서 활성화#

에이전트가 최상위 그룹에서 이미 활성화되어 있다면 그 그룹의 프로젝트에서도 활성화할 수 있습니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
에이전트가 프로젝트의 최상위 그룹에서 활성화되어 있어야 합니다.

프로젝트에서 에이전트를 활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
오른쪽 위 모서리에서 Enable agent from group을 선택합니다.
드롭다운 목록에서 활성화할 에이전트를 선택합니다.
Enable을 선택합니다.

에이전트가 프로젝트의 AI > Agents 페이지에 표시됩니다.

프로젝트에서 에이전트와 새 채팅을 시작할 수 있습니다.

에이전트 사용#

커스텀 에이전트는 GitLab UI, VS Code, JetBrains IDE에서 사용할 수 있습니다.

GitLab UI에서 사용#

사전 요구 사항:

사용하려는 프로젝트에서 에이전트를 활성화합니다.

GitLab UI에서 커스텀 에이전트를 사용하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
이슈, 에픽 또는 머지 리퀘스트를 엽니다.
GitLab Duo 사이드바에서 Add new chat ([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 탭을 선택합니다.
New chat ([duo-chat-new]) 드롭다운 목록에서 커스텀 에이전트를 선택합니다.
질문이나 요청을 입력합니다.

JetBrains IDE에서 사용#

사전 요구 사항:

사용하려는 프로젝트에서 에이전트를 활성화합니다.
JetBrains IDE 용 GitLab Duo 플러그인 3.19.0 이상을 설치하고 설정합니다.
기본 GitLab Duo 네임스페이스를 설정합니다.

먼저 GitLab Duo Agent Platform을 활성화합니다.

JetBrains IDE에서 Settings > Tools > GitLab Duo로 이동합니다.
GitLab Duo Agent Platform에서 Enable GitLab Duo Agent Platform 체크박스를 선택합니다.
재시작하라는 안내가 표시되면 IDE를 재시작합니다.

그런 다음 커스텀 에이전트를 사용하려면 다음을 수행합니다.

JetBrains IDE의 오른쪽 도구 창 바에서 GitLab Duo Agent Platform ([duo-agentic-chat])을 선택합니다.
Chat 탭을 선택합니다.
New chat ([duo-chat-new]) 드롭다운 목록에서 커스텀 에이전트를 선택합니다.
질문이나 요청을 입력합니다.

에이전트 비활성화#

사전 요구 사항:

그룹에서는 Maintainer 또는 Owner 권한이 있어야 합니다.
프로젝트에서는 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 비활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
제거할 에이전트를 찾아 Actions (⋮) > Disable을 선택합니다.
확인 대화 상자에서 Disable을 선택합니다.

에이전트가 프로젝트에 더 이상 표시되지 않으며 Chat에서도 사용할 수 없습니다.

에이전트 복제#

원본을 덮어쓰지 않고 에이전트를 수정하려면 기존 에이전트의 사본을 만듭니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 복제하려면 다음을 수행합니다.

상단 바에서 Search or go to > Explore를 선택합니다.
AI Catalog를 선택한 다음 Agents 탭을 선택합니다.
복제할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Actions (⋮) > Duplicate를 선택합니다.
에이전트를 복제할 프로젝트를 선택합니다.
선택 사항입니다. 변경할 필드를 편집합니다.
Create agent를 선택합니다.

에이전트 편집#

에이전트 설정을 변경하려면 에이전트를 편집합니다.

사전 요구 사항:

관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
편집할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Edit를 선택합니다.
변경할 필드를 편집한 다음 Save changes를 선택합니다.

에이전트 숨기기#

AI Catalog에서 제외하려면 에이전트를 숨깁니다.

에이전트를 숨기면 사용자가 그 에이전트를 활성화할 수 없습니다. 다만 이미 활성화된 그룹과 프로젝트에서는 계속 사용할 수 있습니다.

사전 요구 사항:

관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 숨기려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
숨길 에이전트를 찾아 Actions (⋮) > Hide를 선택합니다.
확인 대화 상자에서 Confirm을 선택합니다.

에이전트 삭제#

인스턴스에서 제거하려면 에이전트를 삭제합니다. 관리 프로젝트가 아닌 다른 프로젝트가 에이전트를 꺼 둔 경우에는 에이전트가 제거되지 않고 숨겨집니다.

사전 요구 사항:

관리자여야 합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
삭제할 에이전트를 찾아 Actions (⋮) > Delete를 선택합니다.
확인 대화 상자에서 Delete를 선택합니다.

커스텀 에이전트 켜기 또는 끄기#

히스토리

GitLab 19.0에서 도입.

커스텀 에이전트는 기본적으로 켜져 있습니다. 최상위 그룹 단위 또는 인스턴스 단위로 켜거나 끌 수 있습니다.

커스텀 에이전트를 끄면 다음과 같이 동작합니다.

사용자는 커스텀 에이전트를 만들거나, 활성화·비활성화하거나, 실행할 수 없습니다.
기존 커스텀 에이전트는 프로젝트의 AI > Agents > Enabled에 더 이상 표시되지 않습니다.
프로젝트에서 만든 커스텀 에이전트는 AI > Agents > Managed에 표시되지만 실행할 수 없습니다.
파운데이셔널 에이전트와 외부 에이전트는 계속 사용할 수 있습니다.

사전 요구 사항:

그룹에 대한 Owner 권한이 있어야 합니다.

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Custom and external agents and flows에서 Allow custom agents 체크박스를 선택하거나 선택 해제합니다.
Save changes를 선택합니다.

이 설정은 그룹의 모든 하위 그룹에 적용됩니다.

사전 요구 사항:

관리자여야 합니다.

오른쪽 위 모서리에서 Admin을 선택합니다.
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Custom and external agents and flows에서 Allow custom agents 체크박스를 선택하거나 선택 해제합니다.
Save changes를 선택합니다.

인스턴스 수준 설정을 끄면 그룹 수준 설정으로 이를 재정의할 수 없습니다.

사용자 정의 에이전트

GitLab v19.5

Tier: [Free](../../../subscriptions/gitlab_credits.md#for-the-free-tier), Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-10-15

요약

Model information

GitLab Duo with self-hosted models에서 사용할 수 있습니다.

히스토리

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 제거.
Maintainer가 프로젝트에서 직접 활성화하는 기능은 GitLab 18.10에서 ai_catalog_project_level_enablement 기능 플래그와 함께 도입. GitLab.com, GitLab Self-Managed, GitLab Dedicated에서 기본적으로 활성화.
GitLab 18.10에서 GitLab Credits를 사용하는 GitLab.com Free 티어에서 제공.
GitLab 18.11에서 기능 플래그 ai_catalog_project_level_enablement 제거.

에이전트를 사용할 준비가 되면 에이전트를 활성화한 뒤 GitLab UI, VS Code, JetBrains IDE의 GitLab Duo Chat에서 사용합니다.

사전 요구 사항#

GitLab Duo Agent Platform의 사전 요구 사항을 충족해야 합니다.
커스텀 에이전트가 켜져 있어야 합니다.

에이전트 가시성#

히스토리

비공개 에이전트를 볼 수 있는 권한 범위가 GitLab 18.7에서 확대.
제한 가시성은 GitLab 19.3에서 ai_catalog_internal_visibility 기능 플래그와 함께 도입. 기본적으로 활성화.
GitLab 19.4에서 일반 공개. 기능 플래그 ai_catalog_internal_visibility 제거.

커스텀 에이전트를 만들 때는 에이전트를 관리할 프로젝트를 선택하고, 에이전트를 공개·비공개·제한 중 어느 가시성으로 둘지 지정합니다.

공개 에이전트의 특징은 다음과 같습니다.

누구나 볼 수 있으며, 사전 요구 사항을 충족하는 모든 프로젝트에서 활성화할 수 있습니다.

제한 에이전트의 특징은 다음과 같습니다.

관리 프로젝트가 속한 최상위 그룹의 모든 프로젝트 멤버가 보고 사용할 수 있습니다.
같은 최상위 그룹의 다른 프로젝트에서 활성화할 수 있습니다.
해당 최상위 그룹 밖에서는 보거나 켤 수 없습니다.
Explore의 AI Catalog에서는 볼 수 없습니다.
Explore의 AI Catalog가 아니라 프로젝트에서만 만들 수 있습니다.

해당 최상위 그룹 밖의 프로젝트가 이미 켠 공개 에이전트는 제한 에이전트로 바꿀 수 없습니다.

비공개 에이전트의 특징은 다음과 같습니다.

관리 프로젝트의 멤버 중 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한을 가진 사용자만 볼 수 있습니다.
관리 프로젝트 외의 프로젝트에서는 활성화할 수 없습니다.

관리 프로젝트가 아닌 다른 프로젝트가 이미 켠 공개 또는 제한 에이전트는 비공개로 바꿀 수 없습니다.

프로젝트의 에이전트 보기#

사전 요구 사항:

프로젝트에 대한 Developer, Maintainer, Owner 중 하나의 권한이 있어야 합니다.

프로젝트에 연결된 에이전트 목록을 보려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
- 프로젝트에서 활성화된 에이전트를 보려면 Enabled 탭을 선택합니다.
- 프로젝트가 관리하는 에이전트를 보려면 Managed 탭을 선택합니다.

에이전트를 선택하면 세부 정보를 볼 수 있습니다.

에이전트 생성#

히스토리

제한 가시성은 GitLab 19.3에서 ai_catalog_internal_visibility 기능 플래그와 함께 도입. 기본적으로 활성화.
GitLab 19.4에서 일반 공개. 기능 플래그 ai_catalog_internal_visibility 제거.

에이전트는 프로젝트에서 만들거나 AI Catalog를 사용해 만들 수 있습니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 만들려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
New agent를 선택합니다.
Basic information에서 다음을 수행합니다.
1. Display name에 에이전트 이름을 입력합니다.
2. Description에 에이전트 설명을 입력합니다.
Visibility & access의 Visibility에서 Private, Restricted, Public 중 하나를 선택합니다.
Prompts의 System prompt에 에이전트의 성격, 전문 영역, 동작을 정의하는 프롬프트를 입력합니다.
선택 사항입니다. Available tools의 Tools 드롭다운 목록에서 에이전트가 사용할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 이슈를 자동으로 생성하도록 하려면 Create issue를 선택합니다.

[!note] 일부 도구는 IDE 확장이 필요하며 GitLab UI에서는 사용할 수 없습니다. 자세한 내용은 에이전트 도구 목록을 참고합니다.
Create agent를 선택합니다.

에이전트를 만들려면 다음을 수행합니다.

상단 바에서 Search or go to > Explore를 선택합니다.
AI Catalog를 선택한 다음 Agents 탭을 선택합니다.
New agent를 선택합니다.
Basic information에서 다음을 수행합니다.
1. Display name에 에이전트 이름을 입력합니다.
2. Description에 에이전트 설명을 입력합니다.
Visibility & access에서 다음을 수행합니다.
1. Managed by 드롭다운 목록에서 에이전트를 관리할 프로젝트를 선택합니다.
2. Visibility에서 Private 또는 Public을 선택합니다.
Prompts의 System prompt에 에이전트의 성격, 전문 영역, 동작을 정의하는 프롬프트를 입력합니다.
선택 사항입니다. Available tools의 Tools 드롭다운 목록에서 에이전트가 사용할 수 있는 도구를 선택합니다. 예를 들어 에이전트가 이슈를 자동으로 생성하도록 하려면 Create issue를 선택합니다.

[!note] 일부 도구는 IDE 확장이 필요하며 GitLab UI에서는 사용할 수 없습니다. 자세한 내용은 에이전트 도구 목록을 참고합니다.
Create agent를 선택합니다.

에이전트가 AI Catalog에 표시됩니다. Chat에서 에이전트를 사용하려면 먼저 활성화해야 합니다.

에이전트 활성화#

히스토리

공개 에이전트를 여러 프로젝트에서 활성화하는 기능은 GitLab 19.2에서 ai_catalog_bulk_item_consumer_create 기능 플래그와 함께 도입. 기본적으로 활성화.
GitLab 19.4에서 기능 플래그 ai_catalog_bulk_item_consumer_create 제거.

Chat에서 사용하려면 에이전트를 활성화합니다.

프로젝트에서 에이전트를 활성화하면 해당 프로젝트의 최상위 그룹에서도 동시에 활성화됩니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
Managed 탭을 선택한 다음 활성화할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Enable을 선택합니다.
Project에서 에이전트를 활성화할 프로젝트를 선택합니다.
Enable을 선택합니다.

에이전트를 활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to > Explore를 선택합니다.
AI Catalog를 선택한 다음 Agents 탭을 선택합니다.
활성화할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Enable을 선택합니다.
Project에서 에이전트를 활성화할 프로젝트를 선택합니다.

공개 또는 제한 에이전트를 여러 프로젝트에서 켜려면 Project 드롭다운 목록에서 해당 프로젝트를 선택합니다. 최대 100개 프로젝트를 선택할 수 있습니다.
Enable을 선택합니다.

프로젝트에서 에이전트와 새 채팅을 시작할 수 있습니다. 자세한 내용은 에이전트 선택을 참고합니다.

프로젝트에서 활성화#

에이전트가 최상위 그룹에서 이미 활성화되어 있다면 그 그룹의 프로젝트에서도 활성화할 수 있습니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.
에이전트가 프로젝트의 최상위 그룹에서 활성화되어 있어야 합니다.

프로젝트에서 에이전트를 활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 AI > Agents를 선택합니다.
오른쪽 위 모서리에서 Enable agent from group을 선택합니다.
드롭다운 목록에서 활성화할 에이전트를 선택합니다.
Enable을 선택합니다.

에이전트가 프로젝트의 AI > Agents 페이지에 표시됩니다.

프로젝트에서 에이전트와 새 채팅을 시작할 수 있습니다.

에이전트 사용#

커스텀 에이전트는 GitLab UI, VS Code, JetBrains IDE에서 사용할 수 있습니다.

GitLab UI에서 사용#

사전 요구 사항:

사용하려는 프로젝트에서 에이전트를 활성화합니다.

GitLab UI에서 커스텀 에이전트를 사용하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
이슈, 에픽 또는 머지 리퀘스트를 엽니다.
GitLab Duo 사이드바에서 Add new chat ([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 탭을 선택합니다.
New chat ([duo-chat-new]) 드롭다운 목록에서 커스텀 에이전트를 선택합니다.
질문이나 요청을 입력합니다.

JetBrains IDE에서 사용#

사전 요구 사항:

사용하려는 프로젝트에서 에이전트를 활성화합니다.
JetBrains IDE 용 GitLab Duo 플러그인 3.19.0 이상을 설치하고 설정합니다.
기본 GitLab Duo 네임스페이스를 설정합니다.

먼저 GitLab Duo Agent Platform을 활성화합니다.

JetBrains IDE에서 Settings > Tools > GitLab Duo로 이동합니다.
GitLab Duo Agent Platform에서 Enable GitLab Duo Agent Platform 체크박스를 선택합니다.
재시작하라는 안내가 표시되면 IDE를 재시작합니다.

그런 다음 커스텀 에이전트를 사용하려면 다음을 수행합니다.

JetBrains IDE의 오른쪽 도구 창 바에서 GitLab Duo Agent Platform ([duo-agentic-chat])을 선택합니다.
Chat 탭을 선택합니다.
New chat ([duo-chat-new]) 드롭다운 목록에서 커스텀 에이전트를 선택합니다.
질문이나 요청을 입력합니다.

에이전트 비활성화#

사전 요구 사항:

그룹에서는 Maintainer 또는 Owner 권한이 있어야 합니다.
프로젝트에서는 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 비활성화하려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
제거할 에이전트를 찾아 Actions (⋮) > Disable을 선택합니다.
확인 대화 상자에서 Disable을 선택합니다.

에이전트가 프로젝트에 더 이상 표시되지 않으며 Chat에서도 사용할 수 없습니다.

에이전트 복제#

원본을 덮어쓰지 않고 에이전트를 수정하려면 기존 에이전트의 사본을 만듭니다.

사전 요구 사항:

프로젝트에 대한 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 복제하려면 다음을 수행합니다.

상단 바에서 Search or go to > Explore를 선택합니다.
AI Catalog를 선택한 다음 Agents 탭을 선택합니다.
복제할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Actions (⋮) > Duplicate를 선택합니다.
에이전트를 복제할 프로젝트를 선택합니다.
선택 사항입니다. 변경할 필드를 편집합니다.
Create agent를 선택합니다.

에이전트 편집#

에이전트 설정을 변경하려면 에이전트를 편집합니다.

사전 요구 사항:

관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
편집할 에이전트를 선택합니다.
오른쪽 위 모서리에서 Edit를 선택합니다.
변경할 필드를 편집한 다음 Save changes를 선택합니다.

에이전트 숨기기#

AI Catalog에서 제외하려면 에이전트를 숨깁니다.

에이전트를 숨기면 사용자가 그 에이전트를 활성화할 수 없습니다. 다만 이미 활성화된 그룹과 프로젝트에서는 계속 사용할 수 있습니다.

사전 요구 사항:

관리 프로젝트의 멤버이면서 Maintainer 또는 Owner 권한이 있어야 합니다.

에이전트를 숨기려면 다음을 수행합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
숨길 에이전트를 찾아 Actions (⋮) > Hide를 선택합니다.
확인 대화 상자에서 Confirm을 선택합니다.

에이전트 삭제#

사전 요구 사항:

관리자여야 합니다.

상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
AI > Agents를 선택합니다.
삭제할 에이전트를 찾아 Actions (⋮) > Delete를 선택합니다.
확인 대화 상자에서 Delete를 선택합니다.

커스텀 에이전트 켜기 또는 끄기#

히스토리

GitLab 19.0에서 도입.

커스텀 에이전트는 기본적으로 켜져 있습니다. 최상위 그룹 단위 또는 인스턴스 단위로 켜거나 끌 수 있습니다.

커스텀 에이전트를 끄면 다음과 같이 동작합니다.

사용자는 커스텀 에이전트를 만들거나, 활성화·비활성화하거나, 실행할 수 없습니다.
기존 커스텀 에이전트는 프로젝트의 AI > Agents > Enabled에 더 이상 표시되지 않습니다.
프로젝트에서 만든 커스텀 에이전트는 AI > Agents > Managed에 표시되지만 실행할 수 없습니다.
파운데이셔널 에이전트와 외부 에이전트는 계속 사용할 수 있습니다.

사전 요구 사항:

그룹에 대한 Owner 권한이 있어야 합니다.

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Custom and external agents and flows에서 Allow custom agents 체크박스를 선택하거나 선택 해제합니다.
Save changes를 선택합니다.

이 설정은 그룹의 모든 하위 그룹에 적용됩니다.

사전 요구 사항:

관리자여야 합니다.

오른쪽 위 모서리에서 Admin을 선택합니다.
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Custom and external agents and flows에서 Allow custom agents 체크박스를 선택하거나 선택 해제합니다.
Save changes를 선택합니다.

인스턴스 수준 설정을 끄면 그룹 수준 설정으로 이를 재정의할 수 없습니다.