컴퓨터 앞에 앉아 여유롭게 커피를 마시는 직장인(AI생성)

컴퓨터 앞에 앉아 여유롭게 커피를 마시는 직장인(AI생성)

n8n Self-hosted AI 어시스턴트 활용법 및 설정 가이드

컴퓨터, 소프트웨어 2026년 9월 18일

유료에서만 제공되던 기능

n8n은 오픈소스 자동화 도구입니다. 오픈소스이므로 누구나 소스 코드를 확인할 수 있고, 별도의 비용 없이 무료로 설치해 사용할 수 있습니다. n8n의 기능을 제대로 활용하려면 일반 데스크톱이나 노트북보다는 서버 환경에 설치하는 것이 좋습니다. 하지만 일반 사용자는 전용 서버가 없는 경우가 많으므로, n8n을 이용할 수 있는 서버를 임대해 주는 서비스가 바로 n8n Cloud입니다. AI를 이용해 n8n 워크플로우를 자동으로 생성하는 기능(AI Workflow Builder)은 과거 1.116 버전부터 지원되었으나, 기존에는 Cloud 버전 사용자만 이 기능을 이용할 수 있었습니다. 하지만 최근 출시된 2.35 버전부터는 Self-hosted n8n(n8n Cloud가 아닌 사용자 자체 기기나 서버에 설치한 환경)에서도 AI 어시스턴트(Assistant) 기능을 공식 지원합니다.

n8n의 AI 어시스턴트(Assistant)란?

n8n 2.35 버전부터 도입된 AI 어시스턴트(Assistant)는 자연어 대화만으로 워크플로우 구축, 설정, 오류 수정까지 원스톱으로 지원하는 내장형 AI 비서 기능입니다.

AI 어시스턴트(Assistant) 장점

  • n8n 사용법을 잘 몰라도 AI와 대화하며 워크플로우를 생성할 수 있습니다.
  • 발생한 오류의 원인을 분석하고 AI와 함께 수정할 수 있습니다.
  • 워크플로우 제작뿐만 아니라 노드 사용법도 AI에게 질문할 수 있습니다.
  • 자동화 워크플로우를 훨씬 빠른 속도로 제작할 수 있습니다.
  • 메타 검색 엔진 SearXNG를 이용할 수 있습니다. 개별 사이트를 일일이 조사할 필요 없이 검색 엔진 결과를 실시간으로 무료 이용할 수 있습니다.
💡
AI에게 웹 검색을 지시하면 SearXNG를 검색 도구로 활용합니다. 비용 부담 없이 무제한으로 실시간 웹 검색이 가능합니다.

AI 어시스턴트(Assistant) 사용 화면

간단한 검색 지시

AI Assistant 버튼을 클릭해서 시작
AI Assistant 버튼을 클릭해서 시작

n8n 웹접속 후 좌측 패널의 AI Assistant버튼을 누르면 기능을 시작할 수 있습니다. 검색이 필요한 명령을 지시하면 SearXNG을 이용해서 필요한 내용을 검색합니다. 당연하지만 검색 기능은 ChatGPT, Claude, Gemini를 이용하는 것이 더 성능이 좋습니다.

워크플로우 생성 지시

n8n AI 어시스턴트 기능으로 워크플로우 만들기
n8n AI 어시스턴트 기능으로 워크플로우 만들기

AI에게 워크플로우 생성을 요청한 화면입니다. 요청한 프롬프트 내용은 다음과 같습니다.

1시간 단위로 날씨를 조사해서 비 예보가 있으면 디스코드로 알리는 워크플로우 생성해줘.(지역은 서울)

위 스크린샷과 같이 AI(Gemma4:31b)가 워크플로우를 자동으로 생성했습니다. 날씨 조회에 필요한 API 인증키를 입력하고, 디스코드로 메시지를 보내는 데 필요한 Webhook 또는 인증 정보만 설정하면 정상적으로 작동합니다. Gemma 모델로도 충분히 활용 가능하며, 더 높은 성능의 모델을 연동하면 복잡한 워크플로우도 수월하게 제작할 수 있습니다.

📘
테스트 환경
- AI 모델: Ollama Cloud의 gemma4:31b (무료 제공 한도 내 사용)

AI 어시스턴트(Assistant) 설정법

n8n AI 어시스턴트 최초 설정
n8n AI 어시스턴트 최초 설정

n8n AI 어시스턴트 설정 방법입니다. 2.35 이상의 n8n 버전을 설치한 후 최초 1회만 설정하면 됩니다. n8n설치법을 먼저 알려주는 것이 인지상정이지만 제가 사용하는 설치법은 간단히 적을 수가 없어서 다음 챕터에서 공식 설치 방법을 안내합니다.

모델 설정

n8n AI 어시스턴트 모델 설정
n8n AI 어시스턴트 모델 설정

