최종 업데이트: 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자)
좋은 예시 (데이터 엔지니어)
나쁜 예시
| 문제 | 예시 | 이유 |
|---|---|---|
| 너무 모호 | ”좋은 코드 짜줘” | 구체적 행동 변화 유도 불가 |
| 상충 | ”간결하게” + “모든 에러 처리” + “상세 docstring” | 우선순위 미정 |
| 무관한 지침 | ”React 18, Tailwind, Docker” | Databricks와 무관, 20,000자 낭비 |
팁 자주 반복하는 지침만 포함하세요. 일회성은 프롬프트에서 직접 지시하세요.
3. Workspace Instructions 설정
생성
관리자가/Workspace/.assistant_workspace_instructions.md 생성 (일반 사용자는 읽기만 가능).
좋은 예시
역할 분리
| 구분 | User Instructions | Workspace Instructions |
|---|---|---|
| 코딩 | 개인 선호 (들여쓰기, 주석 언어) | 조직 표준 (네이밍, 에러 처리) |
| 라이브러리 | 선호 (Plotly vs matplotlib) | 금지 (보안 취약) |
| 데이터 | 자주 쓰는 스키마 | PII 정책, 프로덕션 제한 |
| 보안 | 개인 sandbox | 조직 전체 규칙 |