[업무 자동화] n8n Assistant 사용법: 말로 설명해 워크플로 자동으로 만들기

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

n8n은 여러 앱을 이어 붙여 반복 업무를 자동으로 돌리는 도구예요. 지금까지는 화면에 부품을 하나씩 끌어다 놓고 선을 직접 이어야 했어요. n8n Assistant는 그 조립을 말로 시킬 수 있게 해줘요. "폼으로 들어온 신청서를 담당자에게 나눠 보내줘"처럼 설명하면 노드를 골라 배치하고 연결까지 해줘요.

n8n 블로그는 이 조수가 워크플로를 만든 뒤 직접 실행해 보고 노드가 실패하면 원인을 따져 고친 다음 다시 돌린다고 밝혀요. 결과물은 특별한 형식이 아니라 평범한 n8n 워크플로예요. 캔버스에 그대로 보이고 손으로 고칠 수 있고 실행할 때마다 기록이 남아요.

이 글에서는 클라우드에서 바로 켜는 방법과 직접 서버에 올려 쓸 때 넣어야 할 설정값을 함께 다뤄요. 2026년 9월 기준 공식 문서와 소개 글에서 확인한 내용만 옮겼어요.

미리 챙길 준비물

여기서 걸리면 아래를 다 읽어도 소용이 없어요. 먼저 확인해요.

요금제. 공식 문서는 n8n Cloud의 Starter와 Pro, 셀프호스팅의 Community, Registered Community, Business에서 쓸 수 있다고 적어요. Enterprise는 아직 지원하지 않고 프리뷰 접근은 담당 CSM에게 문의하라고 안내해요.
클라우드를 쓴다면 새로 만든 인스턴스에서는 기본으로 켜져 있어요. 다만 Enterprise Cloud 인스턴스는 당분간 기본 활성화에서 빠져 있어요.
직접 서버에 올렸다면 도커로 돌려야 해요. npm으로 설치한 n8n은 지원하지 않아요. 버전 조건은 근거마다 달라요. 공식 설정 문서는 "최신 안정판 이상을 돌리세요, 이전 버전도 동작할 수 있지만 새것이 낫습니다"라고 느슨하게 적고 n8n 블로그 소개 글은 2.36 이후라고 못 박아요. 안전하게 가려면 최신 안정판으로 올리고 시작해요.
모델 API 키. 셀프호스팅은 Anthropic, OpenAI, OpenRouter 가운데 한 곳의 키가 필요해요.
AI 크레딧. 처리한 토큰만큼 크레딧이 줄어요. 대화가 길거나 워크플로가 크거나 오류를 여러 번 잡으면 더 많이 써요.

따라 하기: 말로 워크플로 만들기

준비: 조수를 켜요

클라우드를 쓰면 인스턴스에 로그인하고 작업할 프로젝트로 들어가요. 새 인스턴스라면 이미 켜져 있어서 따로 할 준비가 없어요. 소개 글은 "인스턴스에서 n8n Assistant를 열고 자동화를 설명하라"고만 안내하고 화면 어느 자리에 있는지는 밝히지 않았어요.
직접 서버에 올렸다면 환경변수에 N8N_ENABLED_MODULES=instance-ai를 넣어요. 조수 기능을 켜는 스위치예요. 여기에 모델 키 N8N_INSTANCE_AI_MODEL_API_KEY를 함께 넣어요. ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY로 대신 넣어도 인식해요.
쓸 모델은 N8N_INSTANCE_AI_MODEL에 제공자/모델 형식으로 적어요. 이름이 비슷한 앞 단계의 API 키 변수에 모델 이름을 적어 넣지 않게 조심해요. 기본값은 anthropic/claude-opus-4-8이고 문서가 든 다른 예는 openai/gpt-5.5와 openrouter/deepseek/deepseek-v4-pro예요. 제공자를 바꾸려면 이 변수와 위의 키를 짝을 맞춰 함께 바꿔요.
샌드박스를 켜요. N8N_INSTANCE_AI_SANDBOX_ENABLED=true는 빼면 안 돼요. 조수가 만든 작업을 격리된 공간에서 돌리려고 두는 장치예요. n8n이 안내하는 한 줄 설치나 도커 컴포즈 가이드를 따랐다면 샌드박스가 이미 돌고 있어서 모델 키만 넣으면 돼요.
샌드박스를 손수 띄운다면 N8N_INSTANCE_AI_SANDBOX_PROVIDER=n8n-sandbox와 N8N_SANDBOX_SERVICE_URL, N8N_SANDBOX_SERVICE_API_KEY를 함께 설정해요. 문서는 운영 환경에서는 Daytona 쪽을 권해요. 이때는 N8N_INSTANCE_AI_SANDBOX_PROVIDER=daytona와 DAYTONA_API_URL, DAYTONA_API_KEY를 넣어요.
제대로 떴는지 확인해요. 터미널(명령을 글로 쳐서 컴퓨터를 시키는 창)에 curl http://<sandbox-api-host>:8080/healthz를 치면 {"status":"ok"}가 돌아와야 해요.

