말 잘듣는 에이전트 만들기

 "한빛미디어 서평단 <나는 리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다."

 

책제목  : 컨텍스트 엔지니어링으로 구축하는 AI 에이전트

 

저자 : 박경민 지음

 

출판년도 : 2025/12/29

 

https://www.hanbit.co.kr/store/books/look.php?p_code=B3240906879

컨텍스트 엔지니어링으로 구축하는 AI 에이전트

 

 

책을 읽기 전에...

나는 게임 클라이언트 프로그래머로 15년 이상을 종사하고 있다보니 직업병처럼

뭔가가 기대대로 안 나오면 “그럴 수 있음”으로 넘기기보다, 입력/상태/출력을 쪼개서 원인을 찾는다.

최근 취미로 바이브 코딩을 하면서 앱을 제작해 보니, AI 에이전트는 그 방식이 잘 안 먹히는 순간이 왔다.

원하는 대로 동작하지 않아서 지시를 더 구체화하고, 예시를 더 붙이고, 금지사항을 더 추가했다.

문제는 결과가 좋아지기보단 컨텍스트만 길어지고, 어느 순간부터는 “내가 지금 무엇을 고치고 있는지”조차 흐려졌다는 것.

이 책을 통해 노하우를 배우고 앱 제작을 성공적으로 완성하면 좋을것 같다.

 

책을 읽으며 도움이 되었던 부분.

1. 컨텍스트를 '긴 텍스트'가 아니라 '구조화된 템플릿'으로 바꾸기

기존에는 에이전트가 원하는 방식으로 안 움직일 때마다 프롬프트를 계속 덧붙였다.

그 결과 컨텍스트가 비대해졌고, 무엇이 효과가 있었는지/부작용이었는지 분리가 안 됐다.

 

책에서 배운대로 개인 개발 워크플로(B)에 붙일 때, 지시를 한 덩어리로 쓰는 대신

“역할/목표/금지/입력 데이터/출력 형식/예시”를 섹션으로 분리해서 템플릿 형태로 정리했다.

그리고 매번 전부 넣지 않고, 이번 호출에 필요한 조각만 넣는 쪽으로 접근을 바꿨다.

 

‘길게 말하면 해결된다’는 루틴에서 벗어나, 어느 섹션이 문제를 만들었는지(혹은 충돌하는지) 확인할 수 있는 형태가 됐다.

특히 “금지”와 “출력 형식”이 뒤엉켜서 모델이 이상하게 행동하던 패턴을, 템플릿 구조로 분리하니 수정 지점이 눈에 띄었다. 

 

에이전트 문제는 종종 “말을 더 잘하는 법”이 아니라 입력 계약을 설계하는 법에 가까웠다.

컨텍스트가 길어질수록 품질이 오르는 게 아니라, 우선순위가 무너지고 규칙이 충돌하면서 오히려 예측 불가능해진다.

 

 

2. '원하는 대로 동작'을 요청하는게 아니라 '검증 가능한 조건'으로 바꾸기

“내가 원하는 방식”이 너무 내 생각을 단편적으로 말해서, 결과가 틀리면 그냥 다시 말 걸고 또 길어졌다.

템플릿을 만들면서 “원하는 방식”을 문장 하나로 끝내지 않고,

출력 형식을 검증 가능한 조건으로 적어두는 쪽으로 바꿨다.

 

그랬더니 수정할 때 ‘문장 톤’이 아니라 규칙을 고치는 흐름이 생겼고,

그래서 재시도할 때도 내 수정이 누적되기보다 정리되기 시작했다.

 

에이전트를 “대화 상대”로 보면 감정노동(?)이 늘고, “런타임”으로 보면 디버깅 포인트가 생긴다.

나한테는 후자가 훨씬 맞았다.

 

 

내 작업에 어떤 도움을 받았나?

이전에는 막무가내식으로 계속해서 질문을 했다.

그리고 "아까 애기했던 건데 또 이야기 해야해?", "생각 좀 하고 대답하라고"라는 

의미없는, 또는 화가나서 아무렇게나 적는 내용들도 있었다.

하지만 책을 읽고, 실습하며 노하우를 터득한 후로는 템플릿화 하여 보다 빠르게

올바른 방향으로 갈 수 있었다.

내가 힘들었던 부분은  (원하는 대로 안 됨 → 더 길게 말함 → 더 엉킴) 와 같은 부분이었다.

구조를 잡고, 체계적으로 형식화 하는게 중요하다는 걸 몰랐다.

 

좋았던 점 2~4개

컨텍스트를 ‘설계 대상’으로 다루게 만든다:

에이전트를 신기술로 포장하기보다, 입력/출력/규칙의 문제로 끌어내려서 내가 통제할 수 있게 만든다.

 

“길어지는 프롬프트”의 유혹을 끊을 핑계를 준다:

잘 안 되면 더 말하게 되는 인간의 습관을, 구조/템플릿/검증 조건으로 바꿔준다.

 

실무 개발자 관점과 잘 맞는다:

내가 15년 동안 해온 일(규약, 분리, 디버깅)을 그대로 가져와 적용할 수 있었다.

 

바이브 코딩 같은 빠른 제작 흐름에 ‘안전벨트’를 달아준다:

속도는 유지하되, 나중에 망가지지 않게 기본 틀을 잡아주는 느낌.

 

 "한빛미디어 서평단 <나는 리뷰어다> 활동을 위해서 책을 협찬받아 작성된 서평입니다."