에이전트 하네스 완전 해부

에이전트 = 모델 + 하네스

모델이 아닌 모든 것을 하네스라고 함

하네스란 모델 그 자체가 아닌 모든 코드, 설정, 실행 로직을 의미

날 것의 모델에 하네스가 상태, 도구 실행, 피드백 루프, 강제 가능한 제약 같은 것들을 부여하는 순간 모델은 에이전트가 됨

 

- 하네스가 포함하는 것

시스템 프롬프트

도구 / 스킬 / MCP와 그 설명들

번들링된 인프라 (파일 시스템 / 샌드박스 / 브라우저)

오케스트레이션 로직 (서브에이전트 생성 / 핸드오프 / 모델 라우팅)

결정론적 실행을 위한 훅/미들웨어 (compaction / continuation / lint check)

 

 

 

 

 

하네스가 필요한 이유

우리가 에이전트에게 시키고 싶은 일 중에는 모델이 그 자체로는 할 수 없는 일들이 있음

 

- 모델이 기본적으로 할 수 없는일

상호작용 간에 지속 가능한 상태 유지

코드 실행

실시간 지식 접근

작업 완수를 위한 환경 세팅 및 패키지 설치

 

 

 

 

 

지속적 저장과 컨텍스트 관리를 위한 파일 시스템

모델은 컨텍스트 윈도우 안의 지식에 대해서만 직접 작업할 수 있음

파일 시스템이 도입되기 전에는 사용자가 모델에게 내용을 복사, 붙혀넣기 했었음

 

하네스는 파일시스템 추상화와 파일 시스템 작업 (fs-ops)용 도구를 기본 탑재

에이전트에게 데이터, 코드, 문서를 읽을 수 있는 작업 공간이 생김

중간 산출물을 저장하고 한 세션을 넘어서는 상태를 유지할 수 있음

 

 

 

 

 

범용 도구로서의 Bash와 코드

하네스는 bash 도구를 기본 탑재해, 모델이 코드를 작성하고 실행하며 자율적으로 문제를 풀수 있게함

 

 

 

 

 

작업을 실행하고 검증하기 위한 샌드박스와 도구

에이전트는 안전하게 행동하고, 결과를 관찰하며 진저을 이룰 수 있는 적절한 기본 환경이 필요함

모델에게 저장 공간과 코드 실행 능력을 줬지만, 이 모든 것이 '어딘가에서' 일어나야함

에이전트가 만든 코드를 로컬에서 실행하는건 위험하고, 단일 로컬 환경은 대규모 에이전트 워크로드에는 부적합

 

샌드박스는 에이전트에게 안전한 실행 환경을 제공

로컬 대신 하네스가 샌드박스에 연결해 코드를 실행하고, 파일을 살펴보고, 의존성을 설치하고, 작업을 완료

 

 

 

 

 

 

Reference

https://yozm.wishket.com/magazine/detail/3718/