커스텀 에이전트 하네스 구축 방법

에이전트는 모델이 작업을 완료할 때까지 도구를 호출하는 루프이며, **에이전트(Agent) = 모델(Model) + 하네스(Harness)**로 정의할 수 있다. 여기서 하네스는 모델을 현실 세계와 연결하는 스캐폴딩(scaffolding) 역할을 하며, 매 단계마다 모델에 적절한 컨텍스트를 제공하는 것이 핵심이다.

LangChain의 create_agent는 미니멀한 방식으로 하네스를 구축할 수 있는 프리미티브를 제공한다. 기존의 완성형 솔루션들과 달리, create_agent는 **미들웨어(Middleware)**를 통해 사용자가 세밀한 커스터마이징을 할 수 있도록 설계되었다.

미들웨어는 에이전트 루프의 각 단계(모델/도구 호출 전후, 시작/종료 시점)에 개입하여 다음과 같은 기능을 수행한다:

• 결정론적 로직(Deterministic Logic): 비즈니스 로직 실행, 정책 강제, 모델 교체 등 프롬프트에 담기 어려운 제어 수행
• 도구(Tools): 도구의 설정, 등록, 해제 등 전체 라이프사이클 관리
• 커스텀 상태(Custom State): 실행 과정 전반에 걸쳐 카운터나 플래그 등 상태 데이터 유지 및 공유
• 스트림 핸들러(Stream Handlers): 에이전트의 출력 스트림을 가로채거나 변형하여 메타데이터 주입 및 라우팅