muaco Tech Note

AI 에이전트blog.n8n.io

n8n Agents 만들기모델·도구·워크플로우를 지정해 첫 에이전트 완성하기

n8n의 새 Agents 기능으로 지시문, 모델, 도구를 정해 미리보기로 시험한 뒤 게시하고 Slack이나 일정에 연결할 수 있습니다.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

이 글을 따라 하면 n8n 안에 나만의 에이전트를 하나 만듭니다. 지시문을 쓰고 모델을 고르고 도구와 기존 워크플로우를 붙인 뒤 미리보기로 대화까지 해 봅니다. 마지막에는 게시해서 Slack 같은 채널이나 정해진 일정에 연결합니다.

기존 워크플로우는 조립 설명서처럼 한 단계씩 순서를 정해야 했습니다. 에이전트는 목표만 받고 단계는 스스로 정합니다. n8n은 이를 "무엇을 할지 설명하고, 모델과 도구와 워크플로우를 주면 단계는 알아서 찾는다"고 소개합니다.

미리 갖춰야 할 것

  • n8n Cloud 계정 또는 셀프 호스팅 2.32.3 이상(둘 중 하나). 공식 블로그 기준으로 Cloud에서는 최신 안정 버전을 쓰는 모든 사용자가 에이전트를 쓸 수 있습니다. Enterprise 요금제는 "곧 지원"이라고만 나와 있습니다.
  • 셀프 호스팅을 고른 경우. 셀프 호스팅(내 서버에 n8n을 직접 설치해 쓰는 방식)은 환경 변수 N8N_ENABLED_MODULES=agents를 설정해야 켜집니다.
  • AI 모델 자격 증명. 이미 등록해 둔 모델 자격 증명이나 n8n Gateway 크레딧 중 하나가 필요합니다.
  • 실행 횟수 여유. 에이전트와 한 번 주고받는 대화가 실행 1회로 셉니다. 에이전트가 도구로 부른 워크플로우나 하위 에이전트 호출은 따로 세지 않습니다. 워크플로우와 같은 실행 한도를 나눠 씁니다.

기능은 아직 미리보기(preview) 단계입니다. n8n도 게시 전에 충분히 시험하고 민감한 도구에는 승인을 켜 두라고 권합니다.

따라 하기: 첫 에이전트 만들기

아래 순서는 n8n 공식 문서의 에이전트 만들기 안내를 기준으로 합니다. 화면 이름은 영어 그대로 적었습니다.

1단계: 뼈대 만들기

따라 하기
  1. 프로젝트의 Agents 탭으로 들어가 Create Agent를 누르세요. 에이전트 편집 화면이 열리면 제대로 된 겁니다.
  2. Agent 탭에서 이름을 적고 아이콘 선택기로 아이콘을 고르세요. 여러 에이전트를 만들었을 때 목록에서 구분하기 쉬워집니다.
  3. Model 칸을 열어 제공사와 모델을 고르세요. 자격 증명을 요구하면 그 자리에서 추가합니다. 모델 이름이 칸에 표시되면 됩니다.
  4. Instructions 칸에 역할, 말투, 답의 형식, 지켜야 할 제한, 먼저 쓸 도구를 적으세요. 동료에게 업무를 넘길 때 쓰는 메모처럼 구체적일수록 엉뚱한 행동이 줄어듭니다.

2단계: 도구 쥐여 주기

따라 하기
  1. Tools 영역에서 Add tool을 누르세요. Slack, Google Sheets 같은 기본 연동, 프로젝트 안의 워크플로우, JSON 스키마로 정의한 도구, MCP 서버 중에서 고릅니다.
  2. 도구마다 자격 증명을 연결하세요. 도구는 각자 받은 자격 증명으로만 움직입니다. 에이전트는 시스템 키를 직접 쥐지 않습니다.
  3. 메일 발송, 데이터 수정처럼 되돌리기 어려운 도구에는 승인 요구를 설정하세요. 실행 전에 사람이 승인해야 넘어가게 됩니다. 화면에서 어느 항목을 켜는지는 공식 문서의 승인 안내에 나와 있습니다.
  4. 이미 만든 워크플로우가 있다면 도구로 붙여 보세요. 공식 블로그는 기존 워크플로우를 고치지 않고 그대로 쓸 수 있다고 설명합니다.
  5. 인터넷 검색이 필요하면 Capabilities 영역에서 Web search를 켜세요. 기본은 모델 자체 검색입니다. 모델이 검색을 지원하지 않을 때를 대비해 Brave Search나 직접 운영하는 SearXNG를 자격 증명과 함께 지정해 둘 수 있습니다.

