GitLab Duo Agent Platform에서 커스텀 규칙을 사용하면 생성된 출력(예: 코드 또는 문서)이 특정 지침이나 개발 스타일 가이드 등의 요구 사항에 맞게 조정됩니다.

커스텀 규칙을 지원하는 Agent Platform 기능:

• GitLab UI 및 로컬 환경의 GitLab Duo Agentic Chat.

• 파운데이션 및 커스텀 에이전트.

• Code Review Flow를 제외한 파운데이션 및 커스텀 플로우.

커스텀 규칙 생성#

GitLab Duo 사용 방법에 따라 두 가지 수준에서 커스텀 규칙을 생성할 수 있습니다:

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 이상.

커스텀 규칙을 생성하기 전에 존재하던 대화는 해당 규칙을 따르지 않습니다.

사용자 수준 커스텀 규칙 생성#

사용자 수준 커스텀 규칙은 로컬 환경의 모든 프로젝트에 적용됩니다.

1. 홈 디렉토리에 커스텀 규칙 파일을 생성합니다:

   • Linux 또는 macOS에서는 ~/.gitlab/duo/chat-rules.md에 파일을 생성합니다.

   • Windows에서는 %APPDATA%\GitLab\duo\chat-rules.md에 파일을 생성합니다.

2. 파일에 커스텀 규칙을 추가합니다. 예를 들어:

   - 생성된 코드에 주석을 넣지 말 것
   - 설명을 간략하게 할 것
   - JavaScript 문자열에 항상 단일 따옴표 사용
   

3. 파일을 저장합니다.

4. 새 커스텀 규칙을 적용하려면 다음 중 적절한 작업을 수행합니다:

   • 새 GitLab Duo Chat 대화를 시작합니다.

   • Chat 대화, 토론, 이슈 또는 머지 리퀘스트에서 에이전트를 사용합니다.

   • 플로우를 트리거합니다.

특정 환경 변수를 설정한 경우, 커스텀 규칙 파일을 다른 위치에 생성합니다:

• GLAB_CONFIG_DIR 환경 변수를 설정한 경우, $GLAB_CONFIG_DIR/chat-rules.md에 파일을 생성합니다.

• XDG_CONFIG_HOME 환경 변수를 설정한 경우, $XDG_CONFIG_HOME/gitlab/duo/chat-rules.md에 파일을 생성합니다.

프로젝트 수준 커스텀 규칙 생성#

프로젝트 수준 커스텀 규칙은 특정 프로젝트에만 적용됩니다. 이 방법을 사용하여 팀의 프로젝트에 커스텀 규칙 세트를 적용할 수 있습니다. 예를 들어, 팀에서 사용하는 개발 스타일 가이드 세트를 적용할 수 있습니다.

1. 프로젝트 루트에 커스텀 규칙 파일을 생성합니다: .gitlab/duo/chat-rules.md.

2. 파일에 커스텀 규칙을 추가합니다. 예를 들어:

   - 생성된 코드에 주석을 넣지 말 것
   - 설명을 간략하게 할 것
   - JavaScript 문자열에 항상 단일 따옴표 사용
   

3. 파일을 저장합니다.

4. 프로젝트의 경우: .gitlab/duo/chat-rules.md 파일을 Git 저장소에 추가합니다. Chat, 에이전트 및 플로우는 저장소에서 커스텀 규칙을 컨텍스트로 자동으로 읽습니다.

5. 새 커스텀 규칙을 적용하려면 새 GitLab Duo 대화를 시작합니다.

커스텀 규칙을 변경할 때마다 이 작업을 수행해야 합니다.

자세한 내용은 GitLab Duo Chat 커스텀 규칙 튜토리얼 블로그를 참조하세요.

커스텀 규칙 업데이트#

커스텀 규칙을 업데이트하려면 커스텀 규칙 파일을 편집하고 저장합니다. 그런 다음 업데이트된 규칙을 적용하려면 새 GitLab Duo 대화를 시작합니다.

Chat을 사용하여 커스텀 규칙 파일을 직접 편집할 수 없습니다.

커스텀 규칙에 대한 변경 사항을 승인해야 하는 사람을 관리하려면 Code Owners를 사용합니다.

관련 항목#

• AGENTS.md 커스터마이제이션 파일

• 에이전트 스킬