n8n Assistant는 자연어로 워크플로를 만들고, 편집하고, 테스트하고, 문제를 해결하도록 도와주는 n8n 내 채팅 기반 에이전트입니다. 에이전트를 구축하고, 워크플로 이름 변경이나 게시 같은 인스턴스 작업도 도와줍니다.

자동화하려는 내용을 설명하세요. n8n Assistant는 워크플로를 계획하고, 선택한 프로젝트에 구축하고, 테스트하고, 오류를 해결하도록 도와줍니다.

결과물은 일반적인 n8n 워크플로입니다. 다른 워크플로와 마찬가지로 열어서 살펴보고, 편집하고, 테스트하고, 게시할 수 있습니다.

n8n Assistant가 도와줄 수 있는 작업#

n8n Assistant와는 채팅으로 상호작용합니다. n8n 내부의 도구를 사용해 워크플로를 만들고 디버깅하도록 도와줍니다.

n8n Assistant에게 다음 작업을 요청할 수 있습니다.

• 워크플로 생성: 원하는 자동화를 설명하면 n8n Assistant가 워크플로를 생성할 수 있습니다.
• 에이전트 구축: 원하는 에이전트를 설명하면 n8n Assistant가 추가할 지침, 도구, 스킬을 제안할 수 있습니다. 에이전트는 agents 모듈을 사용해 셀프 호스팅 환경에서도 실행됩니다. 에이전트 구축 및 관리와 에이전트 활성화를 참조하세요.
• MCP 서버 연결: MCP 서버 레지스트리의 서버를 어시스턴트에 직접 연결하면, 작업을 수행하고 워크플로를 구축하는 동안 컨텍스트를 수집하는 데 모두 사용할 수 있습니다.
• 브라우저에서 작업: Browser Use를 연결하면 n8n Assistant가 사이트를 탐색하고, 양식을 작성하고, 자격 증명을 대신 설정할 수 있습니다.
• 워크플로 편집: 워크플로 변경, 노드 추가, 로직 업데이트, 구성 조정을 요청할 수 있습니다.
• 워크플로 테스트 및 문제 해결: 점검을 실행하고, 관련 오류를 확인하고, 해결 방법을 제안하도록 요청할 수 있습니다.
• 자격 증명 지원: 시크릿을 채팅에 붙여넣지 않고도 기존 자격 증명을 선택하거나 새로 만들도록 안내합니다.
• n8n 리소스 활용: 필요할 때 데이터 테이블 같은 지원 리소스를 만들거나 업데이트합니다.
• 승인된 웹사이트 조사: 웹 액세스를 활성화하면 n8n Assistant가 도메인에 접근하기 전에 권한을 요청합니다.
• 최근 작업 이어가기: 이전에 만든 워크플로나 실패한 실행에 대해 물어보면, 이름을 직접 말하지 않아도 n8n Assistant가 찾아낼 수 있습니다.

n8n Assistant가 인스턴스에 대해 아는 것#

대화를 시작할 때 n8n Assistant는 인스턴스 컨텍스트, 즉 어시스턴트를 연 프로젝트에 대한 짧은 요약을 받습니다. 덕분에 워크플로 이름을 말하지 않아도 "마지막으로 실패한 실행 찾아줘" 같은 프롬프트에 n8n Assistant가 응답할 수 있습니다.

인스턴스 컨텍스트는 세 가지 소스를 활용합니다.

n8n Assistant는 대화의 첫 메시지와 함께 초기 요약을 받습니다. 이 요약에 포함되는 워크플로, 활동 항목, 실행 기록의 수에는 제한이 있습니다. n8n Assistant는 필요할 때 더 자세한 내용을 가져올 수 있습니다. 이후에는 각 메시지에 그동안 변경된 내용만 담깁니다. 관련 없는 작업은 새 대화에서 시작하세요. 그러면 n8n Assistant가 프로젝트를 처음부터 다시 읽습니다.

n8n Cloud에서는 n8n이 인스턴스 컨텍스트에 대한 액세스를 제어합니다. 셀프 호스팅 인스턴스에서는 인스턴스 관리자가 기능 플래그를 재정의해 인스턴스 컨텍스트를 활성화할 수 있습니다. 인스턴스 컨텍스트 활성화를 참조하세요.

