이 문서에서 하는 것
- 에이전트를 만들어 출력 형식/행동을 안정적으로 제어하고, 공유/포크로 교육 운영에 활용해.
agent 구성(권장)
- system prompt: 역할/규칙/출력 형식
- few-shot 예시(선택): 1~3개(짧고 형식 중심)
- 기본 옵션(선택): 스타일 프리셋/파라미터 기본값
비용/지연에 영향 주는 지점
- system prompt 길이
- few-shot 예시 길이
- 세션에서 RAG/도구를 함께 켜면 prompt가 더 커짐
자주 터지는 실수
- 규칙이 너무 많아 충돌(모델이 제멋대로 우선순위 해석)
- 금지/허용 기준이 모호함
- 내용 위주의 few-shot(비싸고 과적합)
왜 필요해?
- agent가 바뀌면 A/B 비교/실험 재현이 깨져.
최소 버전 정책(권장)
- updated_at + updated_by
- change_summary(무엇을 왜 바꿨는지 한 문단)
- (선택) 공유 시 스냅샷 고정(클래스 운영에 특히 좋음)
추천 워크플로
- 수정 → 새 버전/스냅샷 생성
- 질문 세트로 검증
- 공유 버전 승격
다음 문서
- /practice/evaluation
- /ops/monitoring-logs