지침, 스킬, 메모리 및 MCP로 Genie 코드 맞춤 설정하기

Genie Code는 팀이 실제로 어떻게 작동하는지(코딩 표준, 내부 워크플로, 공유 도구, 과거 결정의 배경 맥락 등)를 이해할 때 가장 효과적입니다.

이것이 바로 조직과 워크플로에 맞게 Genie Code를 맞춤 설정할 수 있는 일련의 기능을 도입한 이유입니다. 지침은 팀 전체의 선호도를 정의하는 데 도움이 되고, 스킬은 반복 가능한 워크플로를 캡처하며, MCP 서버는 Genie Code를 Jira, GitHub, Google Drive와 같은 시스템에 직접 연결합니다.

사용자 지정 지침

사용자 지정 지침을 사용하면 Genie Code가 모든 에이전트 모드 세션에 적용하는 영구적인 선호도를 설정할 수 있습니다. 선호하는 코딩 언어, 출력 형식 또는 일반적인 스타일 가이드라인과 같이 작업 방식에 항상 적용되는 사항에 적합합니다.

한계점은 지침이 전역적으로 적용된다는 것입니다. SQL 서식 지정 규칙을 추가하면 SQL을 작성하든 Python을 디버깅하든 상관없이 실행됩니다. 모든 곳에 적용되는 선호도의 경우 지침이 적합한 도구입니다. 특정 작업에만 관련된 맥락의 경우 더 타겟팅된 도구가 필요합니다.

팀 수준의 규칙을 위해 Genie Code는 프로젝트 내의 AGENTS.md 및 CLAUDE.md 파일도 자동으로 감지할 수 있습니다. 이러한 파일이 리포지토리에 체크인되면 Genie Code가 자동으로 이를 인식하므로 팀원이 동일한 맥락을 개별적으로 구성할 필요가 없습니다.

에이전트 스킬

에이전트 스킬은 사용자가 작업하는 방식대로 특정 작업을 수행하는 방법을 Genie Code에 가르치는 방법입니다.

스킬은 Genie Code가 에이전트 모드에서 작동할 때 사용할 수 있는 워크플로, 패턴 또는 작업을 설명하는 마크다운(markdown) 기반 패키지입니다. 스킬에는 전역적으로 적용되는 대신 특정 작업으로 범위가 제한된 가이드, 재사용 가능한 코드 및 실행 가능한 스크립트가 포함될 수 있습니다.

각 스킬에는 Genie Code가 언제 해당 스킬이 관련이 있는지 판단하는 데 도움이 되는 이름과 설명이 포함되어 있습니다. 요청이 스킬과 일치하면 Genie Code는 해당 스킬을 로드하고 여기에 포함된 가이드, 패턴 및 코드를 사용하여 적절하게 응답합니다.

스킬을 추가하는 방법은 무엇인가요?

시작하려면 다음 단계를 따르세요.

1. 스킬 폴더를 엽니다. Genie Code에서 Settings(설정)를 열고 User Skills(사용자 스킬)로 이동한 다음 Open Skills Folder(스킬 폴더 열기)를 선택합니다. 그러면 개인 스킬 디렉터리 (/Users/{username}/.assistant/skills/)가 열립니다.
2. 스킬을 생성하거나 업데이트합니다. 새 마크다운 파일을 추가합니다. Genie Code가 언제 적용해야 하는지 알 수 있도록 각 스킬에는 명확한 이름과 설명이 포함되어야 합니다. 관련 파일을 폴더로 정리하고, 필요한 경우 더 고급 워크플로를 위한 스크립트를 포함할 수 있습니다.

워크스페이스 스킬

개인 스킬 외에도 워크스페이스 관리자는 워크스페이스의 모든 사람이 자동으로 사용할 수 있는 스킬을 생성할 수 있습니다. 워크스페이스 스킬은 Workspace/.assistant/skills/에 저장됩니다.

워크스페이스 스킬은 개인 스킬과 동일한 형식을 따르지만, 개인이 아닌 팀으로 범위가 지정됩니다. 따라서 조직 전체에서 일관되게 공유하고 사용해야 하는 워크플로에 적합합니다. 예를 들어, ML 파이프라인 명명 규칙을 강제하거나, 장애 대응 중에 Genie Code를 올바른 내부 런북으로 라우팅하거나, 모든 새 파이프라인에 팀의 표준 데이터 품질 검사를 적용하는 스킬 등이 있습니다.

MCP 서버

스킬이 머릿속에 있는 맥락이나 팀의 표준을 다룬다면, MCP 서버는 이미 다른 곳에 존재하는 맥락을 다룹니다.

2025년 초, 당사는 거버넌스가 유지되고 확장 가능한 방식으로 AI 에이전트가 풍부한 외부 맥락을 사용할 수 있도록 Databricks의 MCP 지원을 도입했습니다. MCP는 프롬프트나 지침에 해당 맥락을 직접 내장하지 않고도 도구, 데이터 및 워크플로를 Genie Code에 노출할 수 있는 표준화된 방법을 제공합니다.

