챕터별 상세
Shallow Agent와 Deep Agent의 차이점
기존의 일반적인 에이전트는 Shallow Agent로 분류되며 LLM이 도구를 호출하고 결과를 반환하는 단순한 루프 구조를 가진다. 반면 Deep Agent는 명시적인 계획 수립(Planning) 단계가 존재하며 복잡한 쿼리를 하위 작업으로 분해하여 처리한다. Shallow Agent는 복잡한 쿼리 처리 능력이 낮고 컨텍스트 유지에 한계가 있지만 Deep Agent는 이를 체계적으로 해결한다.
에이전트의 복잡도는 LLM의 추론 능력뿐만 아니라 워크플로 설계 방식에 의해 결정된다.
Deep Agent의 4대 핵심 구성 요소
Deep Agent는 Planning Tool, Subagents, System Prompt, File System의 네 가지 핵심 컴포넌트로 구성된다. Planning Tool은 작업을 수행하기 전 To-do List를 생성하고 Subagents는 분할된 작업을 전문적으로 수행하기 위해 동적으로 생성된다. File System은 서브 에이전트 간에 공유되는 영구 메모리 역할을 수행하며 System Prompt는 에이전트의 전반적인 행동 지침을 정의한다.
Claude Code와 같은 최신 에이전트 도구들도 이와 유사한 아키텍처를 공유한다.
개발 환경 구축 및 라이브러리 설정
에이전트 구현을 위해 uv 패키지 매니저를 사용하여 가상 환경을 초기화하고 필요한 라이브러리를 설치했다. deepagents, langchain, langgraph, tavily-python 등이 주요 종속성으로 포함되었다. API 키 관리를 위해 .env 파일을 설정하고 OpenAI, Groq, Tavily 등의 환경 변수를 로드하는 과정을 거쳤다.
uv는 Python 패키지 설치와 관리를 매우 빠르게 수행하는 최신 도구이다.
Tavily를 활용한 웹 검색 도구 구현
에이전트가 외부 정보를 탐색할 수 있도록 TavilyClient를 활용한 web_search 함수를 정의했다. 이 함수는 검색 쿼리, 최대 결과 수, 뉴스 카테고리(Sports, Finance 등)를 파라미터로 받아 실시간 검색 결과를 반환한다. 리터럴(Literal) 타입을 사용하여 입력 가능한 토픽 범위를 제한함으로써 도구 호출의 안정성을 높였다.
Tavily는 AI 에이전트 검색에 최적화된 검색 엔진 API이다.
Deep Agent 생성 및 워크플로 시각화
create_deep_agent 함수를 사용하여 실제 에이전트 객체를 생성했다. 이 과정에서 LLM 모델(Grok-1 등), 정의된 도구 리스트, 시스템 프롬프트를 주입했다. 생성된 에이전트는 내부적으로 PatchToolCalls, Summarization, ToDoList와 같은 미들웨어 훅(Middleware Hooks)이 자동으로 연결된 그래프 구조를 가진다. 이는 일반적인 에이전트보다 훨씬 복잡하고 정교한 실행 흐름을 보여준다.
미들웨어는 에이전트의 실행 전후에 특정 로직을 삽입하는 기술이다.
에이전트 실행 및 결과 분석
에이전트에게 'What is langgraph?'와 같은 복잡한 질문을 던져 실행 결과를 확인했다. 에이전트는 내부적으로 인터넷 검색을 수행하고 검색된 방대한 정보를 요약하며 필요한 경우 로컬 파일 시스템에 컨텍스트를 저장했다. 최종 출력은 단순한 검색 결과 나열이 아니라 수집된 정보를 종합하여 구조화된 답변으로 제공되었다. 실행 과정에서 생성된 파일 정보를 통해 에이전트가 컨텍스트를 어떻게 보존하는지도 확인했다.
Deep Agent는 긴 컨텍스트를 처리할 때 요약과 파일 저장을 병행하여 성능을 유지한다.
언급된 리소스
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 01. 09.수집 2026. 02. 21.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
