템플릿 제출 가이드라인
n8n v2.47요약
실제 문제를 해결하고, 가져온 뒤에도 동작하며, 다른 사람이 사용하는 데 필요한 안내를 포함한 독창적인 워크플로를 제출합니다. 구체적인 대상 사용자와 결과를 선택합니다. 만들기 전에 템플릿 라이브러리를 검색합니다. 템플릿은 누군가의 작업을 덜어 줄 만큼 충분한 내용이 있어야 합니다.
실제 문제를 해결하고, 가져온 뒤에도 동작하며, 다른 사람이 사용하는 데 필요한 안내를 포함한 독창적인 워크플로를 제출합니다.
유용한 문제 해결하기#
구체적인 대상 사용자와 결과를 선택합니다. 템플릿이 처리하는 작업과 그 결과가 누군가에게 도움이 되는 이유를 설명합니다.
만들기 전에 템플릿 라이브러리를 검색합니다. 제출하는 템플릿은 빈틈을 메우거나 기존 접근 방식을 의미 있게 개선해야 합니다.
템플릿은 누군가의 작업을 덜어 줄 만큼 충분한 내용이 있어야 합니다. 트리거 하나에 액션 하나를 연결한 것, 기본 챗봇, 단독 API 요청은 자격을 갖추려면 더 많은 맥락이나 재사용 가능한 로직이 필요합니다. 데이터 처리, 판단, 설정까지 갖춘 완성된 솔루션으로 사용 사례를 발전시킵니다.
예를 들어 리드 접수 템플릿은 필수 필드를 확인하고, 기존 연락처와 대조하고, 적격 리드를 분류하여 전달하고, 불완전한 레코드가 어떻게 처리되는지 설명할 수 있습니다.
설계는 문제가 허용하는 한 단순하게 유지합니다. 노드를 더 추가한다고 해서 템플릿이 더 유용해지지는 않습니다. 특정 문제를 잘 처리하고 재사용 가능한 로직이나 지식을 제공한다면 간결한 워크플로도 자격을 갖출 수 있습니다.
AI 지원 제출물 검토하기#
AI의 도움을 받은 작업도 제출할 수 있습니다
AI가 생성한 워크플로, 코드, 표현식, 설정 안내는 직접 검토하고 테스트했다면 환영합니다. 제출하기 전에 워크플로가 어떻게 동작하는지 이해하고, 그 내용이 사실인지 확인해야 합니다.
제출하기 전에 생성된 콘텐츠를 검토합니다.
- 모든 노드, 표현식, 코드 스니펫, API 엔드포인트, 의존성을 확인합니다. 존재하지 않거나 지원되지 않는 설정은 교체합니다.
- 대표적인 입력으로 워크플로를 실행합니다. AI 응답을 포함한 출력이 정확하고 유용한지 확인합니다.
- 설정 안내가 워크플로와 일치하도록 맞춥니다. 존재하지 않는 기능, 지원되지 않는 주장, 일반적인 군더더기, 해당되지 않는 안내는 제거합니다.
- 링크, 맞춤법, 서식을 확인합니다. 템플릿을 설정하거나 사용하는 데 도움이 되지 않으면서 정보만 반복하는 텍스트는 다시 작성합니다.
검토하지 않은 AI 출력, 거의 동일한 워크플로의 묶음, 이름·프롬프트·앱 선택만 바꾼 일반적인 예시는 제출하지 않습니다. 이런 제출물은 성의가 부족한 제출물로 간주되며 품질 요구 사항을 충족하지 않습니다.
독창적인 작업 제출하기#
직접 템플릿을 만듭니다. 다른 사람의 워크플로를 복사하거나, 다시 게시하거나, 재판매하지 않습니다. 표절은 계정 정지로 이어집니다.
기존 접근 방식을 바탕으로 만든다면 자신이 기여한 부분을 설명하고 원저작자의 라이선스와 권한을 존중합니다.
워크플로를 이해하기 쉽게 만들기#
- 노드 이름을 Find existing contact나 Route incomplete submissions처럼 목적을 설명하는 이름으로 바꿉니다.
- 실행 경로를 따라가기 쉽도록 노드를 배치합니다.
- 스티키 노트 가이드라인을 따릅니다. 개요 노트 하나와 필요한 곳에 섹션 노트를 포함합니다.
- 바꿔야 하는 값은 가능한 경우 Edit Fields (Set) 노드에 모읍니다. 각 값을 설명하고 명확한 플레이스홀더를 사용합니다.
- 필요한 자격 증명, 권한, 외부 리소스, 서브 워크플로나 커뮤니티 노드 같은 의존성을 문서화합니다.
- 사용 사례에 필요한 오류 처리를 포함합니다. 수동 조치가 필요한 제한 사항이나 실패 상황은 설명합니다.
n8n을 처음 접하는 사람일 수 있다고 가정합니다. 필수 안내는 템플릿에 함께 둡니다. 자세한 설정 가이드를 링크하거나 보충 자료로 안내 영상을 추가할 수 있습니다.
비밀 정보와 개인 데이터 제거하기#
인증에는 n8n 자격 증명을 사용합니다. API 키, 토큰, 비밀번호, 인증 헤더를 노드 파라미터, 코드, 표현식, 노트에 직접 넣지 않습니다.
제출하기 전에 내보낸 JSON을 검토합니다. 본인 계정을 식별할 수 있는 자격 증명 이름과 ID, 개인 이메일 주소, 채팅 ID, 스프레드시트 ID, 웹훅 URL, 기타 비공개 리소스 식별자를 제거합니다. 설정 가능한 리소스 값은 플레이스홀더로 바꾸고 설정 방법을 설명합니다.
민감한 샘플 데이터와 고정(pinned)된 실행 데이터를 제거합니다. 워크플로에 예시 입력이 필요하다면 예상되는 구조를 보여 주는 합성 데이터를 포함합니다.
제출 전에 템플릿 테스트하기#
제출하려는 JSON 파일 그대로 테스트합니다. 원래 인스턴스에서만 동작하는 워크플로는 공유할 준비가 된 것이 아닙니다.
- 워크플로를 내보내고 새 워크플로로 가져옵니다.
- 작성한 설정 안내를 따릅니다. 원래 워크플로에만 존재하는 리소스에 의존하지 않고 자격 증명을 구성하고 플레이스홀더를 교체합니다.
- 대표적인 입력으로 전체 워크플로를 실행합니다. 실행 상태만 보지 말고 대상 서비스에서 최종 결과를 확인합니다.
- 문서화한 각 분기를 실행해 봅니다. 해당되는 경우 입력이 없거나 비어 있는 경우, 여러 레코드, 서비스 호출 실패를 테스트합니다.
- 반복 실행을 확인합니다. 워크플로가 레코드를 생성하거나 알림을 보낸다면 중복 처리 방식을 검증하거나, 반복이 발생할 수 있는 경우를 설명합니다.
- 고정된 데이터, 누락된 서브 워크플로, 로컬 파일, 문서화되지 않은 리소스에 의존하지 않는지 확인합니다.
- AI 워크플로의 경우 다양한 입력을 시도하고 응답을 검토합니다. 다운스트림 노드가 출력 형식과 예상되는 실패 사례를 처리하는지 확인합니다.
- 스티키 노트, 스크린샷, 설정 링크가 테스트한 워크플로와 일치하는지 확인합니다.
워크플로가 특정 버전에 따른 동작에 의존한다면 테스트한 n8n 릴리즈를 명시합니다. 필요한 노드 또는 패키지 버전과 플랫폼 제한 사항을 문서화합니다. 확인하지 않은 호환성을 주장하지 않습니다.
커뮤니티 노드가 포함된 템플릿#
각 커뮤니티 노드 패키지의 이름을 명시하고, 테스트한 버전을 문서화하며, 설치 안내 링크를 제공합니다.
검증된 커뮤니티 노드는 n8n Cloud와 셀프 호스팅 인스턴스에서 사용할 수 있습니다. 검증되지 않은 커뮤니티 노드는 셀프 호스팅이 필요합니다. 해당 패키지를 확인하고 지원되는 설정을 설명합니다. 커뮤니티 노드 설치를 참조합니다.
커뮤니티 노드를 사용하는 워크플로에는 미리보기가 렌더링되지 않더라도 워크플로를 확인할 수 있도록 워크플로 이미지를 포함합니다. 설정 안내도 텍스트로 함께 포함합니다.
제출 체크리스트#
템플릿을 제출하기 전에 다음을 확인합니다.
- 실제 문제를 해결하며 라이브러리에 가치를 더합니다.
- 직접 만든 작업이며, AI가 생성한 콘텐츠를 검토했습니다.
- 내보낸 JSON이 문서화된 설정 단계에 따라 가져온 뒤 동작합니다.
- 예상 출력과 관련된 실패 사례를 확인했습니다.
- 비밀 정보, 비공개 식별자, 민감한 데이터를 제거했습니다.
- 노드에 설명적인 이름이 있고 필수 스티키 노트가 있습니다.
- 워크플로의 스티키 노트에 요구 사항, 설정 단계, 동작, 제한 사항이 명시되어 있습니다.