이제 Genie Code는 워크스페이스에 추가되고 사용 권한이 있는 모든 MCP 서버를 활용할 수 있습니다. 워크스페이스 관리자는 사용 가능한 서버를 제어하고, 사용자는 필요에 따라 승인된 소스 중에서 선택할 수 있습니다.

Google Drive, SharePoint, GitHub와 같은 일반적인 도구의 경우, Databricks는 수동 토큰 구성 없이 인증을 처리하는 관리형 OAuth 흐름(현재 베타 버전)도 제공합니다. 이를 활성화하려면 미리 보기 설정에서 'Third Party Connectors for Agents(에이전트용 타사 커넥터)'를 켜세요. 그런 다음 모든 사용자가 Genie Code 프롬프트 표시줄에서 플러스(+) 버튼을 클릭하기만 하면 이러한 MCP 서버를 활성화할 수 있습니다.

MCP는 중요한 맥락이 이미 존재하지만 Genie Code에서 액세스하기 어려운 경우를 위해 설계되었습니다. 예를 들면 다음과 같습니다.

• 내부 문서 시스템. 팀에서는 종종 Confluence와 같은 도구에 런북이나 운영 문서를 보관합니다. 프롬프트에 섹션을 복사하는 대신 해당 콘텐츠를 한 번 노출하고 관련이 있을 때 참조할 수 있습니다.
• 내부 도구 및 서비스. 플랫폼 팀은 설정, 검증 또는 배포를 위한 API나 스크립트를 유지 관리할 수 있습니다. MCP를 사용하면 이러한 기능을 반복해서 설명하거나 붙여넣을 필요 없이 Genie Code에서 직접 사용할 수 있습니다.

이러한 경우 MCP는 수동 복사 및 붙여넣기를 구조화되고 재사용 가능한 방식으로 대체하여 필요한 경우에만 올바른 맥락을 사용할 수 있도록 합니다.

MCP 서버를 추가하는 방법은 무엇인가요?

Databricks는 Databricks 서비스용 관리형 서버, Unity Catalog를 통해 연결된 외부 서버, Databricks Apps에 호스팅된 사용자 지정 MCP 서버를 포함하여 여러 유형의 MCP 서버를 지원합니다. Genie Code 설정 패널에서 직접 액세스할 수 있는 MCP 마켓플레이스에서 사용 가능한 서버를 찾아볼 수 있습니다. 워크스페이스 관리자는 사용 가능한 서버를 제어하고, 사용자는 사용 권한이 있는 서버 중에서 선택할 수 있습니다.

워크스페이스에서 MCP 서버를 사용할 수 있게 되면 Genie Code에서 이를 사용하는 방법은 간단합니다.

1. Genie Code 설정을 엽니다
2. Add Server(서버 추가)를 선택합니다
3. 사용 가능한 MCP 서버 유형 중에서 선택합니다
4. 선택 사항을 저장합니다
5. 서버에 인증이 필요한 경우 로그인 프롬프트에 따라 연결을 승인합니다. 자격 증명은 안전하게 저장되며 세션마다 다시 인증할 필요가 없습니다.

MCP 서버는 추가한 즉시 사용할 수 있습니다. Genie Code는 관련이 있을 때 이러한 서버의 도구에 자동으로 액세스합니다.

팁 및 요령

• Genie Code가 스킬을 생성하도록 하세요. 에이전트 모드에서 워크플로를 진행한 후 Genie Code에 이를 스킬로 캡처하도록 지시하기만 하면 됩니다. 마크다운 파일이 자동으로 생성되어 스킬 폴더에 저장됩니다.
• 스킬을 집중적으로 유지하세요. 스킬 파일당 하나의 워크플로를 유지하면 Genie Code가 언제 적용해야 하는지 더 쉽게 파악할 수 있고 시간이 지나도 유지 관리하기가 더 쉬워집니다. Genie Code는 이름과 설명을 사용하여 스킬의 관련성 여부를 결정하므로 구체적일수록 좋습니다.
• 스킬은 마크다운 파일일 뿐입니다. 즉, 팀 전체에서 쉽게 공유하고, 버전을 관리하고, 동기화할 수 있습니다. 바로 사용할 수 있는 시작 예제는 Genie Code 스킬 데모 리포지토리를 참조하세요.
• 이식 가능한 팀 규칙: Genie Code는 워크스페이스에서 AGENTS.md 및 CLAUDE.md 파일을 자동으로 감지하고 추가 설정 없이 적용합니다. 팀은 어디서 작업하든 일관된 맥락을 유지하면서 리포지토리와 개발 환경 전반에서 동일한 규칙, 지침 및 워크플로를 공유할 수 있습니다.

지금 바로 Genie Code를 맞춤 설정해 보세요

Genie Code를 에이전트 모드로 사용할 때 지침, 스킬, MCP 서버를 모두 사용할 수 있습니다.

자세한 내용은 Genie Code 제품 문서를 참조하세요.

(이 글은 AI의 도움을 받아 번역되었습니다. 원문이 궁금하시다면 여기를 클릭해 주세요)