챗봇 및 기타 채팅 인터페이스를 위한 AI 워크플로를 구축할 때 Chat Trigger 노드를 사용합니다. n8n에서 제공하는 인터페이스 중 하나 또는 직접 만든 인터페이스를 사용하여 사용자가 채팅에 접근하는 방식을 구성할 수 있습니다. 인증을 추가할 수도 있습니다.

에이전트 또는 체인 루트 노드 중 하나를 반드시 연결해야 합니다.

노드 파라미터#

채팅 공개#

채팅을 공개적으로 사용할 수 있게 할지(켜기) 또는 수동 채팅 인터페이스를 통해서만 사용할 수 있게 할지(끄기)를 설정합니다.

워크플로를 구축하는 동안에는 이 옵션을 꺼 두세요. 워크플로를 게시하고 사용자가 채팅에 접근할 수 있도록 준비가 되면 켜세요.

모드#

사용자가 채팅에 접근하는 방식을 선택합니다. 다음 중에서 선택합니다.

• Hosted Chat: n8n에서 호스팅하는 채팅 인터페이스를 사용합니다. 노드 옵션을 사용하여 인터페이스를 구성할 수 있고 다른 설정이 필요 없으므로 대부분의 사용자에게 권장됩니다.
• Embedded Chat: 이 옵션은 직접 채팅 인터페이스를 만들어야 합니다. n8n의 채팅 위젯을 사용하거나 직접 구축할 수 있습니다. 채팅 인터페이스는 노드의 Chat URL에 표시된 웹훅 URL을 호출해야 합니다.

인증#

채팅 접근을 제한할지 여부와 방법을 선택합니다. 다음 중에서 선택합니다.

• None: 채팅이 인증을 사용하지 않습니다. 누구나 채팅을 사용할 수 있습니다.
• Basic Auth: 채팅이 기본 인증을 사용합니다.
  • 사용자 이름과 비밀번호가 있는 Credential for Basic Auth를 선택하거나 생성합니다. 모든 사용자는 동일한 사용자 이름과 비밀번호를 사용해야 합니다.
• n8n User Auth: n8n 계정에 로그인한 사용자만 채팅을 사용할 수 있습니다.

초기 메시지#

이 파라미터는 Hosted Chat을 사용하는 경우에만 사용할 수 있습니다. 사용자가 페이지에 도착했을 때 n8n 채팅 인터페이스가 표시하는 메시지를 구성하는 데 사용합니다.

n8n Chat에서 사용 가능하게 설정#

에이전트를 Chat Hub에서 사용할 수 있게 할지 선택합니다.

에이전트 이름#

Chat Hub에서의 에이전트 이름입니다.

에이전트 설명#

Chat Hub에서의 에이전트 설명입니다.

노드 옵션#

사용 가능한 옵션은 채팅 모드에 따라 다릅니다.

Hosted chat 옵션#

Allowed Origin (CORS)#

채팅 URL에 접근할 수 있는 오리진을 설정합니다. 교차 오리진 비프리플라이트(non-preflight) 요청에 허용되는 URL을 쉼표로 구분한 목록으로 입력합니다.

모든 오리진을 허용하려면 *(기본값)를 사용합니다.

입력 자리표시자, 제목 및 부제목#

채팅 인터페이스의 이러한 요소에 표시할 텍스트를 입력합니다.

스크린샷 보기

Load Previous Session#

이전 채팅 세션의 채팅 메시지를 불러올지 선택합니다.

Off 이외의 옵션을 선택하면 Chat trigger와 사용 중인 Agent를 메모리 서브 노드에 연결해야 합니다. Load Previous Session을 From Memory로 설정하면 Chat trigger에 메모리 커넥터가 나타납니다. n8n은 두 노드의 단일 정보 출처(single source of truth)를 보장하기 위해 Chat trigger와 Agent를 모두 동일한 메모리 서브 노드에 연결할 것을 권장합니다.

스크린샷 보기

Response Mode#

채팅을 처리하는 에이전트 또는 체인 뒤에 단계가 있는 워크플로를 구축할 때 이 옵션을 사용합니다. 다음 중에서 선택합니다.

• When Last Node Finishes: Chat Trigger 노드가 워크플로에서 마지막으로 실행된 노드의 응답 코드와 데이터 출력을 반환합니다.
• Using Response Nodes: Chat Trigger 노드가 Chat 노드 또는 Respond to Webhook 노드에 정의된 대로 응답합니다. 이 응답 모드에서 Chat Trigger는 워크플로에서 마지막으로 실행된 노드의 데이터를 출력하지 않고 이러한 노드에 정의된 메시지만 표시합니다.

