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

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

노드 파라미터#

Make Chat Publicly Available#

채팅을 공개적으로 사용 가능하게(켜짐) 할지 수동 채팅 인터페이스를 통해서만 사용 가능하게(꺼짐) 할지 설정합니다.

워크플로를 구축하는 동안에는 꺼짐 상태로 유지하세요. 워크플로를 게시하고 사용자가 채팅에 액세스할 준비가 되면 켜세요.

Mode#

사용자가 채팅에 액세스하는 방법을 선택합니다:

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

Authentication#

채팅 액세스를 제한할지 여부와 방법을 선택합니다:

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

Initial Message(s)#

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

Make Available in n8n Chat#

에이전트를 Chat Hub에서 사용 가능하게 할지 선택합니다.

Agent Name#

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

Agent description#

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

노드 옵션#

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

Hosted chat 옵션#

Allowed Origin (CORS)#

채팅 URL에 액세스할 수 있는 출처를 설정합니다. 교차 출처 비-프리플라이트 요청에 허용된 URL을 쉼표로 구분하여 입력합니다.

모든 출처를 허용하려면 *(기본값)를 사용합니다.

Input Placeholder, Title, and Subtitle#

채팅 인터페이스에서 이 요소들의 텍스트를 입력합니다.

스크린샷 보기

![Customizable text elements](/images/docs/n8n/_images/integrations/builtin/core-nodes/chat-trigger/hosted-text-elements.png)

Load Previous Session#

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

Off 이외의 옵션을 선택하는 경우 Chat 트리거와 사용 중인 에이전트를 메모리 서브 노드에 연결해야 합니다. Chat 트리거의 메모리 커넥터는 Load Previous Session을 From Memory로 설정할 때 나타납니다. n8n은 Chat 트리거와 에이전트를 모두 동일한 메모리 서브 노드에 연결하는 것을 권장합니다. 이렇게 하면 두 노드 모두에 대한 단일 진실 공급원이 보장됩니다.

스크린샷 보기

![Connect nodes to memory](/images/docs/n8n/_images/integrations/builtin/core-nodes/chat-trigger/connect-memory.png)

Response Mode#

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

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

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

Require Button Click to Start Chat#

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

스크린샷 보기

![New Conversation button](/images/docs/n8n/_images/integrations/builtin/core-nodes/chat-trigger/new-conversation-button.png)

Embedded chat 옵션#

Allowed Origin (CORS)#

채팅 URL에 액세스할 수 있는 출처를 설정합니다. 교차 출처 비-프리플라이트 요청에 허용된 URL을 쉼표로 구분하여 입력합니다.

모든 출처를 허용하려면 *(기본값)를 사용합니다.

Load Previous Session#

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

Off 이외의 옵션을 선택하는 경우 Chat 트리거와 사용 중인 에이전트를 메모리 서브 노드에 연결해야 합니다. Chat 트리거의 메모리 커넥터는 Load Previous Session을 From Memory로 설정할 때 나타납니다. n8n은 Chat 트리거와 에이전트를 모두 동일한 메모리 서브 노드에 연결하는 것을 권장합니다. 이렇게 하면 두 노드 모두에 대한 단일 진실 공급원이 보장됩니다.

스크린샷 보기

![Connect nodes to memory](/images/docs/n8n/_images/integrations/builtin/core-nodes/chat-trigger/connect-memory.png)

Response Mode#

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

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

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

템플릿 및 예시#

관련 리소스#

n8n의 Advanced AI 문서를 확인하세요.

채팅 응답 수동 설정#

에이전트 또는 체인 노드의 출력을 사용자에게 직접 전송하지 않고 에이전트 또는 체인 노드의 출력을 가져와 수정하거나 다른 작업을 수행한 다음 사용자에게 다시 전송하려는 경우 채팅 응답을 수동으로 설정해야 합니다.

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

사용자에게 전송되는 응답을 수동으로 만들어야 하는 경우 text 또는 output이라는 파라미터를 만들어야 합니다. 다른 파라미터 이름을 사용하면 Chat 트리거는 값만 전송하는 것이 아니라 전체 객체를 응답으로 전송합니다.

자주 발생하는 문제#

자주 묻는 질문이나 문제 및 해결 방법은 자주 발생하는 문제를 참조하세요.