AI 에이전트가 말을 안 들으면? 5단식 지시문으로 바꿔보세요 [Muse 사용기 7편]

이 글 3줄 요약
1. 역할·배경·할 일·결과 형태·금지선 순으로 쓰면 에이전트가 명령을 놓치지 않아요.
2. 실제 테스트에서 이렇게 바꾼 뒤 성공률이 13/16 → 22/22 로 뛰었어요.
3. 한 줄 지시만으로는 에이전트가 자꾸 되묻거나 심지어 법적 운운까지 하는 사고가 생겨요.

안녕하세요, 여러분! 요즘 AI 에이전트를 써 보셨다면 “이렇게만 말해도 될 텐데” 하고 답답해 하신 적 많으실 거예요. 오늘은 정확히 무엇을 어떻게 말해야 에이전트가 정확히 움직이는지, 검증된 두 가지 실제 측정 사례를 바탕으로 알려 드릴 거예요.

Photo: Generationbass.com (CC BY 2.0)

역할 (Role) – 누가 일할지를 분명히 말해 주세요

에이전트는 먼저 “누가” 이 일을 해야 하는지 알아야 해요. 역할을 명확히 하면 불필요한 질문을 줄일 수 있어요.

• 한 줄 지시: “비행기 예약해줘”

→ 에이전트가 “어떤 항공사?”, “어떤 좌석 등급?” 등을 자꾸 물어요.

• 5단식 지시:

  역할: 여행 계획 담당자  
  배경: 다음 주 출장을 위해 서울‑도쿄 왕복 항공권이 필요해요  
  할 일: 최저가 직항 항공권을 찾아 줘  
  결과 형태: 항공편 번호, 출발·도착 시각, 가격 목록  
  금지선: 스탑오버가 있는 경로는 제외해 줘

→ 에이전트는 역할을 보고 바로 “여행 계획 담당자” 모드로 들어가서 불필요한 확인이 없어요.

배경 (Context) – 상황 정보를 미리 알려 주세요

배경을 주면 에이전트가 왜 이 일을 해야 하는지 이해하고 적절한 우선순위를 정해요.

• 한 줄 지시: “이메일 정리해줘”

→ 에이전트가 “어떤 폴더로 이동시킬까?”, “읽은 메일은 지울까?” 등을 물어봐요.

• 5단식 지시:

  역할: 사무실 어시스턴트  
  배경: 오늘 아침에 들어온 50통의 프로모션 메일이 받은함에 쌓여 있어요  
  할 일: 프로모션 메일을 모두 ‘광고’ 라벨로 옮겨 주고, 읽은 메일은 보관해요  
  결과 형태: 라벨이 바뀐 메일 수와 남은 받은함 개수  
  금지선: 작업 중 중요한 메일은 건드리지 마세요

→ 배경을 보니 에이전트가 바로 “프로모션 메일”만 골라 처리해요.

할 일 (Task) – 구체적인 행동을 하나만 적어 주세요

에이전트는 하나의 명확한 행동을 받아야 해요. 두 가지 이상을 섞으면 혼동이 생겨요.

• 한 줄 지시: “가격 추적해줘”

→ 에이전트가 “어떤 상품?”, “얼마나 자주 체크?” 등을 되묻어요.

• 5단식 지시:

  역할: 쇼핑 도우미  
 배경: 내가 관심 있는 노트북 모델의 가격 변동을 일주일 동안 지켜보고 싶어요  
  할 일: 해당 노트북의 현재 가격을 6시간마다 체크해서 기록해 줘  
  결과 형태: 시간별 가격 표와 변동 그래프  
  금지선: 다른 상품의 가격은 절대 포함하지 마세요

→ 할 일 하나가 명시돼 있으니 에이전트가 바로 작업을 시작해요.

결과 형태 (Format) – 어떤 모양으로 줄지 정해 주세요

에이전트는 결과를 어떻게 보여줘야 하는지 몰라서 텍스트만 줄 수도 있고, 표나 JSON을 원할 수도 있어요. 형식을 먼저 적으면 원하는 형태로 바로 받아요.

• 조건을 맨 앞에 규칙:

형식이나 조건은 가능한 한 앞쪽에 배치해요. 뒤쪽에 숨겨 놓으면 에이전트가 놓치기 쉬워요 (실제 측정에서는 조건이 문단 중간에 묻혀 있으면 통과율이 떨어졌어요).

• 예시 (항공권 예약)

  역할: 여행 계획 담당자  
  배경: 다음 주 출장을 위해 서울‑도쿄 왕복 항공권이 필요해요  
  할 일: 최저가 직항 항공권을 찾아 줘  
  결과 형태: JSON [{ "flight":"XX123","dep":"08:00","arr":"10:30","price":"120000" }, …]  
  금지선: 스탑오버가 있는 경로는 제외해 줘

→ 에이전트가 JSON 형태로 바로 줘서 복사‑붙여넣기만 하면 돼요.

Photo: JD Hancock (CC BY 2.0)

금지선 (Constraints) – 안전벨트 같은 한 줄

금지선은 에이전트가 절대로 넘어서는 안 되는 경계를 정해요. 이것을 “에이전트 시대의 안전벨트”라고 부를 수 있어요. 한 줄만 있어도 큰 사고를 막아요.

• 실제 예시 (이메일 정리)

  금지선: 개인 정보가 들어있는 메일은 절대 삭제하거나 이동시키지 마세요