n8n Assistant가 인스턴스 컨텍스트에서 조회할 수 있는 것#

인스턴스 컨텍스트에는 내용이 아니라 포인터가 들어 있습니다. n8n Assistant는 이를 통해 다음을 할 수 있습니다.

• 최근 변경 사항을 더 거슬러 올라가 읽기. 인스턴스 컨텍스트는 최근 기간만 다룹니다. n8n Assistant는 더 오래된 항목을 나열하거나, 워크플로 또는 자격 증명 변경으로 필터링하거나, 항목 하나를 열어 단일 워크플로의 최근 변경 이력을 볼 수 있습니다.
• 실제 레코드 열기. 모든 줄에 ID가 있으므로 n8n Assistant가 해당하는 워크플로, 실행, 자격 증명을 가져올 수 있습니다.

활동 항목은 활동 로그 보존 설정을 따릅니다. 실행은 실행 데이터 보존 설정을 따릅니다. n8n이 활동 항목을 정리(prune)한 경우 n8n Assistant는 해당 항목 없이 계속 진행합니다.

n8n Assistant가 사용 중인 노드를 파악하는 방법#

노드 유형 집계는 인스턴스 컨텍스트와는 별도의 설정입니다. 인스턴스 관리자가 활성화해야 합니다. 노드 유형 집계 활성화를 참조하세요.

이 설정을 켜면 n8n Assistant는 사용자의 관례를 파악하기 위해 모든 워크플로를 읽는 대신, 프로젝트에서 각 노드 유형을 사용하는 워크플로가 몇 개인지 물어볼 수 있습니다. 노드 유형의 수만 보고하고 파라미터 값은 보고하지 않으므로, 워크플로 10개 중 10개가 Slack 노드를 사용한다는 것은 알 수 있어도 각 노드를 어떻게 구성했는지는 알 수 없습니다. 관례를 이름만 언급하는 데 그치지 않고 따르려면 n8n Assistant가 워크플로 하나를 전체적으로 읽습니다.

인스턴스 컨텍스트에 포함되지 않는 것#

활동 로그는 변경이 있었다는 사실만 기록하고 변경 내용은 기록하지 않습니다. 워크플로의 구조나 구성에 관한 질문에 답하기 위해 n8n Assistant는 워크플로 자체를 읽습니다.

인스턴스 컨텍스트에는 다음이 포함되지 않습니다.

• 파라미터 값. 변경 항목에는 추가하거나 제거한 노드 유형과 변경한 설정의 이름이 기록됩니다. 설정한 값은 기록되지 않습니다.
• 개별 노드. 저장 항목에는 추가하거나 제거한 노드 유형이 기록되며 개별 노드는 기록되지 않습니다. 두 번째 Slack 노드를 추가하면 전체 노드 수는 바뀌지만 새로운 유형이 추가되지는 않습니다.
• 큰 변경에 포함된 모든 노드 유형. 한 번의 저장이 노드 유형 한도를 초과하면 항목에는 일부만 나열되고 전체 개수가 보고됩니다.
• 열지 않은 프로젝트의 작업. 인스턴스 컨텍스트는 한 프로젝트 안에 머뭅니다를 참조하세요.

시작하기 전에#

n8n Assistant를 사용하려면 해당 기능이 활성화된 n8n 인스턴스에 액세스할 수 있어야 합니다.

다음을 확인하세요.

• n8n Assistant가 작업할 프로젝트에 액세스할 수 있습니다.
• 작업에 필요한 워크플로, 자격 증명, 리소스를 사용할 권한이 있습니다.
• 워크플로가 무엇을 해야 하는지 알고 있습니다.

n8n Assistant는 n8n 사용자의 권한을 사용합니다. 사용자에게 사용 권한이 있는 워크플로, 자격 증명, 리소스에만 액세스할 수 있습니다.

효과적인 프롬프트 작성#

구체적인 프롬프트는 n8n Assistant가 더 적은 반복으로 더 나은 결과를 내는 데 도움이 됩니다.

프롬프트를 작성할 때 다음을 포함하세요.

