에이전트는 n8n에서 구축하는 자율 어시스턴트입니다. 각 에이전트에는 언어 모델, 지침, 그리고 도구, 스킬, 지식 베이스 접근과 같이 직접 설정하는 기능이 있습니다. 에이전트는 프로젝트 내에서 워크플로와 나란히 일급 아티팩트로 존재합니다. 작업이 고정된 워크플로로 처리하기에는 너무 개방적이고, 요청을 추론하고, 적절한 도구를 선택하고, 응답에 맞게 적응할 수 있는 어시스턴트가 필요할 때 에이전트를 사용하세요.

에이전트로 구축할 수 있는 것#

업로드한 파일과 연결된 서비스를 사용해 질문에 답하고, Slack, Google Sheets, Linear와 같은 도구에서 작업을 수행하고, 더 큰 작업을 완료하기 위해 워크플로를 트리거하거나 조율하는 데 에이전트를 사용하세요. 에이전트는 다른 에이전트에 위임하거나 일정에 따라 실행될 수도 있습니다. 아래의 서브 에이전트와 일정을 참고하세요.

에이전트 작동 방식#

에이전트는 추론 루프를 실행합니다. 메시지를 보내거나 일정이 트리거하면, 에이전트는 지침을 읽고 요청을 살펴본 다음 다음에 무엇을 할지 결정합니다: 도구 호출, 지식 베이스 검색, 다른 에이전트로 넘기기, 또는 후속 질문하기. 최종 응답을 만들어낼 때까지 이 루프를 반복합니다.

에이전트와의 각 대화는 세션이며, n8n은 이를 저장하여 나중에 재개할 수 있게 하고 에이전트가 메모리를 통해 컨텍스트를 기억할 수 있게 합니다.

에이전트의 구성 요소#

에이전트 빌더에서 에이전트의 다음 구성 요소를 설정합니다:

모델, 지침, 도구, 스킬, 지식, 메모리, 서브 에이전트는 에이전트를 구축하는 동안 설정합니다. 채널과 일정은 게시해야 적용됩니다.

초안 버전과 게시된 버전#

모든 에이전트에는 초안 버전이 있으며, 준비가 되면 게시된 버전이 생깁니다. 초안은 변경 사항을 만드는 곳이며, n8n이 자동으로 저장합니다. 게시된 버전은 누군가 에이전트와 채팅하거나, 채널이 트리거하거나, 일정이 실행될 때 동작하는 버전입니다.

게시는 초안의 스냅샷을 만들기 때문에, 편집하는 동안 실행 중인 에이전트는 변경되지 않습니다. 게시할 때마다 게시 기록에 버전이 추가되며, 언제든지 이전 버전으로 복원하거나 되돌릴 수 있습니다.

에이전트 구축하기#

에이전트 빌더에서 에이전트를 구축합니다. 이름과 모델부터 시작해 지침을 추가한 다음, 에이전트에 필요한 도구, 스킬, 지식, 메모리, 서브 에이전트를 연결합니다. n8n은 변경 사항을 초안에 자동으로 저장합니다.

에이전트 생성하기#

1. 왼쪽 메뉴에서 프로젝트를 선택합니다. 그런 다음 Agents 탭으로 이동합니다.
2. Create Agent를 선택합니다. n8n이 빈 초안으로 에이전트 빌더를 엽니다.
3. Agent 탭에서 에이전트의 이름을 입력합니다. 아이콘 선택기를 사용해 아이콘을 변경합니다.

모델 선택하기#

Agent 탭에서 Model 필드를 열고 제공업체와 모델을 선택합니다. 제공업체에 자격 증명이 필요하다면 안내에 따라 추가하세요.

지침 작성하기#

Instructions 필드에 에이전트의 역할, 어조와 응답 형식, 해야 할 일과 하지 말아야 할 일, 일반적인 작업에서 선호해야 할 도구나 스킬을 설명합니다.

지침은 구체적으로 작성하세요. 에이전트가 예상대로 동작하지 않는다면, 도구를 더 추가하기 전에 먼저 지침을 다듬으세요.

도구 추가하기#

Tools 섹션에서 Add tool을 선택하고, 기본 도구(Slack이나 Google Sheets와 같은 n8n 통합), 동일한 프로젝트의 워크플로, JSON 스키마로 정의된 커스텀 도구, MCP 서버를 통한 외부 도구 중에서 선택합니다.

