챕터별 상세
n8n 소개 및 에이전트 구축의 기초
n8n은 2019년에 시작된 로우코드 통합 워크플로 도구로, 현재는 AI 에이전트 오케스트레이션 기능을 강력하게 지원한다. 에이전트가 수행하는 작업을 사용자가 직접 보고 제어할 수 있어야 한다는 철학을 바탕으로 시각적 캔버스를 제공한다. 사용자는 JavaScript 코드를 직접 작성하거나 노드를 연결하는 방식으로 복잡한 로직을 구현할 수 있다.
AI 에이전트 노드와 LLM 연결
n8n의 'AI Agent' 노드는 일반 노드와 달리 모델, 메모리, 도구 연결을 위한 전용 입력 포트를 가진다. OpenRouter를 통해 Claude 3.5 Sonnet이나 GPT-4o와 같은 최신 모델을 연결할 수 있으며, API 키 설정을 통해 즉시 추론이 가능하다. 에이전트 노드는 사용자의 채팅 입력을 받아 어떤 도구를 호출할지 스스로 판단하는 뇌 역할을 수행한다.
대화 맥락 유지를 위한 메모리 설정
에이전트가 이전 대화 내용을 기억하지 못하는 문제를 해결하기 위해 'Simple Memory' 노드를 추가한다. 이 노드는 세션 ID를 기반으로 대화 이력을 저장하며, 컨텍스트 윈도우 크기를 설정하여 과거 메시지 참조 범위를 조절할 수 있다. 프로무션 환경에서는 PostgreSQL이나 Redis와 같은 외부 DB를 메모리 저장소로 연결하여 영구적인 기억을 관리할 수 있다.
LLM 자체는 상태가 없는(Stateless) 구조이므로, 대화의 흐름을 유지하려면 별도의 메모리 시스템이 필요하다.
에이전트에게 도구(Tools) 부여하기
Gmail과 Google Calendar 노드를 에이전트의 도구로 연결하여 실제 액션을 수행하게 한다. 각 노드에서 'Defined automatically by the model' 옵션을 활성화하면 LLM이 해당 노드의 파라미터를 스스로 채울 수 있게 된다. 예를 들어 이메일 발송 도구의 경우 수신자, 제목, 본문 필드를 에이전트가 문맥에 맞게 생성하여 입력한다.
javascript
{{ $json.sessionId }}n8n 워크플로에서 세션 ID를 참조하여 대화의 맥락을 유지하기 위한 표현식 예시
정교한 에이전트 작동을 위한 프롬프팅 기법
에이전트가 도구를 정확하게 사용하도록 노드 이름과 설명을 구체적으로 작성해야 한다. 노드 설명은 LLM에게 전달되는 도구 명세서 역할을 하므로, '이 도구는 이메일을 보낼 때 사용하며 마크다운 형식을 지원한다'와 같은 지침을 포함한다. 시스템 프롬프트에는 에이전트의 역할, 현재 시간 정보, 그리고 '모르는 정보는 추측하지 말고 질문하라'는 가이드라인을 명시한다.
인간 참여형(Human-in-the-loop) 승인 레이어 구현
이메일 발송이나 일정 생성처럼 파괴적인 작업 직전에 'Human Review' 노드를 삽입하여 블랙박스 문제를 해결한다. 이 노드는 에이전트가 도구를 호출하려고 할 때 실행을 일시 중단하고 사용자에게 승인 요청 메시지를 보낸다. 사용자는 채팅창에서 에이전트가 생성한 내용을 확인하고 '승인(Send)' 또는 '거절(Decline)'을 선택하거나 수정을 요구할 수 있다.
이 방식은 에이전트가 도구를 직접 호출하는 것이 아니라 n8n이 중간에서 가로채어 검토 단계를 거치게 하는 인터셉터 패턴을 사용한다.
Slack 연동 및 백그라운드 자동화
에이전트의 인터페이스를 n8n 내부 채팅창에서 Slack으로 확장할 수 있다. Slack 트리거와 응답 노드를 연결하면 사용자는 익숙한 메신저 환경에서 에이전트와 대화하고 승인 절차를 진행할 수 있다. 또한 'Schedule Trigger'를 추가하여 매시간 인박스를 정리하거나 특정 조건 발생 시 에이전트가 먼저 사용자에게 Slack 메시지를 보내 승인을 요청하는 능동적 자동화가 가능하다.
javascript
$tool.parameters.to
$tool.parameters.subject
$tool.parameters.message에이전트가 도구를 호출할 때 전달한 파라미터를 인간 검토 단계에서 표시하기 위한 참조 코드
MCP를 통한 외부 에이전트와의 연결
n8n은 최근 Model Context Protocol(MCP) 서버 기능을 출시하여 외부 AI 도구와의 연결성을 강화했다. 이를 통해 Claude Code와 같은 외부 에이전트가 n8n에서 정의한 복잡한 워크플로를 하나의 도구처럼 호출하여 사용할 수 있다. 이는 n8n의 시각적 자동화 능력을 텍스트 기반 코딩 에이전트의 강력한 확장 도구로 변모시킨다.
용어 해설
- 인간 참여형 루프(Human-in-the-loop)
- — AI 에이전트가 자율적으로 모든 결정을 내리는 대신, 중요한 실행 단계에서 인간의 승인이나 개입을 거치도록 설계된 시스템 아키텍처입니다. 이는 AI의 오작동이나 잘못된 데이터 처리를 방지하고 시스템의 신뢰성과 안전성을 확보하는 데 필수적인 제어 메커니즘입니다.
- 모델 컨텍스트 프로토콜(MCP)
- — Model Context Protocol의 약자로, 서로 다른 AI 모델과 도구 간에 컨텍스트와 기능을 표준화된 방식으로 공유할 수 있게 해주는 프로토콜입니다. n8n과 같은 워크플로 엔진을 Claude Code 등 외부 에이전트와 연결하여 에이전트가 워크플로를 도구처럼 호출할 수 있게 합니다.
- 시스템 프롬프트(System Prompt)
- — LLM이 특정 역할을 수행하거나 규칙을 준수하도록 설정하는 최상위 지침입니다. 에이전트의 성격, 사용 가능한 도구의 범위, 금지 사항 등을 정의하여 에이전트가 의도한 맥락 내에서만 작동하도록 가이드라인을 제공합니다.
언급된 리소스
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 05. 03.수집 2026. 05. 03.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
