Skip to main content
최종 업데이트: 2026-04-08

1. 설정 화면 구성 요소

설정 항목역할영향 범위설정 주체
MCP 서버외부 도구 연동Agent 모드 세션개인
패널 뷰Docked/Side 전환UI만개인
User Instructions개인 지침모든 세션개인
Workspace Instructions조직 지침워크스페이스 전체관리자
Skills작업 템플릿 (Agent 전용)User/Workspace개인/관리자
참고 Workspace Instructions가 User Instructions보다 우선 적용됩니다.

2. User Instructions 작성법

생성 방법

UI: Settings → User instructions → Add instruction file 파일: /Workspace/Users/{email}/.assistant_instructions.md (최대 20,000자)

좋은 예시 (데이터 엔지니어)

## 내 역할과 컨텍스트
- 데이터 엔지니어, Delta Lake 파이프라인 + SQL 분석
- 프로덕션: main_catalog, 개발: dev_catalog
- 클라우드: AWS (S3, Glue, Redshift)

## 코딩 스타일
- PEP 8, SQL 대문자 키워드, snake_case
- docstring 필수, 타입 힌트 (Python 3.10+)

## 선호 라이브러리
- PySpark (pandas 대신), Plotly, MLflow + scikit-learn

## 보안 규칙 (절대 위반 금지)
- 프로덕션(main_catalog.prod.*) 수정 금지
- DROP/DELETE/UPDATE 생성 금지
- 임시 결과: dev_catalog.sandbox.simyung
- 민감 컬럼(ssn, email, phone) 마스킹
- 자격 증명 하드코딩 금지

## 응답 스타일
- 코드 앞에 설명, 복잡한 쿼리에 인라인 주석, 한국어 응답

나쁜 예시

문제예시이유
너무 모호”좋은 코드 짜줘”구체적 행동 변화 유도 불가
상충”간결하게” + “모든 에러 처리” + “상세 docstring”우선순위 미정
무관한 지침”React 18, Tailwind, Docker”Databricks와 무관, 20,000자 낭비
자주 반복하는 지침만 포함하세요. 일회성은 프롬프트에서 직접 지시하세요.

3. Workspace Instructions 설정

생성

관리자가 /Workspace/.assistant_workspace_instructions.md 생성 (일반 사용자는 읽기만 가능).

좋은 예시

## 코딩 표준
- Unity Catalog 3-level 네이밍 필수 (catalog.schema.table)
- try-except 에러 핸들링 필수, logging 모듈 사용 (print 금지)

## 네이밍 컨벤션
- Bronze: raw_{소스}_{엔티티}  Silver: clean_{도메인}_{엔티티}
- Gold: agg_{영역}_{메트릭}  임시: tmp_{작성자}_{목적}

## 데이터 접근 정책
- PII 테이블(hr.employees, crm.contacts): 마스킹 함수 필수
- 프로덕션(prod_catalog) DDL/DML 금지, 개발은 dev_catalog만

## SQL 스타일
- 대문자 키워드, 의미 있는 alias, CTE 우선, LIMIT 필수

## 보안
- 자격 증명 코드 포함 금지 → dbutils.secrets.get() 사용
- 외부 API 타임아웃 30초

역할 분리

구분User InstructionsWorkspace Instructions
코딩개인 선호 (들여쓰기, 주석 언어)조직 표준 (네이밍, 에러 처리)
라이브러리선호 (Plotly vs matplotlib)금지 (보안 취약)
데이터자주 쓰는 스키마PII 정책, 프로덕션 제한
보안개인 sandbox조직 전체 규칙