프롬프트 엔지니어링

이 글의 목차
  1. 첫 실습은 짧은 요청 하나로
  2. 왜 같은 질문에도 결과가 달라질까
  3. 좋은 프롬프트의 6요소
  4. 바로 쓰는 기본 템플릿
  5. 예시가 규칙보다 강할 때: Few-shot
  6. 큰 작업은 한 번에 시키지 말고 중간 산출물을 둔다
  7. 역할 부여는 만능 주문이 아니다
  8. 자주 실패하는 프롬프트
  9. 실습: 같은 메모를 세 번 다르게 요청하기
  10. 프롬프트 개선 순서
  11. 실전 체크리스트
  12. 정리
  13. 참고

첫 실습은 짧은 요청 하나로

‘이 글을 요약해 줘’라는 요청에 독자와 길이만 추가해 보자. 예를 들어 ‘개발을 처음 배우는 사람이 읽도록 세 문장으로 요약해 줘’라고 바꾸고 결과 차이를 비교한다.

이 글의 템플릿은 채워야 할 양식의 예다. 모든 칸을 길게 작성해야 하는 것은 아니다. 결과가 어긋날 때 빠진 기준을 한 항목씩 추가하고, 같은 입력에서 개선됐는지 확인하자.

프롬프트는 AI에게 보내는 입력 전체다. 단순한 질문 한 줄일 수도 있고, 역할·자료·제약·출력 형식·예시를 포함한 긴 작업 명세일 수도 있다.

프롬프트 엔지니어링은 멋있는 주문을 외우는 일이 아니다. 원하는 결과와 합격 기준을 AI가 오해하지 않도록 작업 계약을 명확하게 쓰고, 실제 결과를 보며 개선하는 과정이다.

왜 같은 질문에도 결과가 달라질까

LLM은 정답 데이터베이스에서 문장을 그대로 꺼내는 시스템이 아니다. 주어진 입력과 대화 문맥을 바탕으로 다음 토큰을 생성한다. 따라서 다음 요소가 바뀌면 결과도 바뀔 수 있다.

  • 사용하는 모델과 모델 버전
  • 이전 대화 내용
  • 제공한 자료의 양과 순서
  • 요청의 구체성
  • 예시와 출력 형식
  • 생성 시점의 확률적 선택

그래서 좋은 프롬프트는 “한 번 완벽하게 쓰는 문장”보다 테스트 가능한 명세에 가깝다.

좋은 프롬프트의 6요소

모든 요청에 여섯 요소를 길게 쓸 필요는 없다. 결과가 자꾸 빗나갈 때 빠진 항목을 하나씩 채우면 된다.

1. 목표: 무엇을 끝내야 하는가

나쁜 예:

이 글 고쳐 줘.

좋은 예:

아래 기술 블로그 초안을 Swift 입문자가 이해할 수 있게 퇴고해 줘.
기술적 의미는 유지하고, 중복 문장은 줄여 줘.

“고쳐 줘”보다 독자와 작업 목적을 알려 주면 AI가 판단할 기준이 생긴다.

2. 배경: 왜 이 일을 하는가

이 글은 팀 내부 문서가 아니라 공개 블로그에 게시한다.
독자는 Swift 문법을 배웠지만 동시성은 처음 접한다.

같은 내용이라도 공개 글, 회의 보고서, 고객 답변은 적절한 용어와 설명 깊이가 다르다.

3. 입력: 무엇을 근거로 써야 하는가

아래 초안만을 편집 대상으로 사용해.
기술 사실은 첨부한 Apple 공식 문서를 우선 근거로 삼아.
근거가 없는 내용은 추측하지 말고 확인 필요로 표시해.

AI에게 자료를 주지 않고 최신 사실이나 사내 정책을 정확히 맞히라고 요구하면 환각 가능성이 커진다.

4. 제약: 무엇을 하면 안 되는가

- 코드 예제의 함수명은 바꾸지 않는다.
- 본문은 2,000자 안팎으로 쓴다.
- 과장된 홍보 표현은 쓰지 않는다.
- 확인되지 않은 성능 수치를 만들지 않는다.

제약은 많을수록 좋은 것이 아니다. 결과를 실제로 탈락시킬 조건만 적는다. 서로 충돌하는 제약이 있으면 우선순위도 알려 준다.

5. 출력 형식: 결과를 어떤 모양으로 받을까