에이전트는 지침과 작업을 바탕으로 어떤 도구를 사용할지 결정하며, 도구를 추가할 때 연결한 자격 증명을 사용합니다. 민감한 도구의 경우, 에이전트가 실행하기 전에 승인을 요구하도록 설정할 수 있습니다. 도구 호출 승인하기를 참고하세요.

스킬로 기능 묶기#

스킬은 특정 작업에 필요한 지침과 도구를 함께 묶습니다. 에이전트가 각기 다른 단계를 가진 여러 개별 작업을 처리해야 할 때 스킬을 사용하세요.

스킬을 추가하려면:

1. Skills 섹션을 열고 Add skill을 선택합니다.
2. 스킬에 이름과 짧은 설명을 부여합니다.
3. 스킬이 사용할 수 있는 도구를 선택합니다.
4. 에이전트가 스킬을 실행할 때 따라야 할 지침을 작성합니다.

에이전트는 설명과 현재 요청을 바탕으로 적절한 스킬을 선택합니다.

지식 업로드하기#

Knowledge 탭에서 에이전트가 검색하고 읽을 수 있는 파일을 추가합니다. 지원되는 파일 형식: csv, pdf, markdown, txt.

파일을 업로드하면, 에이전트는 질문에 답하고 컨텍스트를 가져오기 위해 지식 베이스를 검색할 수 있습니다.

메모리 설정하기#

세션 메모리는 현재 대화의 컨텍스트를 유지합니다. 기본으로 켜져 있으며 별도의 설정이 필요 없습니다.

에이전트가 이전 세션의 컨텍스트를 기억하게 하려면:

1. Memory 탭을 엽니다.
2. Episodic memory를 활성화합니다.

에피소드 메모리는 메모리를 저장하고 조회하기 위해 OpenAI 자격 증명이 필요합니다.

서브 에이전트 추가하기#

서브 에이전트를 사용하면 이 에이전트가 다른 게시된 에이전트에게 작업을 넘길 수 있습니다. 작업에 명확하게 분리된 부분이 있고 전문화된 에이전트가 각 부분을 더 잘 처리할 수 있을 때 서브 에이전트를 사용하세요.

1. 기능 목록에서 Agents 섹션을 엽니다.
2. Add agent를 선택하고 프로젝트에서 게시된 에이전트를 선택합니다.
3. When should this agent be used? 아래에 이 서브 에이전트를 호출해야 하는 상황을 설명합니다.

에이전트 설정에서 병렬로 실행되는 서브 에이전트의 최대 개수를 설정할 수 있습니다.

에이전트 미리보기#

게시하지 않고 에이전트를 테스트하려면 헤더에서 Preview를 선택합니다. n8n이 현재 초안으로 채팅 세션을 시작합니다. 게시하기 전에 미리보기를 사용해 에이전트의 동작, 도구 선택, 응답을 확인하세요.

Preview가 비활성화되어 있다면 초안에 설정 오류가 있는 것입니다. n8n이 해결해야 할 항목을 나열합니다.

에이전트 게시하기#

에이전트를 게시하면 사용자, 채널, 일정에서 사용할 수 있게 됩니다. 게시된 버전만 프로덕션에서 실행되므로, 사람들이 보는 내용이나 일정이 사용하는 내용을 바꾸지 않고도 초안을 계속 편집할 수 있습니다.

1. 에이전트 빌더에서 에이전트를 엽니다.
2. 오류를 확인합니다. Publish가 비활성화되어 있다면 n8n이 해결해야 할 설정 항목을 나열합니다.
3. Publish를 선택합니다.

게시는 현재 초안의 스냅샷을 만들어 이를 활성 버전으로 표시합니다.

게시된 에이전트 업데이트하기#

에이전트가 게시되면 편집 내용은 초안에 반영됩니다. 게시된 버전은 다시 게시할 때까지 계속 실행됩니다.

변경 사항을 배포하려면:

1. 에이전트 빌더에서 초안을 편집합니다. n8n이 변경 사항을 자동으로 저장합니다.
2. Preview로 변경 사항을 테스트합니다.
3. 새 버전을 릴리즈하려면 Publish를 다시 선택합니다.

저장하지 않은 변경 사항을 버리고 게시된 버전과 일치시키려면, 게시 메뉴에서 Revert changes를 선택하세요.