3단계: 시험하고 내보내기

따라 하기
  1. Preview를 눌러 초안과 대화해 보세요. 답이 지시문대로 나오는지, 알맞은 도구를 고르는지 확인합니다.
  2. 승인을 켠 도구가 불리면 대화창에 Approve와 Reject가 뜹니다. 하나를 눌러 흐름이 이어지는지 봅니다.
  3. 설정 오류가 없는지 확인한 뒤 Publish를 누르세요. 게시본이 생기고 초안은 따로 계속 고칠 수 있습니다. 이미 채널이나 일정에 물려 운영 중이라면 미리보기 확인을 마치기 전에는 누르지 마세요. 실제로 돌아가는 게시본이 누르는 즉시 바뀝니다.
  4. Channels 영역에서 쓸 곳을 연결하세요. 문서 기준 지원 채널은 Slack, Telegram, Linear입니다. 공식 블로그는 Discord도 언급하지만 문서 목록에는 없으니 화면에서 확인하세요. 채널마다 연결 절차와 권한이 따로 있습니다. 권한은 에이전트가 실제로 쓸 범위만 주면 됩니다. 회사 워크스페이스라면 관리자 확인 전에는 연결하지 마세요.
  5. 정기 작업이 필요하면 Schedules 영역에서 일정을 추가하세요. 할 일을 적고 Hourly, Daily, Weekly, Monthly, Custom cron 중 주기를 고릅니다.
  6. Sessions 탭을 열어 보세요. 지난 대화의 메시지와 도구 사용 기록이 보이면 운영 준비가 끝났습니다.

처음이라면 Slack 봇 하나에 시스템 한두 개만 붙여 시작해 보세요. 공식 블로그가 첫 예로 권하는 구성입니다.

막히기 쉬운 네 군데

Preview 버튼이 눌리지 않습니다

설정에 오류가 남아 있으면 버튼이 회색으로 비활성 상태가 되고 미리보기가 막힙니다. 화면에 표시된 오류 목록을 하나씩 고치면 버튼이 살아납니다.

셀프 호스팅에서 Agents 탭이 보이지 않습니다

프로젝트 화면에 Agents 탭 자체가 없습니다. 셀프 호스팅에서는 에이전트 모듈이 기본으로 켜져 있지 않고 2.32.3 이상에서만 지원됩니다. 버전을 확인하고 N8N_ENABLED_MODULES=agents를 설정한 뒤 다시 실행하세요.

고친 내용이 일정 실행에 반영되지 않습니다

초안에서 지시문을 바꿨는데 정기 실행은 예전처럼 움직입니다. 일정은 게시된 버전만 돌립니다. 수정을 마쳤다면 Publish를 다시 눌러 게시본을 새로 만드세요.

셀프 호스팅에서 채널 연결이 실패합니다

Slack 같은 채널을 연결해도 메시지가 오가지 않습니다. 문서에 따르면 큐 모드(queue mode, 작업을 대기열로 나눠 처리하는 운영 방식)는 아직 지원되지 않고 채널 연결에는 외부에서 접근 가능한 WEBHOOK_URL이 필요합니다. 일반 모드로 실행하고 WEBHOOK_URL을 공개 주소로 설정하세요.

여기서 더 나아가려면

에이전트가 익숙해지면 Knowledge 탭에 csv, pdf, markdown, txt 파일을 올려 참고 자료를 주세요. 이 기능은 Cloud 전용이고 셀프 호스팅은 Daytona 샌드박스가 필요합니다. 워크플로우 안에서 에이전트를 부르고 싶다면 새로 나온 Message an Agent 노드를 써 보세요.

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

출처

#n8n#n8n Agents#에이전트 만들기#모델 선택#워크플로우#자동화#MCP

같은 분류의 글