• 워크플로를 트리거하는 조건,
• 워크플로가 사용해야 하는 앱 또는 서비스,
• 워크플로가 읽거나, 보내거나, 업데이트해야 하는 데이터,
• 워크플로가 성공했을 때 일어나야 하는 일,
• 워크플로가 실패했을 때 일어나야 하는 일,
• n8n Assistant가 워크플로를 게시하기 전에 먼저 물어봐야 하는지 여부.

프롬프트 예시#

워크플로 생성#

Create a workflow that checks Gmail every morning for invoices,
saves PDF attachments to Google Drive, and adds a row to a Data Table.
Ask me before publishing the workflow.

실패한 실행 디버그#

Debug the latest failed execution of this workflow.
Explain what failed, then suggest a fix before changing anything.

기존 워크플로 업데이트#

Update this workflow so failed orders are sent to Slack,
then retry the API request after 10 minutes.

AI가 생성한 변경 사항 검토#

n8n Assistant는 n8n 인스턴스에서 작업을 수행할 수 있지만, 제어권은 사용자에게 있습니다.

AI가 생성한 워크플로를 프로덕션에서 사용하기 전에 다음을 수행하세요.

• 워크플로 로직을 검토합니다.
• 노드 구성과 자격 증명을 확인합니다.
• 예상 입력 데이터로 워크플로를 테스트합니다.
• 실행 결과와 오류 처리를 확인합니다.
• 워크플로가 의도하지 않은 작업을 수행하지 않는지 확인합니다.

n8n Assistant는 게시, 삭제 등 그 밖의 중요한 변경처럼 영향이 큰 작업을 하기 전에 확인을 요청합니다.

자격 증명 처리#

자격 증명 시크릿은 AI로 전송되지 않으며, AI는 이를 볼 수 없습니다.

n8n Assistant는 n8n 2.41.0부터 자격 증명 설명을 읽을 수 있습니다. n8n 2.42.0부터는 인스턴스에서 자격 증명 설명을 활성화한 경우에만 n8n Assistant가 설명을 읽습니다.

n8n Assistant는 사용 가능한 자격 증명 설명을 활용해 같은 유형의 자격 증명 중에서 선택하도록 돕습니다. 예를 들어 설명으로 프로덕션 계정인지 테스트 계정인지 구분할 수 있습니다. 선택이 여전히 불분명하면 n8n Assistant가 어떤 자격 증명을 사용할지 묻습니다.

AI는 자격 증명 설명을 받을 수 있습니다. 설명에 API 키, 비밀번호, 토큰을 포함하지 마세요.

워크플로에 자격 증명이 필요하면 n8n Assistant가 채팅에서 자격 증명 카드를 표시합니다. 이 카드에서 다음을 할 수 있습니다.

• 프로젝트에서 액세스 권한이 있는 기존 자격 증명을 선택합니다.
• 새 자격 증명을 만듭니다.

Browser Use를 통해 n8n Assistant에게 브라우저에서 자격 증명을 대신 만들어 달라고 요청할 수도 있습니다. 시크릿은 자격 증명에 바로 입력되며 AI는 이를 보지 못합니다.

직접 새 자격 증명을 만드는 경우, 시크릿은 채팅이 아닌 표준 n8n 자격 증명 화면에 입력합니다. API 키, 비밀번호, 토큰을 대화에 붙여넣지 마세요.

웹 액세스#

웹 액세스를 활성화하면 n8n Assistant는 외부 도메인에 접근하기 전에 권한을 요청합니다.

액세스를 승인하기 전에 요청된 도메인을 검토하세요.

프리뷰 제한 사항#

n8n Assistant는 프리뷰 기능입니다. 제공 여부, 지원되는 작업, 동작이 바뀔 수 있습니다.

프리뷰 기간에는 다음과 같은 제한이 있습니다.

• n8n Assistant가 아직 지원하지 않는 작업이 있을 수 있습니다.
• 일부 기능은 점진적으로 제공될 수 있습니다.
• n8n Assistant가 예상보다 자주 확인을 요청할 수 있습니다.
• 생성된 워크플로는 수동 검토와 수정이 필요할 수 있습니다.
• UI, 크레딧 사용량, 지원되는 리소스가 바뀔 수 있습니다.

데이터 및 개인정보 보호#

