n8n AI Agent 첫 워크플로｜No prompt specified 오류까지

n8n AI Agent 첫 워크플로는 Chat Trigger → AI Agent를 잇고, AI Agent 아래에 채팅 모델·도구·메모리를 붙여 만듭니다.

최종 확인: 2026-10-22

n8n 공식 문서의 AI Agent 페이지에는 "You must connect at least one tool sub-node to an AI Agent node"라고 적혀 있습니다.

도구 없이 모델 답변만 필요하다면 AI Agent 대신 Basic LLM Chain 같은 체인 노드를 씁니다.

첫 워크플로에 들어가는 노드

노드	하는 일	붙이는 자리
Chat Trigger	채팅 메시지가 오면 워크플로를 시작	맨 앞
AI Agent	질문을 보고 어떤 도구를 쓸지 정해 답을 만듦	Chat Trigger 다음
채팅 모델(예: OpenAI Chat Model, Anthropic Chat Model)	에이전트가 생각하고 답을 쓰는 LLM	AI Agent의 Chat Model 자리
도구(예: Calculator, Wikipedia, HTTP Request, Call n8n Workflow Tool, Code Tool)	계산·검색·API 호출 같은 실제 행동	AI Agent의 Tool 자리(최소 1개)
Simple Memory	앞선 대화를 기억	AI Agent의 Memory 자리(선택)

만드는 순서

1. Chat Trigger 추가: 새 워크플로에 Chat Trigger를 놓습니다. 만드는 동안에는 "Make Chat Publicly Available"을 꺼 두고, n8n 편집 화면의 채팅 창으로만 시험합니다.
2. AI Agent 연결: Chat Trigger 뒤에 AI Agent를 연결합니다. Chat Trigger는 에이전트나 체인(chain) 노드와 반드시 이어져 있어야 합니다.
3. 채팅 모델 연결: AI Agent의 Chat Model 자리에 OpenAI Chat Model, Anthropic Chat Model 같은 모델 노드를 붙입니다. 모델 노드의 Credential 칸에서 새 자격 증명을 만들고 API 키를 넣습니다. OpenAI 키는 OpenAI Platform의 API keys 페이지에서, Anthropic 키는 Claude Console에서 발급합니다. 시험 메시지도 모델 API 요금이 나가는 호출입니다.
4. 도구 연결: AI Agent의 Tool 자리에 도구를 하나 이상 붙입니다. 처음이라면 설정이 거의 없는 Calculator나 Wikipedia가 시험하기 쉽습니다.
5. 메모리 연결(선택): 이어지는 대화를 기억하게 하려면 Simple Memory를 붙입니다. Context Window Length는 답할 때 참고할 이전 대화 수입니다(예: 5로 두면 직전 대화 5번까지 참고). Session Key는 대화를 구분하는 키입니다. Chat Trigger로 시작한 워크플로라면 채팅 세션 ID({{ $json.sessionId }})를 넣어 대화마다 기억을 따로 둡니다.

제대로 동작하는지 확인하기

1. 도구 호출 확인: AI Agent 옵션에서 Return Intermediate Steps를 켜고, 편집 화면 채팅 창에 "3,480,000원을 12개월로 나누면 한 달에 얼마야?"를 보냅니다. 답이 290,000원으로 나오고, AI Agent 노드 출력의 중간 단계에 Calculator 도구 호출과 그 입력·출력이 보이면 성공입니다.
2. 메모리 확인: Simple Memory를 붙였다면 같은 채팅 창에서 "내 이름은 민수야"를 보낸 뒤 "내 이름이 뭐였지?"라고 묻습니다. "민수"라고 답하면 메모리가 동작하는 것입니다.
3. 실행 기록 확인: 워크플로의 Executions 목록에서 방금 보낸 메시지마다 실행이 하나씩 기록됐는지 봅니다. 실패한 실행을 열면 어느 노드에서 오류가 났는지 표시됩니다.

AI Agent 옵션에서 바꿀 만한 것

옵션	기본값	쓰임
System Message	-	대화 전에 에이전트에게 줄 지시. 역할과 제약을 적어 도구 선택을 이끕니다.
Max Iterations	10	좋은 답을 만들려고 모델을 몇 번까지 돌릴지. 도구 호출이 끝없이 반복되면 낮춥니다.
Return Intermediate Steps	꺼짐	켜면 에이전트가 거친 중간 단계(어떤 도구를 어떻게 불렀는지)가 결과에 함께 나옵니다.

System Message 예시(Calculator와 Wikipedia를 붙인 경우):

너는 사내 업무 비서야. 숫자 계산은 반드시 Calculator 도구로 하고, 용어 설명이 필요할 때만 Wikipedia 도구를 써. 도구 결과를 받으면 한국어로 세 줄 이내로 답해.