다음 순서로 Markdown을 작성해.
1. 제목 후보 3개
2. 한 문단 요약
3. 퇴고한 본문
4. 사실 확인이 필요한 항목

프로그램이 결과를 읽어야 한다면 자유 형식 텍스트보다 JSON Schema 같은 구조화된 출력을 사용한다. 사람이 읽을 문서라면 제목, 표, 목록의 구조를 지정하는 것만으로 충분할 수 있다.

6. 합격 기준: 무엇이면 잘된 결과인가

완료 전에 다음을 확인해.
- sync/async와 serial/concurrent를 같은 개념처럼 설명하지 않았는가
- 모든 Swift 코드 블록의 괄호가 맞는가
- 처음 등장하는 전문 용어를 한 문장으로 풀었는가

“잘 써 줘”는 평가할 수 없지만, 확인 항목은 결과를 검토할 수 있다.

바로 쓰는 기본 템플릿

# 목표
[최종적으로 완성할 일]

# 배경과 독자
[사용 목적, 읽는 사람, 현재 상황]

# 입력 자료
[참고할 본문, 파일, URL, 데이터]

# 요구 사항
- [반드시 포함할 것]
- [지켜야 할 제약]
- [하지 말아야 할 것]

# 출력 형식
[Markdown/표/JSON/코드 등 구체적인 결과 형태]

# 완료 기준
- [사실 정확성 기준]
- [형식 기준]
- [검증 방법]

정보가 부족하면 임의로 결정하지 말고 먼저 부족한 항목을 알려 줘.

간단한 질문에는 이 템플릿을 전부 채우지 않아도 된다. 비용이 큰 작업, 여러 사람이 재사용할 작업, 자동화할 작업일수록 명세를 두껍게 만든다.

예시가 규칙보다 강할 때: Few-shot

원하는 문체나 분류 기준을 말로만 설명하기 어렵다면 입력과 정답 예시를 2~5개 제공한다.

고객 문의를 billing, bug, feature 중 하나로 분류해.

예시:
- 입력: "결제가 두 번 됐어요" → billing
- 입력: "저장 버튼을 눌러도 반응이 없어요" → bug
- 입력: "다크 모드를 추가해 주세요" → feature

실제 입력: "지난달 영수증을 받고 싶어요"

예시는 다양한 경계 사례를 보여 줘야 한다. 쉬운 사례만 주면 실제 애매한 입력에서 기준이 무너진다. 또한 예시의 형식 오류도 그대로 학습될 수 있으므로 정답 품질을 먼저 확인한다.

큰 작업은 한 번에 시키지 말고 중간 산출물을 둔다

“조사해서 20쪽 보고서를 완성해”라고 한 번에 요청하면 잘못된 방향으로 긴 결과를 만들 수 있다. 다음처럼 단계를 나눈다.

1단계: 독자와 목적을 기준으로 목차를 제안한다.
2단계: 각 장에 필요한 근거와 확인 질문을 정리한다.
3단계: 내가 목차를 승인하면 초안을 쓴다.
4단계: 완성 기준으로 자체 점검표를 작성한다.

단계 분리는 품질을 높이지만 호출 횟수와 시간이 늘어난다. 짧고 되돌리기 쉬운 일에는 한 번의 요청이 더 효율적이다.

역할 부여는 만능 주문이 아니다

너는 세계 최고의 개발자야.

이런 역할만으로는 정확한 결과가 보장되지 않는다. 역할은 필요한 관점과 책임을 구체화할 때 의미가 있다.

너는 iOS 코드 리뷰어다.
이번 리뷰에서는 기능 추가를 하지 말고 데이터 경쟁, MainActor 위반,
취소 누락만 찾아 파일과 줄을 근거로 보고한다.

“누구인가”보다 “무엇을 보고, 무엇을 하지 않으며, 무엇을 출력하는가”가 중요하다.

자주 실패하는 프롬프트

목표가 여러 개인데 우선순위가 없다

“짧고, 아주 자세하고, 초보자용이면서 전문가 수준으로”처럼 충돌하는 조건을 동시에 주면 어느 쪽을 택해야 할지 모호하다.

정확성을 최우선으로 하고, 그다음이 초보자 이해도다.
길이는 필요하면 2,500자까지 허용한다.

사실과 창작을 구분하지 않는다

아이디어 발산에는 자유가 도움이 되지만 기술 문서에는 출처와 불확실성 표시가 필요하다. 작업마다 허용되는 추측 수준을 정한다.

