LangChain의 create_agent를 이해할 때 핵심은 “에이전트를 쉽게 만든다”가 아닙니다. 더 정확히는 모델, 도구, 프롬프트, 실행 제어를 하나의 하네스로 묶어 준다는 점입니다. 여기서 하네스는 에이전트 루프를 감싸는 실행 환경을 뜻합니다.1
LangChain은 LLM 기반 에이전트와 애플리케이션을 구축하기 위한 프레임워크입니다. OpenAI, Anthropic, Google 등 여러 모델 제공자와 연결할 수 있고, 사전 구축된 에이전트 아키텍처도 제공합니다.2 create_agent는 이 구성요소들을 빠르게 연결해 실행 가능한 에이전트로 만드는 출발점입니다.
create_agent가 만드는 것은 에이전트 루프다
LangChain에서 에이전트는 모델이 도구를 반복 호출하며 작업을 완료하는 구조로 설명됩니다.1 사용자는 model, tools, system_prompt를 지정하고, 에이전트는 상황에 따라 모델을 호출하거나 도구를 실행하며 다음 행동을 결정합니다.
따라서 create_agent는 단순한 생성 함수라기보다 다음 흐름을 감싸는 기본 실행 틀에 가깝습니다.
모델 호출
도구 실행
메시지와 상태 누적
다음 행동 판단
종료 여부 판단
처음 시작하는 방법은 간단합니다. LangChain 기본 설치 명령은 pip install langchain입니다.2 기본 에이전트를 만들 때는 LangGraph의 세부 구조를 직접 다루지 않아도 됩니다.
중요한 확장 지점은 미들웨어다
create_agent의 실용적 가치는 미들웨어에서 더 분명해집니다. 미들웨어는 에이전트 실행 중 특정 지점에 개입해 로깅, 검증, 재시도, 차단, 상태 업데이트 같은 작업을 처리합니다.3
예를 들어 before_model은 모델 호출 전에 실행되고, wrap_model_call은 모델 호출 자체를 감쌉니다. wrap_tool_call은 도구 실행 전후를 제어합니다.3 이 구조를 사용하면 도구 코드나 모델 호출 코드를 직접 고치지 않고도 실행 정책을 붙일 수 있습니다.
실전에서는 다음과 같은 제어가 여기에 들어갑니다.
비용 한도 확인
권한 검증
위험한 도구 호출 차단
반복 호출 또는 루프 폭주 방지
호출 로그 수집
예를 들어 LangChain용 Cycles 미들웨어는 create_agent 워크플로에서 모델 호출과 도구 호출 전에 예산과 권한을 확인하는 방식으로 동작합니다.4 즉 미들웨어는 에이전트를 “돌아가게” 하는 수준을 넘어, 운영 가능한 형태로 통제하는 지점입니다.
LangGraph 위에 있다는 점이 중요한 이유
LangChain 에이전트는 LangGraph 위에 구축됩니다.2 이 덕분에 durable execution, streaming, human-in-the-loop, persistence 같은 기능을 활용할 수 있습니다.2
이 구조는 선택 기준을 명확하게 해 줍니다.
빠르게 에이전트를 만들고 싶다면 create_agent가 적합합니다. 모델, 도구, 프롬프트를 연결해 기본 에이전트 루프를 구성할 수 있기 때문입니다.
반대로 실행 흐름을 더 세밀하게 설계해야 한다면 LangGraph를 직접 사용하는 편이 낫습니다. LangGraph는 결정적 워크플로와 에이전트형 워크플로를 조합해야 하는 고급 오케스트레이션에 권장되며, 높은 수준의 커스터마이징과 지연시간 제어가 필요한 경우에 쓰이는 저수준 에이전트 오케스트레이션 프레임워크입니다.2
결론: create_agent는 운영 가능한 에이전트의 기본형이다
create_agent를 단순히 “에이전트를 만들어 주는 함수”로 보면 핵심을 놓치기 쉽습니다. 더 중요한 역할은 모델, 도구, 프롬프트, 미들웨어를 하나의 실행 환경으로 묶어 에이전트 루프를 관리하게 해 준다는 점입니다.
처음에는 create_agent로 시작해 기본 흐름을 만들고, 미들웨어로 비용·권한·로깅·안전장치를 붙이면 됩니다. 이후 실행 흐름 자체를 더 정교하게 제어해야 할 때 LangGraph로 내려가는 식으로 접근하면 됩니다.
결국 에이전트 개발에서 중요한 것은 모델 성능만이 아닙니다. 실행을 어떻게 통제하고, 관찰하고, 운영 가능한 형태로 만들 것인가가 핵심입니다. create_agent는 그 출발점입니다.
참고
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.