→ 이 한 줄이 있었기에 에이전트가 실수로 중요한 계약서를 지우는 일을 막았어요.

• 항공권 예약에서의 금지선

  금지선: 출발 시각이 새벽 0시 이전인 항공은 절대 추천하지 마세요

→ 새벽 비행은 피하고 싶다는 사용자의 의지를 정확히 지켜줘요.

표: 한 줄 지시 vs 5단식 비교

항목	한 줄 지시	5단식 지시문
역할	미지정	역할: 여행 계획 담당자
배경	미지정	배경: 다음 주 출장을 위해 서울‑도쿄 왕복 항공권이 필요해요
할 일	모호함 (예: “가격 추적”)	할 일: 최저가 직항 항공권을 찾아 줘
결과 형태	지정 안 함	결과 형태: JSON 목록
금지선	없음	금지선: 스탑오버가 있는 경로는 제외해 줘
에이전트 반응	자주 되묻고, 가끔 실수	바로 실행, 성공률 ↑

---

복붙용 프롬프트 박스

아래 템플릿을 그대로 복사해서 쓰세요. 각 항목에 자신의 상황을 채워 넣으면 끝이에요.

역할: [누가 이 일을 해야 하는지]
배경: [현재 상황과 왜 이 일이 필요한지]
할 일: [구체적으로 수행해야 할 행동 하나]
결과 형태: [원하는 출력 형식 – 예: 텍스트 목록, JSON, 표]
금지선: [절대 해서는 안 되는 것 하나]

---

✅ 좋았던 점

• 에이전트가 질문을 줄여서 작업 속도가 빨라졌어요.
• 명확한 형식과 금지선 때문에 원하지 않는 결과를 거의 얻지 못했어요.
• 한 줄만 바꾸어도 성공률이 13/16 → 22/22 로 확 뛰었어요 (실제 측정).

❌ 아쉬운 점

• 처음에는 모든 항목을 채우는 데 시간이 조금 걸려요 (하지만 몇 번 쓰면 금방 익숙해져요).
• 일부 에이전트는 복잡한 JSON을 만들 때 약간의 수정이 필요할 수 있어요.
• 금지를 너무 많이 걸면 에이전트가 할 수 있는 일이 줄어들 수 있으니, 정말 필요한 것만 넣는 게 좋아요.

---

이런 분께 추천

이런 분께 추천
- AI 에이전트를 자주 쓰지만 답답함을 느끼는 분
- 업무 자동화를 처음 시작하는 분 (비행기 예약, 이메일 정리, 가격 추적 등)
- 에이전트가 실수로 중요한 정보를 바꾸거나 삭제하는 사고를 방지하고 싶은 분

---

Photo: Kristin Hardwick (CC0 1.0)

❓ FAQ

Q1. Muse는 한국에서도 쓸 수 있나요?

A1. 현재 Muse는 미국과 캐나다 지역에서만 제공돼요. 하지만 여기서 배운 5단식 작성법은 어떤 AI 에이전트에 그대로 적용할 수 있어요.

Q2. 금지를 여러 개 넣어도 되나요?

A2. 가능하지만, 너무 많으면 에이전트가 할 수 있는 일을 지나치게 제한할 수 있어요. 가장 중요한 하나 혹은 두 개만 넣는 게 좋아요.

Q3. 결과 형태를 정하지 않으면 어떻게 되나요?

A3. 에이전트는 보통 평문 텍스트로 돌려줘요. 이때 원하는 표나 JSON이 아니라면 다시 작업을 요청해야 해요.

Q4. 역할과 배경을 바꿔도 되나요?

A4. 네, 순서는 역할 → 배경 → 할 일 → 결과 형태 → 금지선으로 지켜야 하지만, 각 항목 안에 들어가는 내용은 자유롭게 바꾸면 돼요.

Q5. 한 줄 지시로도 충분히 좋은 결과가 나올 때가 있나요?

A5. 아주 단순하고 명확한 작업 (예: “현재 시간 알려줘”)에서는 한 줄 지시도 괜찮아요. 하지만 조건이나 형식이 중요할 때는 5단식이 더 안전해요.

---

이게 의미하는 것

이렇게 역할·배경·할 일·결과 형태·금지선 순으로 명령을 짜면, 에이전트는 “뭘 해야 하는지”와 “어떻게 보여줘야 하는지”를 한눈에 파악해요. “절대 해서는 안 되는 것”까지 분명해지니 불필요한 질문이 사라지고 원하는 결과를 바로 얻게 돼요. 실제 측정에서 보인 성공률 상승은 바로 이와 같은 구조가 에이전트의 오해를 줄여 줬기 때문이에요. Muse가 아직 한국에서는 쓰지 못한다고 해도, 이 작성법은 어떤 AI 에이전트라도 더 잘 따르게 만들어 줄 거예요.

---

댓글 질문:

당신이 가장 자주 쓰는 AI 에이전트에 적용해 볼 5단식 지시문은 무엇인가요? 구체적인 역할을 알려 주시면 함께 템플릿을 만들어 볼게요!

다음 편 예고:

다음에는 “에이전트가 만든 결과를 바로 엑셀로 끌어오는 자동화 팁”을 보여 드릴게요. 기대해 주세요!

---

출처

• https://dev.to/rong_zhou_82b76559d22eaa3/regression-testing-a-skill-on-a-real-ai-assistant-from-155-seconds-a-case-to-10-minutes-a-run-39j5
• https://github.com/cwybruce/awesome-muse-use-cases