“생각을 길게 보여 달라”고 요구한다

최신 추론 모델은 내부적으로 추론한다. 장황한 사고 과정을 요구하기보다 결과에 필요한 근거, 계산, 가정, 검증 결과를 요청하는 편이 낫다.

결론과 함께 사용한 가정, 확인한 근거, 남은 불확실성을 짧게 제시해.

실패 사례 없이 감으로 수정한다

프롬프트를 바꾼 뒤 좋아진 예시 하나만 보면 다른 입력에서 나빠진 사실을 놓친다. 대표 입력과 예상 결과를 저장해 회귀 테스트해야 한다.

실습: 같은 메모를 세 번 다르게 요청하기

다음 메모를 공통 입력으로 쓴다.

금요일 오후 3시에 iOS 팀 회의가 있다.
장소는 2층 회의실이다.
회의 전에 Core Data 마이그레이션 테스트 결과를 준비해야 한다.

먼저 “정리해 줘”라고 요청한다. 그다음 “초보자가 해야 할 일을 목록으로 정리해 줘”라고 바꾼다. 마지막에는 다음처럼 날짜·장소·준비물을 구분해 달라고 요청한다.

아래 메모에서 일정과 준비물을 추출해 줘.

출력:
- 일정:
- 시간:
- 장소:
- 준비할 일:
- 확인이 필요한 정보:

원문에 없는 날짜나 담당자는 만들지 마.
[여기에 메모 붙여 넣기]

세 응답을 비교할 때 문장이 예쁜지만 보지 않는다. 준비물이 빠졌는지, 금요일의 정확한 날짜를 임의로 채웠는지, 원문에 없는 담당자를 만들었는지 확인한다.

이 실습에서는 금요일이 어느 날짜인지는 확정할 수 없다. “확인 필요”로 남기는 답이 더 정확할 수 있다. 프롬프트를 자세히 쓴다는 것은 AI가 모든 빈칸을 채우게 하는 일이 아니라, 무엇을 확정할 수 있는지 분명히 하는 일이다.

한 번에 한 조건만 바꾸기

먼저 출력 형식만 바꾸고 비교한다. 그다음 독자 수준, 마지막에 금지 조건을 추가한다. 모든 조건을 한꺼번에 바꾸면 어떤 지시가 효과가 있었는지 알기 어렵다.

결과가 계속 틀리면 지시 부족인지 입력 자료 부족인지 나눠 본다. 날짜가 없는 원문에서 정확한 날짜를 얻으려면 더 강한 문장이 아니라 기준 날짜 정보가 필요하다.

프롬프트 개선 순서

  1. 실제로 실패한 입력과 출력을 저장한다.
  2. 실패 원인을 목표, 정보, 제약, 형식, 모델 능력 중 어디에 있는지 나눈다.
  3. 가장 작은 수정 하나만 적용한다.
  4. 정상 사례와 경계 사례를 함께 다시 실행한다.
  5. 품질, 비용, 지연 시간을 비교한다.
  6. 좋아졌다면 프롬프트와 테스트를 같은 버전으로 보관한다.

프롬프트가 길어진다고 무조건 좋아지지 않는다. 중복 규칙은 비용을 높이고 중요한 지시를 묻히게 한다. 반복해서 실패를 막아 주지 못하는 문장은 제거한다.

실전 체크리스트

  • 최종 목표가 한 문장으로 분명한가?
  • 독자와 사용 목적이 있는가?
  • 최신 정보나 사내 정보에 필요한 자료를 제공했는가?
  • 반드시 지킬 조건과 금지 조건이 충돌하지 않는가?
  • 출력 형식을 바로 사용할 수 있을 만큼 구체화했는가?
  • 좋은 결과를 판정할 기준이 있는가?
  • 최소 하나의 경계 사례로 테스트했는가?
  • 프롬프트 변경 전후를 같은 입력으로 비교했는가?

정리

프롬프트 엔지니어링의 핵심은 화려한 표현이 아니라 목표, 근거, 제약, 출력, 합격 기준을 명확히 하는 것이다. 하지만 아무리 좋은 요청도 필요한 자료가 대화 밖에 있거나 문맥이 너무 길어지면 한계가 생긴다. 다음 편에서는 AI가 판단에 사용할 정보를 선택하고 유지하는 컨텍스트 엔지니어링을 다룬다.

→ 컨텍스트 엔지니어링: 필요한 정보를 필요한 순간에 주기

참고