happybell80 58153a49a0 Fix documentation errors and add UUID principle violation docs

- Fix false EmailIntegration bug reports in multiple docs
- Add new UUID principle violation documentation
- Remove incorrect assumptions about gmail_tokens table
- Update 250922 doc to reflect Gateway UUID conversion working
- Clean up research papers organization into subdirectories

2025-09-26 00:38:52 +09:00

7.9 KiB

Raw Blame History

tags, date, modification_date

LLM 에이전트와 워크플로우 오케스트레이션 도구 비교: LangGraph vs n8n

1. 개요

최근 LLM을 활용한 애플리케이션이 복잡해지면서, 여러 도구와 AI 에이전트의 실행 흐름을 관리하는 '오케스트레이션(Orchestration)'이 중요해졌습니다. 이 분야의 도구는 크게 두 가지로 나눌 수 있습니다.

범용 워크플로우 자동화: n8n, Zapier처럼 다양한 SaaS와 API를 연결해 '업무 자동화'에 초점을 맞춘 도구.
LLM/에이전트 오케스트레이션: LangGraph, AutoGen처럼 LLM의 추론, 도구 사용, 에이전트 간의 협업 등 '지능형 워크플로우'를 코드로 구현하는 데 초점을 맞춘 프레임워크.

이 문서는 두 카테고리의 대표주자인 LangGraph와 n8n을 중심으로 각 도구의 특징과 장단점을 심층 비교합니다.

2. 주요 관련 도구 목록 (Python, 코드 중심)

LLM / 멀티 에이전트 / 체인 프레임워크 (LangGraph 계열)

프레임워크 / 라이브러리	특징 / 강점	적합한 용도 / 장점
LangGraph	그래프 기반 워크플로우, 상태 관리, 중단/재개	멀티에이전트, 장기 실행, 복잡한 분기 제어
AutoGen (Microsoft)	다중 에이전트 협업 프레임워크, 에이전트 간 상호작용 정의	복수 에이전트 간 상호작용, 연구/프로토타입
CrewAI	역할 기반(Role-based) 에이전트 협력 구조	계층적, 조직적 워크플로우 구성
Semantic Kernel (MS)	플러그인 아키텍처, Planner와 Memory 기능 내장	.NET/Python 혼합 환경, 기존 앱에 LLM 기능 통합
LlamaIndex	RAG 특화, 최근 Workflow 모듈로 LangGraph 유사 기능 제공	데이터/문서 중심 LLM 시스템 구축
Prefect	데이터 엔지니어링/AI 워크플로우 자동화, Airflow 대체	LLM 파이프라인 스케줄링, 모니터링

범용 자동화 / 워크플로우 도구 (n8n 계열)

도구	특징 / 장점	단점 / 고려사항
Node-RED	흐름 기반 시각 편집기, IoT/이벤트 중심	SaaS 앱 통합은 플러그인 필요
Huginn	오픈소스 에이전트 기반 자동화 (웹 감시, 알림)	UI/사용성은 다소 투박할 수 있음
Apache Airflow	복잡한 DAG 기반 워크플로우, 스케줄링 중심	실시간 반응형 자동화보다는 배치(batch) 중심
Activepieces	n8n 대체용 오픈소스 자동화 도구	생태계가 아직 성장 중

3. LangGraph 심층 분석

LangGraph는 단순한 LLM 체인을 넘어, 복잡하고 장기 실행이 필요한 AI 에이전트 시스템을 구축하기 위한 프레임워크입니다.

3.1. 핵심 가치: 복잡도 관리

간단한 if/else 분기라면 순수 Python 함수가 더 짧고 직관적입니다. 하지만 운영 환경에서는 다음과 같은 요구사항으로 복잡도가 폭발하며, 이때 LangGraph의 가치가 드러납니다.

장기 실행: API 응답 대기, 사람의 승인 등 몇 분에서 몇 시간까지 걸리는 작업을 관리해야 할 때
실패 복구: 여러 단계 중 특정 단계만 실패했을 때, 전체를 다시 시작하는 대신 실패한 부분만 재실행해야 할 때
병렬 처리: 여러 작업을 동시에 실행하고 그 결과를 합쳐야 할 때
멀티에이전트 협업: 여러 AI 에이전트가 각자의 역할을 수행하며 메시지를 주고받아야 할 때
관찰 가능성: 운영 중 문제 발생 시, 어느 단계에서 어떤 데이터로 실패했는지 추적해야 할 때

