사용자 가이드
프롬프트 만들기
좋은 프롬프트는 명확한 지시 + 적절한 컨텍스트 + 출력 포맷의 조합입니다. PromStack의 도구로 이를 어떻게 운영하는지 안내합니다.
8분 분량2026-04-30 업데이트
시스템 vs 사용자 프롬프트
PromStack은 두 가지 프롬프트 슬롯을 분리해 관리합니다.
- 시스템 프롬프트 — 모델의 역할/규칙/스타일을 정의하는 “고정된 본문”. 실행할 때마다 같은 내용이 들어갑니다.
- 사용자 프롬프트 템플릿 — 매 실행마다 변수만 바뀌는 입력 패턴. 예: 이메일, 코드 스니펫, 사용자 요청.
변수 만들기
시스템 또는 사용자 프롬프트에 {{name}} 형태로 변수를 작성하면, 미리보기와 실행 시점에 자동으로 입력 폼이 만들어집니다.
변수 예시
---시스템---
당신은 데이터 분석가입니다. 다음 표를 한국어로 요약하세요.
---사용자 템플릿---
표:
{{table}}
요약 길이: {{summary_length}}
포커스: {{focus}}변수 이름은 영문 소문자 + 언더스코어를 권장합니다. 같은 이름이 여러 번 나와도 한 번만 입력 받습니다.
섹션과 멀티 메시지
상세 페이지에서 Multi-role 섹션을 사용하면 System / User / Assistant 메시지를 여러 턴으로 구성할 수 있습니다. Few-shot 예시를 이 방식으로 모델에 미리 보여주세요.
버전 관리
저장할 때마다 자동으로 버전이 기록됩니다. 상세 페이지 하단 버전 히스토리 섹션에서 이전 버전을 확인하고, 필요하면 한 번에 복원할 수 있어요. 실행 안정성이 중요한 프로덕션에서는 SDK에서 특정 버전을 명시적으로 가져오는 것을 권장합니다.
버전 명시 호출
import { PromptManagerClient } from '@promstack/sdk';
const client = new PromptManagerClient({ apiKey: process.env.PROMSTACK_KEY! });
const prompt = await client.getPromptVersion(1234, 7); // v7 고정설명, 노트, 카테고리
상세 정보 입력 패널에서 다음 필드를 채워두면 발견성이 크게 향상됩니다.
- 설명(description) — 한 줄 요약. 리스트 카드와 검색 결과에 노출됩니다.
- 노트(notes) — 사용 시 주의 사항, 변수 의미, 예상 응답 등. 상세 페이지 상단에 인용 박스로 노출됩니다.
- 카테고리/태그 — 카테고리는 한 개, 태그는 쉼표로 다수. 필터바에서 조합으로 검색할 수 있어요.
컨텍스트 소스 연결
GitHub 레포 또는 외부 문서 URL을 연결해두면 카드와 상세 헤더에 출처 배지가 자동으로 노출됩니다. 팀이 “어디에서 온 프롬프트인지”를 빠르게 알 수 있어 권한·라이선스 추적에 유용해요.