사용자 정의 규칙
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
GitLab Duo Agent Platform에서 사용자 정의 규칙을 사용하여 생성된 출력(예: 코드 또는 문서)이 특정 지침이나 개발 스타일 가이드와 같은 기타 요구 사항에 맞도록 할 수 있습니다. 다음 Agent Platform 기능은 사용자 정의 규칙을 지원합니다:
히스토리
GitLab Duo Agent Platform에서 사용자 정의 규칙을 사용하여 생성된 출력(예: 코드 또는 문서)이 특정 지침이나 개발 스타일 가이드와 같은 기타 요구 사항에 맞도록 할 수 있습니다.
다음 Agent Platform 기능은 사용자 정의 규칙을 지원합니다:
- GitLab Duo 에이전틱 Chat (GitLab UI 및 로컬 환경)
- 기본 및 사용자 정의 에이전트
- Code Review Flow를 제외한 기본 및 사용자 정의 플로우
사용자 정의 규칙 만들기#
GitLab Duo 사용 방식에 따라 두 가지 수준에서 사용자 정의 규칙을 만들 수 있습니다:
| 수준 | GitLab UI | 에디터 확장 | GitLab Duo CLI |
|---|---|---|---|
| 사용자 수준: 모든 프로젝트에 적용 | 아니오 | 가능 | 가능 |
| 프로젝트 수준: 특정 프로젝트에만 적용 | 가능 | 가능 | 가능 |
IDE에서 다중 루트 작업 공간을 사용하는 경우 작업 공간의 각 프로젝트에 대한 프로젝트 수준 사용자 정의 규칙을 만들 수 있습니다.
사용자 수준 규칙과 프로젝트 수준 규칙이 모두 있는 경우 GitLab Duo Chat은 대화에 두 규칙 모두 적용합니다.
전제 조건:
- Agent Platform 전제 조건을 충족합니다.
- 로컬 환경의 GitLab Duo의 경우 다음 중 하나를 설치하고 구성합니다:
- GitLab for VS Code 6.32.2 이상.
- JetBrains IDEs용 GitLab Duo 플러그인 3.12.2 이상.
- GitLab for Visual Studio 0.60.0 이상.
- GitLab Duo CLI 8.43.0 이상.
사용자 정의 규칙을 만들기 전에 존재하는 대화는 해당 규칙을 따르지 않습니다.
사용자 수준 사용자 정의 규칙 만들기#
사용자 수준 사용자 정의 규칙은 로컬 환경에서 모든 프로젝트에 적용됩니다.
-
홈 디렉토리에 사용자 정의 규칙 파일을 만듭니다:
- Linux 또는 macOS에서는
~/.gitlab/duo/chat-rules.md에 파일을 만듭니다. - Windows에서는
%APPDATA%\GitLab\duo\chat-rules.md에 파일을 만듭니다.
- Linux 또는 macOS에서는
-
파일에 사용자 정의 규칙을 추가합니다. 예를 들어:
- Don't put comments in the generated code - Be brief in your explanations - Always use single quotes for JavaScript strings -
파일을 저장합니다.
-
새 사용자 정의 규칙을 적용하려면 다음 중 하나를 수행합니다:
- 새 GitLab Duo Chat 대화를 시작합니다.
- Chat 대화, 토론, 이슈 또는 머지 리퀘스트에서 에이전트를 사용합니다.
- 플로우를 트리거합니다.
특정 환경 변수를 설정한 경우 다른 위치에 사용자 정의 규칙 파일을 만들 수 있습니다:
GLAB_CONFIG_DIR환경 변수를 설정한 경우$GLAB_CONFIG_DIR/chat-rules.md에 파일을 만듭니다.XDG_CONFIG_HOME환경 변수를 설정한 경우$XDG_CONFIG_HOME/gitlab/duo/chat-rules.md에 파일을 만듭니다.
프로젝트 수준 사용자 정의 규칙 만들기#
프로젝트 수준 사용자 정의 규칙은 특정 프로젝트에만 적용됩니다. 팀에서 사용하는 개발 스타일 가이드를 적용하는 등 프로젝트에 사용자 정의 규칙 세트를 적용하는 데 이 방법을 사용할 수 있습니다.
-
프로젝트 루트에 사용자 정의 규칙 파일을 만듭니다:
.gitlab/duo/chat-rules.md. -
파일에 사용자 정의 규칙을 추가합니다. 예를 들어:
- Don't put comments in the generated code - Be brief in your explanations - Always use single quotes for JavaScript strings -
파일을 저장합니다.
-
프로젝트의 경우: Git 저장소에
.gitlab/duo/chat-rules.md파일을 추가합니다. 그러면 Chat, 에이전트 및 플로우가 저장소에서 사용자 정의 규칙을 컨텍스트로 자동으로 읽습니다. -
새 사용자 정의 규칙을 적용하려면 새 GitLab Duo 대화를 시작합니다.
사용자 정의 규칙을 변경할 때마다 이 작업을 수행해야 합니다.
자세한 내용은 GitLab Duo Chat의 사용자 정의 규칙 튜토리얼 블로그를 참조하십시오.
사용자 정의 규칙 업데이트#
사용자 정의 규칙을 업데이트하려면 사용자 정의 규칙 파일을 편집하고 저장합니다. 그런 다음 새 GitLab Duo 대화를 시작하여 업데이트된 규칙을 적용합니다.
Chat을 사용하여 사용자 정의 규칙 파일을 직접 편집할 수 없습니다.
사용자 정의 규칙에 대한 변경 사항을 승인해야 하는 사람을 관리하려면 코드 소유자를 사용합니다.
