Chat Trigger 노드#
AI 워크플로를 챗봇 및 기타 챗 인터페이스에 구축할 때 Chat Trigger 노드를 사용하세요. 사용자가 챗에 접근하는 방식을 n8n에서 제공하는 인터페이스 또는 사용자가 만든 인터페이스 중 하나로 구성할 수 있습니다. 인증을 추가할 수 있습니다.
루트 노드와 연결해야 합니다.
워크플로 실행 사용
Chat Trigger에 대한 모든 메시지는 당신의 워크플로를 실행합니다. 즉, 사용자가 10개의 메시지를 보내는 1개의 대화는 실행 허용량에서 10개의 실행을 사용합니다. 허용량에 대한 세부정보는 요금제를 확인하세요.
수동 채팅 트리거
이 노드는 버전 1.24.0부터 수동 채팅 트리거 노드를 대체합니다.
노드 매개변수#
채팅을 공개적으로 접근 가능하게 설정#
채팅이 공개적으로 접근 가능해야 하는지(켜짐) 아니면 수동 채팅 인터페이스를 통해서만 접근 가능해야 하는지(꺼짐) 설정합니다.
워크플로를 구축하는 동안 이 옵션을 꺼두세요. 워크플로를 활성화하고 사용자가 채팅에 접근할 수 있도록 할 준비가 되었을 때 켭니다.
모드#
사용자가 채팅에 접근하는 방법을 선택합니다. 다음 중에서 선택하세요:
- 호스팅 챗: n8n의 호스팅 챗 인터페이스를 사용합니다. 이 옵션은 인터페이스를 노드 옵션으로 구성할 수 있어 대부분의 사용자에게 권장됩니다. 추가 설정이 필요하지 않습니다.
- 임베디드 챗: 이 옵션은 사용자가 자신의 챗 인터페이스를 생성해야 합니다. n8n의 챗 위젯을 사용하거나 자신만의 것을 만들 수 있습니다. 사용자 챗 인터페이스는 노드의 Chat URL에 표시된 웹훅 URL을 호출해야 합니다.
인증#
채팅에 대한 접근을 제한할 것인지 및 어떻게 제한할 것인지 선택합니다. 다음 중에서 선택하세요:
- 없음: 채팅은 인증을 사용하지 않습니다. 누구나 채팅을 사용할 수 있습니다.
- 기본 인증: 채팅은 기본 인증을 사용합니다.
- 사용자 이름과 비밀번호로 기본 인증용 자격 증명을 선택하거나 생성하세요. 모든 사용자는 동일한 사용자 이름과 비밀번호를 사용해야 합니다.
- n8n 사용자 인증: n8n 계정에 로그인한 사용자만 채팅을 사용할 수 있습니다.
초기 메시지#
이 매개변수는 호스팅 챗을 사용하는 경우에만 사용할 수 있습니다. 사용자가 페이지에 도착했을 때 n8n 챗 인터페이스가 표시할 메시지를 구성하는 데 사용합니다.
노드 옵션#
사용 가능한 옵션은 챗 모드에 따라 다릅니다.
호스팅 챗 옵션#
허용된 출처 (CORS)#
채팅 URL에 접근할 수 있는 출처를 설정합니다. 교차 출처 비사전 요청에 대해 허용된 URL의 쉼표로 구분된 목록을 입력합니다.
모든 출처를 허용하려면 * (기본값)를 사용합니다.
입력 자리 표시자, 제목 및 부제목#
챗 인터페이스에서 이 요소의 텍스트를 입력합니다.
스크린샷 보기
이전 세션 로드#
이전 채팅 세션의 채팅 메시지를 로드할지 선택합니다.
끄기 이외의 옵션을 선택하면, Chat trigger와 사용 중인 에이전트를 메모리 서브 노드에 연결해야 합니다. Chat trigger에서 이전 세션 로드를 메모리에서로 설정할 때 메모리 커넥터가 나타납니다. n8n은 Chat trigger와 에이전트 둘 다 동일한 메모리 서브 노드에 연결하는 것을 권장합니다. 이렇게 하면 두 노드의 진실 단일 출처를 보장합니다.
스크린샷 보기
응답 모드#
에이전트 또는 체인이 채팅을 처리하는 후속 단계로 워크플로를 구축할 때 이 옵션을 사용하세요. 선택할 수 있는 항목은 다음과 같습니다:
- 마지막 노드가 종료될 때: Chat Trigger 노드는 워크플로 내에서 실행된 마지막 노드의 응답 코드와 데이터 출력을 반환합니다.
- 'Webhook에 응답하기' 노드 사용: Chat Trigger 노드는 Webhook에 응답하기 노드에 정의된 대로 응답합니다.
채팅 시작을 위한 버튼 클릭 필요#
채팅 인터페이스에 새 대화 버튼을 표시할지(켜짐) 여부를 설정합니다(꺼짐).
스크린샷 보기
임베디드 채팅 옵션#
허용된 출처 (CORS)#
채팅 URL에 접근할 수 있는 출처를 설정합니다. 크로스 오리진 비사전 요청을 허용하는 URL의 쉼표로 구분된 목록을 입력합니다.
*(기본값)를 사용하여 모든 출처를 허용합니다.
이전 세션 로드하기#
이전 채팅 세션에서 채팅 메시지를 로드할지 선택합니다.
끄기 이외의 옵션을 선택하면, 사용 중인 Chat trigger와 에이전트를 메모리 서브 노드에 연결해야 합니다. 이전 세션 로드하기를 메모리에서로 설정하면 Chat trigger에서 메모리 커넥터가 나타납니다. n8n은 Chat trigger와 에이전트를 동일한 메모리 서브 노드에 연결할 것을 권장합니다. 이는 두 노드 모두에 대한 단일 데이터 소스를 보장합니다.
스크린샷 보기
응답 모드#
에이전트 또는 체인이 채팅을 처리하는 후속 단계로 워크플로를 구축할 때 이 옵션을 사용하세요. 선택할 수 있는 항목은 다음과 같습니다:
- 마지막 노드가 종료될 때: Chat Trigger 노드는 워크플로 내에서 실행된 마지막 노드의 응답 코드와 데이터 출력을 반환합니다.
- 'Webhook에 응답하기' 노드 사용: Chat Trigger 노드는 Webhook에 응답하기 노드에 정의된 대로 응답합니다.
템플릿 및 예시#
관련 자료#
n8n의 고급 AI(Advanced AI) 문서를 확인하세요.
채팅 응답을 수동으로 설정하기#
에이전트 또는 체인 노드의 출력을 사용자에게 직접 전송하지 않으려는 경우 채팅 응답을 수동으로 설정해야 합니다. 대신, 에이전트 또는 체인 노드의 출력을 가져와서 수정하거나 사용자에게 되돌려 보내기 전에 다른 작업을 수행하고자 합니다.
기본 워크플로에서는 에이전트 및 체인 노드가 output 또는 text라는 파라미터를 출력하며, Chat trigger는 이 파라미터의 값을 사용자에게 채팅 응답으로 전송합니다.
사용자에게 전송할 응답을 수동으로 생성해야 하는 경우, text 또는 output이라는 이름의 파라미터를 생성해야 합니다. 다른 파라미터 이름을 사용하는 경우, Chat trigger는 전체 객체를 응답으로 전송하며 값만 전송하지 않습니다.
일반적인 문제#
일반적인 질문이나 문제 및 제안된 솔루션에 대해서는 일반 문제를 참조하세요.