앱이 Claude의 답변을 사용자에게 바로 전달하면, 그 누구도 먼저 확인하지 않습니다. Claude가 작성한 그대로가 사용자가 받는 내용이 됩니다. 따라서 Claude는 답변이 어디로 전달되는지, 어떤 모습이어야 하는지, 무엇을 빼야 하는지 알아야 합니다.
프롬프트를 명확하고 직접적으로 만들려면, Claude에게 이 세 가지를 알려 주세요: 맥락, 원하는 출력 형식, 제약 조건입니다. 각각은 새로 온 동료가 작업을 시작하기 전에 여러분에게 물어볼 질문에 답하는 역할을 합니다.
Claude가 추측하게 만드는 프롬프트
치과 예약 앱이 방문 하루 전에 각 환자에게 알림 문자를 보낸다고 가정해 보겠습니다. 이 앱은 Claude에게 한 줄짜리 작업과 네 줄의 데이터를 보낸 다음, 돌아온 답변을 그대로 환자에게 문자로 보냅니다. 다음은 한 환자를 위한 프롬프트입니다:
이 예약에 대한 알림을 작성하세요.
환자: Dana Okafor
날짜: 3월 12일 목요일
시간: 오후 2:30
치료: 근관치료, 두 번째 방문
Claude는 다음과 같은 답변을 보냈습니다. 앱이 보내게 될 모든 문자를 볼 수 있도록 원시 텍스트로 표시되어 있습니다:
**예약 알림**
안녕하세요 Dana님,
다가오는 치과 예약에 대한 친절한 알림입니다:
**날짜:** 3월 12일 목요일
**시간:** 오후 2:30
**치료:** 근관치료(두 번째 방문)
**방문 전 안내:**
- 약 10분 일찍 도착해 주세요.
- 시술 후 몇 시간 동안 입이 마비될 수 있으니, 사전에 가벼운 식사를 해 주세요.
- 치과의사가 달리 안내하지 않는 한, 처방된 약은 계속 복용해 주세요.
- 지난 방문 이후 통증, 부기, 또는 임시 충전재에 문제가 있었다면 알려주세요.
일정 변경이 필요하거나 질문이 있으시면, 최소 24시간 전에 [전화번호]로 전화해 주세요.
뵙기를 기대하겠습니다!
[병원 이름]
앱은 이 모든 내용을 Dana에게 문자로 보내게 되는데, 그중 상당수는 그녀의 휴대폰에 어울리지 않습니다:
- 별표와 하이픈은 굵은 텍스트와 목록을 나타내는 Markdown 문법입니다. 휴대폰에서는 이를 일반 문자로 표시합니다.
- 식사와 일찍 도착하는 것에 대한 조언은 방문에 관한 조언이며, 이런 조언은 치과의사로부터 나와야 합니다.
- "근관치료(두 번째 방문)"은 Dana의 잠긴 휴대폰 화면에 표시될 수 있으며, 다른 사람들도 그것을 볼 수 있습니다.
- "[전화번호]"와 "[병원 이름]"은 빈칸이며, 문자가 발송되기 전에 아무도 그 빈칸을 채우지 않습니다.
이러한 결함은 모두 프롬프트가 빠뜨린 내용으로 거슬러 올라갑니다. 프롬프트는 이 알림이 문자 메시지라는 것도, 아무도 먼저 확인하지 않는다는 것도, 다른 사람이 잠긴 휴대폰에서 이를 볼 수 있다는 것도 전혀 언급하지 않습니다. 알림이 무엇을 다뤄야 하는지도 말하지 않았고, 병원 이름이나 전화번호도 제공하지 않았습니다. 그래서 Claude는 일반적인 알림을 작성하고, 사실 정보가 없는 곳은 빈칸으로 남겨두었습니다.
여러분이 돌려받는 결과는 대부분 여러분이 입력한 내용에 달려 있습니다. 프롬프트의 문구를 다시 다듬기 전에, Claude에게 빠진 사실 정보를 먼저 제공하세요.
동료라면 무엇을 물어볼지 생각해 보세요
빠진 부분을 찾으려면, 이 앱을 한 번도 본 적 없는 동료에게 프롬프트를 건네는 상황을 상상해 보세요. 그 동료는 오직 프롬프트만 보고 알림을 작성해야 합니다. 동료가 헷갈린다면, Claude도 마찬가지일 것입니다.
한 단어도 쓰기 전에, 동료는 여러분에게 물어볼 질문들이 있을 것입니다. 각 질문은 프롬프트에 추가할 수 있는 세 가지 요소 중 하나를 가리킵니다:
| 요소 | Claude에게 알려주는 내용 | 동료가 묻는 질문 |
|---|---|---|
| 맥락 | 답변의 용도, 전달 경로, 읽는 사람이 누구인지 | "이게 문자인가요, 이메일인가요? 누구 명의로 보내나요? 발송 전에 누군가 확인하나요?" |
| 출력 형식 | 답변의 형태, 예를 들어 길이와 Markdown 사용 가능 여부 | "길이는 어느 정도여야 하나요? 굵은 텍스트나 목록을 쓸 수 있나요?" |
| 제약 조건 | 답변이 반드시 지켜야 하거나 빼야 하는 내용 | "치료명을 언급해야 하나요? 조언을 해야 하나요?" |
동료의 질문 각각에 프롬프트에서 해당하는 부분에 답하세요.
맥락, 형식, 제약 조건 추가하기
맥락은 사실로 기술하고, 출력 형식과 제약 조건은 지시문으로 작성하세요. Claude가 목적을 짐작할 수 없는 지시문에는 그 이유를 덧붙이세요.
아래에 완성된 예약 앱의 프롬프트는 동료의 질문에 세 개의 문단으로 답합니다. 각각 맥락, 출력 형식, 제약 조건을 다룹니다.
각 요소를 넣거나 뺀 상태로 프롬프트를 시도해 보세요. 모든 답변은 해당 프롬프트에 대해 Claude가 실제로 생성한 것을 기록한 결과입니다.
새로운 프롬프트로 직접 해보기
이제 직접 프롬프트를 명확하고 직접적으로 만들어 보세요. 날씨 앱이 Claude의 답변을 그대로, 아침 7시에 사람들이 잠금화면에서 읽는 푸시 알림으로 전송한다고 가정해 보겠습니다. 이 앱의 프롬프트는 Claude에게 한 줄짜리 작업과 몇 가지 데이터만 제공합니다:
이 예보에 대한 알림을 작성하세요.
도시: Portland
아침: 흐림, 48°F
오후: 오후 3시부터 폭우
바람: 순간풍속 35mph
이 앱을 한 번도 본 적 없는 동료라면 무엇을 물어볼지 생각해 보세요. 그런 다음 그 질문들에 답하는 맥락, 출력 형식, 제약 조건을 골라 보세요. 선택할 때마다 그것이 맞는 이유나 틀린 이유를 읽어 보세요.
날씨 앱의 프롬프트는 "이 예보에 대한 알림을 작성하세요."라고만 되어 있습니다. Claude에게 맥락을 제공하려면 어떤 줄을 추가하시겠습니까?
알림은 잠금화면에 맞아야 합니다. 출력 형식으로 어떤 줄을 추가하시겠습니까?
같은 프롬프트가 매일 아침 새로운 예보와 함께 실행됩니다. 제약 조건으로 어떤 줄을 추가하시겠습니까?
다음 단계
앱이 사용하기 전에 답변을 고쳐야 할 때마다, 프롬프트가 답하지 않은 질문을 찾아보세요. 여러분의 코드에서 프롬프트를 고치려면, 단계별로 진행하세요:
- 여러분의 앱을 한 번도 본 적 없는 동료를 상상하고, 그들이 작업을 하기 전에 무엇을 물어볼지 생각해 보세요.
- 프롬프트에서 각 질문에 맥락, 출력 형식, 또는 제약 조건으로 답하세요. 맥락은 사실로 기술하고, Claude가 목적을 짐작할 수 없는 지시문에는 그 이유를 덧붙이세요.
- 새 프롬프트를 여러분의 앱에서 나온 여러 입력값과 함께 전송하세요.
- 각 답변을 원시 텍스트로 읽어서, 여러분의 앱이 보내게 될 모든 문자를 확인하세요. 여러분이 고치려던 결함, 예를 들어 앱이 표시할 수 없는 Markdown, 아무도 채우지 않는 빈칸, 또는 사용자가 보면 안 되는 세부 정보가 있는지 찾아보세요.
결함이 여전히 남아 있다면, 프롬프트가 아직 열어둔 질문을 찾아서 그것도 답하세요.
몇 개의 답변만 읽어서는 프롬프트가 여러분 앱의 모든 입력값에 대해 얼마나 잘 작동하는지 알 수 없습니다. 이를 알려면 평가(eval), 즉 여러분만의 사례에 대한 테스트를 통해 판단에 사용할 수 있는 수치를 얻어야 합니다. 여기서부터는 Introduction to evals 코스를 수강해 보세요.