에이전트 하네스

에이전트 하네스는 AI 모델이 혼자서는 못 하는 일 — 파일을 열고, 명령을 실행하고, 그 결과를 다시 읽는 일 — 을 하게 만들어 주는 껍데기 프로그램이에요.

비유하자면 모델은 요리사고, 하네스는 주방이에요. 요리사가 아무리 뛰어나도 칼과 불이 없는 방에 갇혀 있으면 요리를 만들 수 없죠. 하네스는 도구를 손에 쥐여 주고, 재료를 가져다주고, 완성된 요리를 다시 확인하게 해 주는 부엌 전체예요. 같은 요리사라도 부엌이 허술하면 결과물도 허술해져요.

그래서 같은 모델을 쓰더라도 어떤 하네스로 감싸느냐에 따라 실제 작업 성공률이 크게 갈려요. 때로는 모델을 바꾸는 것보다 하네스를 바꾸는 쪽이 결과에 더 큰 영향을 미치기도 해요.

한 기사에서는 '같은 Qwen 3.8 27B 모델인데 하네스를 퍼플렉시티의 Computer로 바꾸면 74.0%에서 82.6%로 뛴다'는 식으로 하네스의 영향을 보여줘요. 흔한 오해는 에이전트의 실력을 오직 모델 성능으로만 판단하는 거예요. 실제로는 모델을 감싸는 하네스가 도구 호출과 파일 접근, 오류 복구 방식을 정하기 때문에 최종 성공률을 크게 좌우해요.

AI 에이전트 도구를 쓸 일이 있다면 이렇게 물어보세요: '너는 지금 파일을 직접 열거나 명령을 실행할 수 있어? 어떤 도구들을 쓸 수 있는지 알려줘.' 답변을 보면 그 도구가 단순한 대화형 모델인지, 아니면 하네스를 갖춘 실행형 에이전트인지 감이 잡혀요.