3.2. 핵심 기능: 체크포인트를 이용한 중단 및 재개

LangGraph가 복잡도를 관리하는 핵심 무기는 **체크포인트(Checkpoint)**입니다.

체크포인트란?: 그래프 실행 도중의 **상태(State)**를 저장해두는 "중간 저장 지점"입니다. (실행 순서, 노드별 입출력 데이터, 메타데이터 등)
저장소: MemorySaver(테스트용), SqliteSaver(로컬/단일서버용), PostgresSaver(운영/분산환경용) 등 다양한 저장소를 지원하며, LangGraph가 테이블 스키마 등을 자동으로 관리해줍니다.
재개 방법: 서버가 다운되거나 작업이 실패해도 체크포인트는 DB에 남아있습니다. 개발자가 **동일한 thread_id로 다시 실행을 요청(invoke)**하면, LangGraph가 저장된 상태를 불러와 중단된 지점부터 자동으로 이어 실행합니다.
자동 재개: LangGraph 자체가 죽은 실행을 자동으로 재개하지는 않습니다. 하지만 외부 스케줄러(Cron, Airflow 등)와 연동하여, DB에 저장된 체크포인트 상태를 감시하고 미완료된 작업을 재호출하는 방식으로 '자동 재개' 시스템을 구축할 수 있습니다.

4. n8n 심층 분석

n8n은 개발자가 아니더라도 다양한 웹 서비스와 API를 연결하여 업무를 자동화할 수 있게 해주는 도구입니다.

4.1. 목적과 실행 환경

핵심 목적: SaaS(구글 시트, 슬랙 등)와 API를 시각적인 UI에서 노드 기반으로 연결하여 반복적인 업무를 자동화하는 것입니다.
실행 환경:
- n8n Cloud: n8n 회사가 직접 운영하는 SaaS 버전. 사용자는 인프라 걱정 없이 웹 UI에서 바로 사용 가능합니다.
- Self-hosted: Docker 등을 이용해 개인 PC, 클라우드 VM, 사내 서버 등 원하는 하드웨어에 직접 설치하여 사용합니다.

4.2. 로컬 파일 접근성

실행 환경에 따라 로컬 파일 접근 여부가 결정됩니다.

n8n Cloud: n8n 서버에서 실행되므로, 사용자의 PC에 있는 로컬 파일에는 직접 접근할 수 없습니다. (구글 드라이브 등 클라우드 스토리지를 경유해야 함)
Self-hosted: n8n을 내 PC에 설치한 경우, Docker 볼륨 마운트 등을 통해 로컬 폴더에 접근하여 파일을 읽고 쓰는 워크플로우를 만들 수 있습니다.

5. LangGraph vs. n8n 핵심 비교

구분	LangGraph	n8n
핵심 목적	LLM 중심 지능형 에이전트 오케스트레이션	범용 SaaS/API 기반 업무 자동화
개발 방식	코드 중심 (Python)	UI 중심 (No-code/Low-code)
주요 기능	상태 관리, 중단/재개, 병렬/분기, 멀티에이전트	이벤트 트리거, API 연결, 데이터 변환
실행 모델	그래프 기반 (상태 머신)	이벤트 기반 (트리거 → 액션)
실행 환경	Python이 실행되는 모든 환경 (라이브러리)	n8n Cloud(SaaS) 또는 자체 서버(Self-hosted)
적합한 사용자	개발자	비개발자, 마케터, 기획자, 개발자

6. 결론: 언제 무엇을 써야 하는가?

n8n을 선택해야 할 때:
- 반복적인 백오피스 업무, 알림, 리포팅, 데이터 동기화가 필요할 때
- 개발자가 아니거나, 코딩 없이 빠르게 자동화 워크플로우를 구축하고 싶을 때
- 여러 SaaS와 API를 연결하는 것이 주된 목적일 때
LangGraph를 선택해야 할 때:
- 복잡한 AI 에이전트 시스템을 운영 환경에 배포해야 할 때
- 장기 실행, 실패 시 재개, 멀티에이전트 협업 등 높은 수준의 제어가 필요할 때
- RAG, Function Calling 등 LLM 기반 워크플로우를 코드로 세밀하게 구현하고 싶을 때
- **"부분 실패 후 이어서 재개"**가 필수적인 시나리오 (ex: 고객지원, 주문처리)

결론적으로, 두 도구는 경쟁 관계라기보다 서로 다른 문제 영역을 해결하는 상호 보완적인 관계에 가깝습니다.

7.9 KiB Raw Blame History