에이전트 게시 취소하기#

프로젝트에 초안을 유지하면서 에이전트를 오프라인으로 전환하려면, 게시 메뉴에서 Unpublish를 선택합니다. 다시 게시할 때까지 사용자, 채널, 일정은 더 이상 에이전트를 실행할 수 없습니다. 초안은 계속 편집할 수 있습니다.

게시된 에이전트와 채팅하기#

에이전트 빌더의 채팅 패널을 사용하면 에이전트와 직접 대화할 수 있습니다.

1. 채팅 패널을 엽니다.
2. 메시지를 입력하고 전송합니다. 에이전트가 세션을 시작하고 응답합니다.
3. 과거 대화를 검토하거나 이어가려면, 세션 기록을 열고 세션을 선택합니다.

n8n은 각 대화를 세션으로 저장합니다. 주고받은 메시지, 에이전트가 사용한 도구, 대기 중인 승인을 포함해 Sessions 탭에서 세션을 검토하세요.

도구 호출 승인하기#

민감한 도구의 경우, 에이전트는 도구를 실행하기 전에 일시 중지하고 승인을 요청합니다. 채팅에서 도구를 실행하려면 Approve를, 취소하려면 Reject를 선택하세요. 에이전트는 여러분의 결정을 반영해 중단했던 지점부터 계속 진행합니다.

다른 곳에서 에이전트에 접근하기#

채널을 연결하면 사람들이 에이전트 빌더 채팅 외부에서도 에이전트에 접근할 수 있습니다.

사용 가능한 채널:

• Slack
• Telegram
• Linear

에이전트에서 Channels 섹션을 열고 원하는 채널의 설정 방법을 따르세요. 각 채널은 고유한 연결 및 권한 모델을 갖습니다.

일정에 따라 에이전트 실행하기#

일정을 사용하면 에이전트가 반복적으로 자체적으로 실행됩니다. Schedules 섹션에서 일정을 추가하고, 에이전트가 완료해야 할 작업을 설명한 다음, 빈도를 선택합니다:

• 매시간(Hourly)
• 매일(Daily)
• 매주(Weekly)
• 매월(Monthly)
• 커스텀 cron(Custom cron)

일정은 에이전트의 게시된 버전에 대해서만 실행됩니다. n8n은 각 일정에 대해 다음 실행 시각, 마지막 실행 시각, 마지막 실행 결과를 표시합니다.

워크플로에서 에이전트 사용하기#

워크플로 내에서 에이전트를 두 가지 방식으로 사용할 수 있습니다:

• 에이전트를 인라인으로 생성: 워크플로에 노드로 에이전트를 직접 추가합니다. 워크플로 에디터를 벗어나지 않고 에이전트를 구축하고 설정할 수 있습니다.
• 기존 에이전트에게 메시지 보내기: 워크플로에서 이미 생성된 에이전트에게 메시지를 보냅니다. 게시된 에이전트에 접근하고 그 기능을 자동화에 통합할 수 있습니다.

셀프 호스팅#

에이전트는 버전 2.32.3(베타)부터 셀프 호스팅 n8n에서 실행됩니다. 설정하는 방법은 두 가지가 있습니다:

• 수동으로 구축: agents 모듈을 활성화합니다(N8N_ENABLED_MODULES에 agents를 추가). 모델을 직접 선택하고, 지침을 작성하고, 도구와 스킬을 직접 연결합니다. 에이전트를 구축하고 실행하는 데 필요한 것은 이것이 전부입니다.
• 전체 경험: AI 지원 구축을 위해 AI 어시스턴트(instance-ai)도 설정합니다. 에이전트를 설명하면 n8n이 이를 스캐폴딩합니다. 지식 베이스에는 Daytona 샌드박스가 필요하며, 채널을 연결하려면 공개 WEBHOOK_URL이 필요합니다.

환경 변수와 설정 단계는 에이전트 활성화를 참고하세요.

에이전트 실행과 가격#

에이전트와의 한 턴은 하나의 실행으로 계산됩니다. 턴은 메시지를 보내고 에이전트가 응답을 생성하는 단일 교환입니다.

에이전트는 워크플로와 동일한 실행 할당량을 공유합니다. 에이전트와 워크플로의 실행은 플랜의 동일한 총량에 포함됩니다.