사용 가능한 모델 분류는 다음과 같습니다. 대머리는 아니지만 공짜를 좋아하는 저는 Ollama Cloud(로컬 아님)를 사용하기 때문에 4번째 것을 골랐습니다.

  • Anthropic
  • OpenAI
  • OpenRouter
  • Self-hosted or OpenAI-compatible endpoint

Anthropic, OpenAI, OpenRouter를 선택하면 API URL이 자동으로 입력됩니다. 반면 OpenAI-compatible endpoint를 선택할 경우 엔드포인트 URL을 직접 작성해야 합니다.

Gemini 설정 예시:

https://generativelanguage.googleapis.com/v1beta/openai/

Ollama 설정 예시 (기존 URL 끝에 /v1 추가):

https://ollama.com/v1

엔트로픽, 오픈AI, 오픈라우터는 모델을 항목 중에 고르면 됩니다. OpenAI 호환 엔드포인트는 사용하려는 모델명 직접 입력해야 합니다. 역시 돈이 좋네요.

샌드박스 설정

n8n AI 어시스턴트 샌드박스 설정
n8n AI 어시스턴트 샌드박스 설정

AI가 안전하게 코드를 실행할 샌드박스 환경을 지정합니다. 도커 컴포즈 파일(docker-compose.yml 또는 compose.yml) 내에 sandbox-certs, sandbox-api, sandbox-runner-1 서비스가 포함되어 있다면 이미 Self-hosted 샌드박스가 구축된 상태입니다. 이 경우 n8n Sandbox를 선택합니다.

Service URL sandbox-api 서비스의 URL을 입력합니다. 기본 포트를 변경하지 않았다면 도커 내부 네트워크 포트인 8080을 사용합니다.

http://sandbox-api:8080

샌드박스 API Key n8n을 설치할 때 생성한(아마도 .env 파일 내에 있음) SANDBOX_API_KEYS를 넣어주면 됩니다.

Self-hosted n8n 환경이지만 자체 샌드박스를 구성하지 않은 경우, 외부 연동 서비스인 Daytona를 사용할 수도 있습니다.

웹 검색(Web search) 설정

n8n AI 어시스턴트 설정 완료
n8n AI 어시스턴트 설정 완료

도커 컴포즈 파일 내에 searxng 서비스가 포함되어 있다면 Web search는 자동으로 인식되므로 추가 설정이 필요 없습니다.

모든 설정이 완료되면 위 화면과 같이 AI Assistant를 사용할 준비가 되었다는 안내가 표시됩니다.

AI 어시스턴트 권한 설정

n8n_ai_assistant_permission.webp
n8n_ai_assistant_permission.webp

Settings > AI Assistant 메뉴로 이동하여 하단으로 스크롤을 내리면 AI 어시스턴트의 실행 권한을 변경할 수 있습니다. 명령 실행 시 사용자 승인 없이 즉시 실행하도록 설정하는 것도 가능합니다.

n8n Self-hosted 설치 참고

n8n 공식 문서에서 제공하는 자동 설치 스크립트 명령어입니다. 최근에는 간단한 스크립트로 설치 프로세스를 지원합니다.

curl -fsSL https://get.n8n.io | sh
⚠️
저는 n8n 커스텀 도커 이미지를 사용해서 위 명령으로 설치해 보진 않았습니다. 도커와 도커 컴포즈(v2)만 설치되어 있으면 문제없이 잘 설치될 것입니다.

추가 기능(워크플로우에서 AI 어시스턴트 열기)

n8n 워크플로우 에디터에서 AI 어시스턴트 열기
n8n 워크플로우 에디터에서 AI 어시스턴트 열기

워크플로우 에디터 화면에서도 AI 어시스턴트를 즉시 호출할 수 있습니다. 타인이 작성한 워크플로우에 대해 설명을 요청하거나, 작업 중 막히는 부분에 대해 질문할 수 있습니다.

AI 어시스턴트로 워크플로우에 대한 설명 듣기
AI 어시스턴트로 워크플로우에 대한 설명 듣기

이전에 작성해 둔 워크플로우의 구조와 노드 역할에 대해 질문해 보았습니다. 다음 질문으로 왜 데이터 테이블을 썼는지 물어봤는데 답변을 잘 하네요.

n8n 설치나 워크플로우 생성에 어려움을 겪고 있다면...

self-hosted n8n설치 및 워크플로우 제작을 도와 드립니다. node.js 및 파이썬 추가 패키지, ffmpeg 등이 포함된 커스텀 도커 이미지 제작도 가능합니다.(비용 문의)
댓글이나 mail@bonik.me 로 연락주세요.

태그

BoniK

협업, 의뢰, 레슨 등 문의 : mail@bonik.me | https://open.kakao.com/me/bonik

Bubble button icon