• Streaming response: 워크플로가 처리되는 동안 사용자에게 실시간 데이터 스트리밍을 활성화합니다. 워크플로에 스트리밍을 지원하는 노드(예: AI agent 노드)가 필요합니다.

채팅 시작 시 버튼 클릭 필수#

채팅 인터페이스에 New Conversation 버튼을 표시할지(켜기) 여부(끄기)를 설정합니다.

스크린샷 보기

Embedded chat 옵션#

Allowed Origin (CORS)#

채팅 URL에 접근할 수 있는 오리진을 설정합니다. 교차 오리진 비프리플라이트(non-preflight) 요청에 허용되는 URL을 쉼표로 구분한 목록으로 입력합니다.

모든 오리진을 허용하려면 *(기본값)를 사용합니다.

Load Previous Session#

이전 채팅 세션의 채팅 메시지를 불러올지 선택합니다.

Off 이외의 옵션을 선택하면 Chat trigger와 사용 중인 Agent를 메모리 서브 노드에 연결해야 합니다. Load Previous Session을 From Memory로 설정하면 Chat trigger에 메모리 커넥터가 나타납니다. n8n은 두 노드의 단일 정보 출처(single source of truth)를 보장하기 위해 Chat trigger와 Agent를 모두 동일한 메모리 서브 노드에 연결할 것을 권장합니다.

스크린샷 보기

Response Mode#

채팅을 처리하는 에이전트 또는 체인 뒤에 단계가 있는 워크플로를 구축할 때 이 옵션을 사용합니다. 다음 중에서 선택합니다.

• When Last Node Finishes: Chat Trigger 노드가 워크플로에서 마지막으로 실행된 노드의 응답 코드와 데이터 출력을 반환합니다.
• Using Response Nodes: Chat Trigger 노드가 Chat 노드 또는 Respond to Webhook 노드에 정의된 대로 응답합니다. 이 응답 모드에서 Chat Trigger는 워크플로에서 마지막으로 실행된 노드의 데이터를 출력하지 않고 이러한 노드에 정의된 메시지만 표시합니다.

• Streaming response: 워크플로가 처리되는 동안 사용자에게 실시간 데이터 스트리밍을 활성화합니다. 스트리밍이 활성화된 노드가 워크플로에 필요합니다.

템플릿 및 예제#

n8n-nodes-base.compression 통합 템플릿 살펴보기 또는 모든 템플릿 검색

관련 리소스#

채팅 응답 수동으로 설정하기#

Agent 또는 Chain 노드의 출력을 사용자에게 직접 전송하지 않으려는 경우 채팅 응답을 수동으로 설정해야 합니다. 대신 Agent 또는 Chain 노드의 출력을 가져와 수정하거나 사용자에게 다시 보내기 전에 다른 작업을 수행하려는 경우입니다.

기본 워크플로에서 Agent 및 Chain 노드는 output 또는 text라는 이름의 파라미터를 출력하며, Chat trigger는 이 파라미터의 값을 채팅 응답으로 사용자에게 전송합니다.

사용자에게 전송되는 응답을 수동으로 생성해야 하는 경우 text 또는 output이라는 이름의 파라미터를 생성해야 합니다. 다른 파라미터 이름을 사용하면 Chat trigger는 값만이 아니라 전체 객체를 응답으로 전송합니다.

FAQ#

n8n 워크플로우에 채팅 인터페이스를 연결하려면 어떻게 하나요?#

워크플로우의 트리거로 Chat Trigger 노드를 추가한 다음, 에이전트 또는 체인 루트 노드를 연결하세요. 사용자가 메시지를 보낼 때마다 워크플로우가 실행되므로, 백엔드 로직이 각 메시지를 처리합니다.

채팅을 공개하거나 내 사이트에 임베드하려면 어떻게 하나요?#

채팅 공개를 켠 다음 Mode를 선택하세요. Hosted Chat은 별도의 설정 없이 n8n의 호스팅 인터페이스를 사용합니다. Embedded Chat을 사용하면 n8n의 채팅 위젯이나 직접 만든 인터페이스를 사용할 수 있으며, 이 인터페이스는 노드에 표시된 Chat URL 웹훅을 호출합니다.

워크플로우에서 챗봇의 응답을 설정하려면 어떻게 하나요?#

기본 워크플로우에서 Chat Trigger는 Agent 또는 Chain 노드의 output 또는 text 값을 사용자에게 전송합니다. 응답을 사용자 지정하려면 text 또는 output이라는 이름의 파라미터를 생성하세요. 채팅 응답 수동으로 설정하기를 참고하세요. Chat 노드를 사용하는 경우 Response Mode를 Using Response Nodes로 설정하세요.

일반적인 문제#

일반적인 질문이나 문제 및 권장 해결 방법은 일반적인 문제를 참조하세요.