실행 횟수와 메모리에서 놓치기 쉬운 점

Chat Trigger 문서에 따르면 메시지 하나마다 워크플로가 한 번 실행됩니다.

공식 문서의 예로 "one conversation where a user sends 10 messages uses 10 executions", 즉 한 대화에서 메시지를 10번 보내면 실행 10번이 요금제의 실행 한도에서 빠집니다.

Simple Memory 문서에 나온 제약은 두 가지입니다.

• ▸메모리는 세션 사이에 남지 않습니다. 같은 세션 안에서만 앞선 대화를 기억합니다.
• ▸n8n을 queue mode로 운영한다면 운영 중인 워크플로에서 Simple Memory가 동작하지 않습니다.

자주 나는 오류와 해결

n8n 공식 문서의 AI Agent "Common issues" 페이지에 나온 오류들입니다.

오류 메시지	원인	해결
A Chat Model sub-node must be connected	채팅 모델이 연결되지 않음	노드를 연 상태에서 화면 아래 + Chat Model 버튼을 누르거나, 노드를 닫은 상태에서 Chat Model + 연결 단자를 눌러 모델을 고릅니다.
No prompt specified	에이전트가 앞 노드에서 프롬프트를 받지 못함	AI Agent의 Prompt 설정을 Connected Chat Trigger Node에서 Define below로 바꾸고, Text 칸에 고정 문장이나 앞 노드 값을 가리키는 표현식(예: {{ $json.chatInput }})을 넣습니다.
Error in sub-node Simple Memory	예전 버전 메모리 노드(옛 이름 Window Buffer Memory)를 쓰는 템플릿	Simple Memory 노드를 지웠다가 다시 추가해 최신 버전으로 바꿉니다.
400 Invalid value for 'content': expected a string, got null	프롬프트로 들어간 값이 비어 있음(null)	Define below의 표현식이 실제 값을 가리키는지, 앞 노드의 chatInput에 빈 값이 없는지 확인합니다.
모델 노드의 인증 오류(401 등)	API 키가 틀렸거나 만료됨	모델 노드의 Credential을 열어 키를 다시 붙여 넣고, 발급한 계정에 결제 수단·사용 한도가 남아 있는지 확인합니다.

다 만든 뒤 채팅 공개하기

시험이 끝나면 Chat Trigger의 "Make Chat Publicly Available"을 켜고, 워크플로를 저장한 뒤 활성화합니다. 외부 사람이 들어올 채팅 주소는 Chat Trigger 노드의 Chat URL에 표시됩니다.

접속 방식(Mode)과 인증(Authentication)은 이렇게 고릅니다.

설정	선택지	고르는 기준
Mode	Hosted Chat / Embedded Chat	따로 화면을 만들지 않으려면 Hosted Chat. 내 웹사이트에 넣으려면 Embedded Chat(Chat URL의 웹훅 주소를 호출)
Authentication	None / Basic Auth / n8n User Auth	None은 주소를 아는 누구나 사용, Basic Auth는 모두가 같은 아이디·비밀번호로 접속, n8n User Auth는 n8n 계정으로 로그인한 사람만 사용

자주 묻는 질문

대화를 이어 가도 앞 내용을 기억하지 못해요.

AI Agent에 Simple Memory를 연결했는지 확인하세요. 같은 대화 안에서는 Session Key가 같아야 앞 내용이 이어지고, 서로 다른 대화끼리는 키가 달라야 기억이 섞이지 않습니다.

도구 호출이 끝없이 반복돼요.

AI Agent 옵션의 Max Iterations(기본 10)를 낮추고, 위 System Message 예시처럼 "계산은 Calculator로", "용어 설명이 필요할 때만 Wikipedia로"처럼 도구마다 쓰는 조건을 적어 주세요.

참고한 공식 문서

• ▸n8n AI Agent 노드: https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/
• ▸n8n Tools Agent 옵션: https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/tools-agent/
• ▸n8n AI Agent 자주 나는 오류: https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/common-issues/
• ▸n8n Chat Trigger: https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger/
• ▸n8n Simple Memory: https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.memorybufferwindow/

함께 읽으면 좋은 글

• ›Claude Code CLI 스크린 리더 모드 설정법
• ›Claude Code 훅(Hooks)으로 워크플로 자동화하기
• ›LLM API 비용 줄이는 법 (캐싱·모델 선택·토큰 관리)
• ›Codex CLI 플러그인 설정 가이드

🧪 심리 테스트 해보기

🫶

칭찬 들었을 때 반응 타입

테스트 하러 가기 →

🔕

알림 OFF, 나의 오프라인 모드는?

테스트 하러 가기 →