프롬프트 계약: 프롬프트를 API처럼 다루기 (Inputs, Outputs, Errors)

Source: Dev.to

소개

프롬프트는 인간과 LLM 사이의 접착제 역할을 합니다 — 하지만 대부분의 프롬프트는 개발자 수준의 인터페이스가 아니라 깨지기 쉬운 메모에 가깝습니다. 프롬프트를 API처럼 다루면(명확한 입력, 출력, 오류 경우를 정의) 결과가 예측 가능하고, 테스트 가능하며, 재현 가능합니다. 이 글에서는 오늘 바로 어떤 프롬프트에도 적용할 수 있는 간결하고 실용적인 계약을 소개합니다.

프롬프트 계약이 중요한 이유

• 모호성 감소: 명시적인 입력과 제약조건.
• 프롬프트 테스트 가능: 기대 출력과 빠른 검증을 정의.
• 드리프트 감소: 계약은 의도치 않은 프롬프트 부패를 방지합니다.

계약 (1 페이지)

목적

프롬프트가 달성해야 할 의도를 한 문장으로 기술합니다.

입력

각 필드와 타입을 나열하고 예시를 제공합니다.

출력 스키마

모델이 반환해야 할 형태를 설명합니다(예: JSON 또는 글머리표 리스트).

제약조건

길이, 스타일, 금지된 내용 등을 명시합니다.

오류 경우 및 대체 처리

알 수 없는 입력이나 부분 출력이 발생했을 때의 처리 방안을 정의합니다.

빠른 테스트

예시 입력 1–3개와 기대 출력을 제공합니다.

구체적인 예시

목적

PR 설명을 한 문단의 changelog 항목으로 요약합니다.

입력

출력 스키마 (JSON)

{
  "summary": "string (≤ 200 characters, present tense)",
  "details": "string (optional)",
  "impact": "string"
}

제약조건

• 요약은 200자 이하.
• 현재 시제를 사용.
• 욕설이나 금지된 콘텐츠는 포함하지 않음.

프롬프트 (구현)

You are a changelog writer. Given the following fields in JSON, produce JSON matching the output schema and obey constraints. If a field is missing, set it to an empty string.

{input}

빠른 테스트

입력

{
  "title": "Fix signup bug",
  "changes": "validate email earlier",
  "impact": "reduces errors"
}

예상 출력

{
  "summary": "Fix signup bug: validate email earlier, reducing errors.",
  "details": "",
  "impact": "reduces errors"
}

마무리

프롬프트를 계약으로 다루면 AI 작업을 소프트웨어를 신뢰할 수 있게 만드는 동일한 엔지니어링 습관에 맞출 수 있습니다. 작게 시작해 보세요: 워크플로우에서 자주 사용하는 프롬프트 하나를 골라 오늘 바로 계약 형태로 변환해 보세요.