만들기: 하고 싶은 자동화를 설명해요

조수 채팅창에 원하는 자동화를 문장으로 적어요. 문서는 다섯 가지를 담으라고 권해요. 무엇이 워크플로를 시작하는지, 어떤 앱이나 서비스를 쓰는지, 어떤 데이터를 읽고 보내고 갱신하는지, 성공하면 어떻게 되는지, 실패하면 어떻게 할지예요.
말이 모호하면 조수가 되물어요. 소개 글은 추측하기 전에 먼저 묻는다고 밝혀요. 되묻는 질문에 답할수록 원하는 모양에 가까워져요.
캔버스를 봐요. 노드가 하나씩 놓이고 선으로 이어지면 조립이 되고 있는 거예요. 소개 글이 든 예시는 폼 응답을 담당자에게 나눠 보내기, 스프레드시트를 정해진 시각마다 CRM과 맞추기예요.

확인: 돌려보고 발행해요

자격증명 카드가 채팅에 뜨면 계정을 이어요. 자격증명은 내 계정에 들어갈 열쇠 꾸러미인데, n8n이 따로 보관하다가 필요할 때 꺼내 써요. 미리 만들어 둔 자격증명을 고르거나 새로 만들면 돼요. API 키나 토큰은 평소 쓰던 n8n 자격증명 화면에서 넣어요.
채팅창에는 비밀번호나 키를 붙여 넣지 마세요. 문서는 자격증명의 비밀값이 AI에게 전달되지 않고 AI가 보지도 못한다고 못 박아요. 채팅에 직접 적으면 그 약속이 깨져요.
실제와 비슷한 데이터로 한 번 실행해요. 노드가 실패하면 조수가 원인을 따져 고칠 방법을 제안하고 적용한 뒤 다시 돌려요.
사람 눈으로 검토한 다음에 발행해요. 문서는 운영에 올리기 전에 항상 확인하라고 적어요. 흐름, 설정값, 연결된 자격증명을 차례로 봐요.

여기서 자주 막혀요

조수가 아예 보이지 않아요. 요금제부터 봐요. Enterprise는 아직 지원 대상이 아니에요. 직접 올린 서버라면 최신 안정판으로 올려 보고 npm이 아니라 도커로 돌리고 있는지 확인해요. 그다음 N8N_ENABLED_MODULES에 instance-ai가 들어 있는지 봐요.
켜지긴 했는데 응답이 없어요. N8N_INSTANCE_AI_MODEL에 적은 제공자와 넣어 둔 키가 맞는지 확인해요. Anthropic 모델을 고르고 OpenAI 키를 넣으면 당연히 막혀요. 샌드박스 상태도 위의 healthz 주소로 다시 확인해요.
계정 연결에서 멈춰요. 조수는 남의 서비스에 가입해 주지는 못해요. 슬랙이든 구글이든 계정과 API 키는 사람이 먼저 만들어 두어야 해요.
크레딧이 빨리 줄어요. 오류를 잡느라 여러 번 돌리면 그만큼 소모돼요. 한 번에 큰 워크플로를 통째로 시키기보다 작게 나눠 시키면 낭비가 줄어요.
시켰는데 안 되는 일도 있어요. 브라우저를 대신 조작하는 자동화는 지원하지 않아요. 인스턴스 여러 개를 한꺼번에 다루지도 못하고, 먼저 상태를 감시해 알아서 제안하지도 않아요.

여기서 더 나아가려면

워크플로에 익숙해졌다면 에이전트 쪽을 봐요. N8N_ENABLED_MODULES에 agents를 instance-ai와 나란히 넣으면 모델과 지시문, 도구를 직접 붙인 에이전트를 만들 수 있어요. 문서는 n8n 2.32.3부터 프리뷰로 제공한다고 적어요.

조수가 웹을 찾아보게 하려면 INSTANCE_AI_BRAVE_SEARCH_API_KEY나 N8N_INSTANCE_AI_SEARXNG_URL을 더해요. 다만 n8n Assistant는 아직 프리뷰 딱지를 달고 활발히 바뀌는 중이에요. 몇 달 뒤에 화면과 설정이 달라질 수 있으니 막히면 공식 문서를 다시 확인해요.

말로 시켜서 나온 워크플로도 결국 평범한 n8n 워크플로예요. 조수가 만든 뒤에 캔버스를 열어 흐름을 눈으로 따라가 보면 노드가 어떻게 이어지는지 자연스럽게 익혀져요. 첫 자동화는 작게 잡아 보세요.

이상으로 글 마치겠습니다.

출처

n8n Assistant 사용법말로 설명해 워크플로 자동으로 만들기