Chat Trigger 노드와 함께 Chat 노드를 사용하면 채팅으로 메시지를 전송하고, 선택적으로 사용자의 응답을 기다릴 수 있습니다. 이를 통해 채팅 워크플로에서 사람이 개입하는(human-in-the-loop, HITL) 사용 사례를 구현할 수 있으며, 하나의 실행 내에서 여러 번 채팅으로 상호작용할 수 있습니다. Chat 노드는 AI 에이전트용 도구로도 작동합니다.

노드 매개변수#

다음 매개변수를 사용하여 이 노드를 설정합니다.

작업#

Chat 노드는 다음 작업(operation)을 지원합니다.

• Send Message: 채팅으로 메시지를 전송합니다. 메시지 전송 직후 워크플로 실행이 계속됩니다.
• Send and Wait for Response: 채팅으로 메시지를 전송하고 사용자의 응답을 기다립니다. 이 작업은 사용자가 응답을 제출할 때까지 워크플로 실행을 일시 중지합니다.

Send and Wait for Response를 선택하면 응답 대기에서 설명하는 추가 매개변수와 옵션이 활성화됩니다.

메시지#

채팅으로 전송할 메시지입니다. 이 매개변수는 두 작업 모두에서 사용할 수 있습니다.

노드 옵션#

다음 Options를 사용하여 노드의 동작을 더 세부적으로 조정할 수 있습니다.

메모리 입력 연결 추가#

Chat 노드의 메시지를 연결된 메모리에 커밋할지 여부를 선택합니다. 에이전트 또는 체인 루트 노드와 Chat 노드 사이에 공유 메모리를 사용하면 동일한 세션 키가 이러한 메시지에 연결되어 전체 메시지 기록을 캡처할 수 있습니다.

응답 대기#

Send and Wait for Response 작업을 선택하면 메시지를 전송하고 사람이 응답할 때까지 워크플로 실행을 일시 중지할 수 있습니다. 이를 통해 하나의 실행 내에서 여러 차례 대화하거나 승인 워크플로를 구현할 수 있습니다.

Response Type#

다음 응답 유형 중에서 선택할 수 있습니다.

• Free Text: 사용자가 채팅에 원하는 응답을 입력할 수 있습니다. 이전의 "Wait for User Reply" 옵션과 동일하게 동작합니다.
• Approval: 사용자가 메시지에 표시된 인라인 버튼을 사용하여 승인 또는 거부할 수 있습니다. 선택적으로 사용자가 사용자 지정 응답을 입력하도록 허용할 수도 있습니다.

선택한 유형에 따라 사용 가능한 매개변수와 옵션이 달라집니다.

자유 텍스트 매개변수 및 옵션#

Free Text 응답 유형을 사용하면 사용자가 원하는 메시지를 응답으로 입력할 수 있습니다.

사용 사례:

• 개방형 질문(open-ended questions)
• 상세한 피드백 수집
• 특정 정보 요청

Options:

• Limit Wait Time: 지정된 시간 제한 후 워크플로가 실행을 자동으로 재개할지 여부입니다. 특정 시간 간격 또는 특정 시각(wall time)으로 지정할 수 있습니다.

승인 매개변수 및 옵션#

Approval 응답 유형을 사용하면 메시지에 인라인 버튼이 표시되어 사용자가 클릭하여 승인 또는 거부할 수 있습니다. 이 응답 유형은 n8n의 다른 human-in-the-loop(HITL) 노드와 동일한 패턴을 따릅니다.

사용 사례:

• 간단한 예/아니오 결정
• 승인 워크플로
• 확인(confirmation)

Approval 응답 유형을 사용할 경우 다음 매개변수를 사용할 수 있습니다.

• Type of Approval: 승인 버튼만 표시할지, 승인 및 거부 버튼을 모두 표시할지 선택합니다.

  • Approve Only: 승인 버튼 하나만 표시합니다.
  • Approve and Disapprove: 두 버튼을 모두 표시합니다(기본값).

• Approve Button Label: 승인 버튼에 표시할 텍스트입니다. 기본값: Approve

• Disapprove Button Label: 거부 버튼에 표시할 텍스트입니다(Type of Approval이 "Approve and Disapprove"로 설정된 경우에만 표시됩니다). 기본값: Disapprove

• Block User Input: 사용자가 사용자 지정 메시지를 입력하지 못하게 할지(활성화) 또는 응답을 입력하도록 허용할지(비활성화, 기본값) 여부입니다.

  • 비활성화(기본값)인 경우: 사용자는 버튼을 클릭하거나 사용자 지정 메시지를 입력할 수 있습니다. 입력된 메시지는 사용자 지정 메시지가 포함된 거부로 처리됩니다.
  • 활성화된 경우: 사용자는 버튼으로만 상호작용할 수 있습니다.

Approval 응답 유형은 다음 옵션도 제공합니다.

• Limit Wait Time: 지정된 시간 제한 후 워크플로가 실행을 자동으로 재개할지 여부입니다. 특정 시간 간격 또는 특정 시각(wall time)으로 지정할 수 있습니다.

관련 자료#

채팅 인터페이스 설정에 대한 자세한 내용은 Chat Trigger 노드 문서를 참고하세요.

템플릿 및 예제#

n8n 통합 템플릿 둘러보기 또는 모든 템플릿 검색하기

자주 발생하는 문제#

• Chat Trigger 노드의 Mode가 Embedded로 설정된 경우 Chat 노드는 지원되지 않습니다. Embedded 모드에서는 Chat Trigger 노드가 응답 모드로 Respond to Webhook만 제공합니다. 대신 Respond to Webhook 노드를 사용하세요.
• Chat 노드는 서브에이전트(subagent)의 도구로 사용될 때 작동하지 않습니다.
• Chat 노드는 서브 워크플로에서 사용될 때 작동하지 않습니다. 여기에는 AI 에이전트용 도구로 사용되는 서브 워크플로 내에서의 사용도 포함됩니다.
• Chat 노드가 올바르게 작동하려면 Chat Trigger 노드의 Response Mode가 "Using Response Nodes"로 설정되어 있는지 확인하세요.

Chat Trigger 노드에 대한 일반적인 질문이나 문제는 Chat Trigger 노드 일반적인 문제를 참고하세요.