[1:1 케어] n8n 에이전트 응급실: 증상별 처방전 |가나투데이
[1:1 케어] n8n 에이전트 응급실: 증상별 처방전 |가나투데이
에이전트 설계 과정에서 발생하는 문제는 대부분 신호(Signal)의 단절이나 해석(Mapping)의 오류에서 기인합니다. 실제 실습 중 가장 빈번하게 발생하는 3대 핵심 장애를 기준으로 트러블슈팅 가이드를 구성했습니다.
지금 겪고 계신 증상이 어디에 해당하는지 스캔해 보세요.
증상 1: "분명히 연결했는데 다음 노드가 실행되지 않아요"
원인 분석: 앞선 노드에서 전달된 아이템(Item)이 0개일 가능성이 99%입니다. n8n의 신경계는 흐를 피(데이터)가 없으면 동작을 멈춥니다.
진단 방법:
1. 트리거 노드와 멈춘 노드 사이의 화살표 위 숫자를 확인하세요.
2. 0 Items라고 적혀 있다면, 앞 노드의 필터링 조건이 너무 까다롭거나 원본 데이터가 비어 있는 것입니다.해결책:
- 만약 데이터가 없어도 다음 단계를 강제 실행해야 한다면, 노드 설정의
Continue on Fail옵션을 고려해야 합니다. - 트리거 노드의 설정을 확인하여 데이터가 실제로 유입되는지 테스트(Test Step)를 다시 진행하세요.
증상 2: "메시지에 데이터 대신 {{ $json... }} 글자 그대로 나와요"
원인 분석: 에이전트가 해당 필드 주소를 실제 값으로 치환(Mapping)하지 못하고 단순 텍스트로 인식한 상태입니다.
진단 방법: 1. 해당 노드의 설정 창 왼쪽에 있는
Input패널에 데이터가 실제로 들어와 있는지 확인하세요. 2. 데이터 구조가 바뀌어 주소값이 달라졌을 수 있습니다. (예:$json.name인데 실제로는$json.user_name인 경우)해결책: 기존에 직접 타이핑한 괄호를 지우고, 왼쪽
Input패널에 있는 항목을 다시 드래그 앤 드롭 하세요. 에이전트에게 최신 데이터 경로를 다시 가르쳐 주는 과정입니다.
증상 3: "실행은 성공했는데 디스코드(또는 목적지)에 아무것도 안 와요"
원인 분석: 에이전트가 신호는 보냈으나, 목적지에서 거절(Authentication/Permission)당한 경우입니다.
진단 방법:
Executions탭에서 해당 노드를 클릭한 뒤Output이 아닌Error나Response내용을 확인하세요.해결책: 자격 증명(Credentials) 설정으로 들어가 API 키나 웹훅 URL이 정확한지 재점검하세요.
디스코드 채널의 권한 설정에서 에이전트(봇)가 '메시지 보내기' 권한을 가지고 있는지 확인해야 합니다.
실시간 트러블슈팅을 위한 '현장 브리핑'
위의 일반적인 케이스로 해결되지 않는다면, 현재 어떤 노드에서 어떤 에러 메시지가 뜨는지 아래 양식처럼 알려주세요. 제가 즉시 내부 로직을 분석해 처방을 내리겠습니다.
1. 문제가 발생한 노드: (예: Discord Send Message 노드)
2. 확인된 에러 메시지: (예: 403 Forbidden 혹은 No items found)
3. 원하는 결과: (예: 구글 폼 응답 내용을 메시지로 받고 싶음)
#가나 투데이 #ganatoday
그린아프로
