muaco Tech Note

업무 자동화blog.n8n.io

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

n8n Assistant를 켜고 자연어로 자동화를 설명해 노드 배치, 연결, 계정 연결까지 맡기는 방법을 처음부터 따라 할 수 있게 정리했습니다.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

n8n Assistant를 쓰면 자동화 조립을 말로 시킬 수 있습니다. n8n은 여러 앱을 이어 붙여 반복 업무를 자동으로 돌리는 도구입니다. 지금까지는 화면에 부품을 하나씩 끌어다 놓고 선을 직접 이어야 했습니다.

"폼으로 들어온 신청서를 담당자에게 나눠 보내줘"처럼 설명해 보세요. 조수가 노드를 골라 배치하고 연결까지 해 줍니다.

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 크레딧. 처리한 토큰만큼 크레딧이 줄어듭니다. 대화가 길거나 워크플로가 크거나 오류를 여러 번 잡으면 더 많이 씁니다.

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

준비: 조수 켜기

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

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

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

확인: 돌려 보고 발행하기

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

여기서 자주 막히는 지점

  • 조수가 아예 보이지 않습니다. 요금제부터 보세요. 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#n8n Assistant#워크플로 자동화#자연어 자동화#노코드#업무 자동화#셀프호스팅#AI 에이전트

같은 분류의 글