실습 — 역할 지시문 쓰기

에이전트의 성능은 대부분 지시문에서 결정됩니다. Prompt Lab 에서 직접 비교해 보세요.

나쁜 지시문과 좋은 지시문

나쁜 예

당신은 설비 진단 전문가입니다. 문제를 진단하세요.

좋은 예

당신은 회전 설비 진동 진단 담당입니다.

할 일:
1. 제공된 진동 데이터에서 이상 여부를 판단한다
2. 이상이면 가능한 원인을 2~3개 제시하고 각각의 확신도를 밝힌다
3. 확인이 필요한 추가 데이터를 지목한다

지켜야 할 것:
- 데이터에 없는 내용을 추측하지 않는다. 모르면 "판단 불가"라고 답한다
- 베어링 결함 주파수 계산이 필요하면 calc_bearing_freq 도구를 쓴다
- 정비 조치는 제안하지 않는다. 그것은 정비 계획 담당의 역할이다

출력 형식:
- 판정: 정상 | 이상 | 판단 불가
- 원인 후보: 각각 확신도(%)와 근거
- 추가 확인 필요 항목

좋은 지시문의 요소

요소	왜 필요한가
역할 범위	남의 일을 하지 않게 한다
할 일 목록	빠뜨리지 않게 한다
금지 사항	추측과 월권을 막는다
도구 사용 조건	엉뚱한 도구를 부르지 않게 한다
출력 형식	다음 에이전트가 파싱할 수 있게 한다

실습 순서

1. 위 두 지시문을 각각 넣고 같은 질문을 던져 결과를 비교합니다
2. 금지 사항을 지웠을 때 어떻게 달라지는지 확인합니다
3. 출력 형식을 지웠을 때 결과가 얼마나 흐트러지는지 봅니다
4. 담당 업무에 맞는 지시문을 직접 써서 시험합니다

3번을 꼭 해보세요. 출력 형식이 없으면 다음 에이전트가 결과를 읽지 못해 전체 오케스트레이션이 무너집니다.