n8n Assistant는 워크플로를 구축하고 문제를 해결하는 데 필요한 정보를 처리합니다.

작업에 따라 다음이 포함될 수 있습니다.

• 프롬프트와 채팅 메시지,
• 워크플로 구조와 노드 구성,
• 문제 해결에 사용하는 선택된 실행 및 오류 세부 정보,
• 자격 증명 이름, 유형, 설명 또는 연결 상태,
• 웹 액세스를 활성화한 경우 승인된 웹 페이지 또는 도메인,
• 어시스턴트를 연 프로젝트에 있는 워크플로의 이름,
• 해당 프로젝트의 최근 워크플로 및 자격 증명 변경 기록,
• 해당 워크플로 중 실행된 것과 실패한 실행.

n8n Assistant는 시크릿을 채팅에 붙여넣도록 요구하지 않습니다. API 키, 비밀번호, 토큰은 표준 n8n 자격 증명 화면을 통해 입력하세요.

인스턴스 컨텍스트는 한 프로젝트 안에 머뭅니다#

대화는 어시스턴트를 연 프로젝트를 사용합니다. 자동 인스턴스 컨텍스트와 활동 로그 검색은 해당 프로젝트만 읽습니다. 워크플로 검색과 노드 유형 집계에는 읽기 권한이 있는 다른 프로젝트가 포함될 수 있습니다.

n8n Assistant는 사용자 본인의 권한으로 인스턴스 컨텍스트를 읽으며, n8n은 시작할 때 한 번이 아니라 메시지마다 권한을 확인합니다. 프로젝트에 대한 액세스를 잃으면 n8n Assistant는 해당 프로젝트 읽기를 중단합니다.

대화의 프로젝트 밖에 있는 활동 항목 ID를 조회하면, 존재하지 않는 항목을 조회했을 때와 같은 응답이 돌아옵니다. 이러한 요청으로는 다른 프로젝트에 항목이 존재하는지 알 수 없습니다.

크레딧 사용량#

n8n Cloud에서 n8n Assistant는 기반 AI 모델이 처리한 토큰에 따라 Assistant 크레딧을 사용합니다. 요금제에는 매월 첫째 날 초기화되는 Assistant 크레딧 월간 제공량이 포함됩니다. 모두 사용하면 인스턴스 소유자가 추가 크레딧을 구매해 다음 초기화 때까지 n8n Assistant를 계속 사용할 수 있습니다. 인스턴스의 모든 사용자가 하나의 잔액을 공유합니다.

Assistant 크레딧과 Gateway 크레딧은 별개입니다. Assistant 크레딧은 n8n Assistant와의 대화 비용을 충당하며, 워크플로나 에이전트가 실행될 때 호출하는 AI 모델 비용은 충당하지 않습니다. Gateway 크레딧은 그러한 모델 호출 비용을 충당하며, n8n Assistant에는 사용되지 않습니다. 한쪽을 충전해도 다른 쪽에 추가되지 않습니다.

대화가 길수록, 워크플로가 클수록, 디버깅 세션과 반복 수정이 많을수록 더 많은 크레딧을 사용합니다.

불필요한 사용을 줄이려면 다음과 같이 하세요.

• 워크플로의 목표와 제약 조건을 구체적으로 설명합니다.
• 관련 없는 작업은 새 대화에서 시작합니다.
• 구축을 요청하기 전에 n8n Assistant의 계획을 검토합니다.
• 새로운 안내 없이 같은 워크플로를 다시 생성해 달라고 요청하지 않습니다.

잔액을 확인하려면 n8n Assistant 패널에서 크레딧 메뉴를 여세요. 요금제의 월간 제공량은 n8n 요금제 및 가격을 참조하세요.

셀프 호스팅 n8n은 Assistant 크레딧을 사용하지 않습니다. 셀프 호스팅 인스턴스에서 n8n Assistant는 사용자 본인의 AI 공급자 계정으로 실행됩니다. n8n Assistant 설정을 참조하세요.

관련 자료#

• 워크플로 구축 방법
• Browser Use 활용하기
• n8n MCP 서버 사용하기
• 템플릿 사용하기
• Ask n8n AI 사용하기
• Chat Hub 사용하기