용어 및 명명 규칙
n8n v2.42요약
이 페이지는 스타일 가이드의 보완 문서입니다. n8n Docs는 모든 페이지에서 같은 개념에 같은 용어를 사용하고, 그럴듯한 동의어보다 공식 제품 용어를 우선하는 것을 목표로 합니다. n8n 인터페이스는 때때로 자격 증명의 인증 링크를 "connection"으로 표시합니다(예: 비공개 자격 증명의 공유 메시지).
이 페이지는 스타일 가이드의 보완 문서입니다. 스타일 가이드는 작성 스타일, 서식, 구조를 다루고, 이 페이지는 제품 용어의 단일 진실 공급원(Single Source Of Truth, SSOT)입니다.
n8n Docs는 모든 페이지에서 같은 개념에 같은 용어를 사용하고, 그럴듯한 동의어보다 공식 제품 용어를 우선하는 것을 목표로 합니다. 일관된 용어는 독자에게 도움이 될 뿐 아니라, AI 도구(검색, 문서 어시스턴트, 코딩 에이전트)가 문서를 찾고 활용하는 방식을 직접적으로 개선합니다.
대소문자 표기#
- 본문에서는 문장체(sentence case)를 사용하세요: "Add a trigger node", "create a sub-workflow".
- 실제 UI 라벨이나 노드 이름을 표기할 때는 제품에 표시되는 정확한 대소문자 그대로 볼드체로 표기하세요: "Select Add trigger", "the HTTP Request node". 인터페이스에 표시되는 그대로 일치시키세요.
- 제품명은 항상 소문자
n8n으로 표기하세요. 문장의 시작이라도 예외 없습니다.
핵심 개념#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| workflow | flow, automation(전체를 가리키는 명사로), scenario, pipeline, zap |
| node | step, block, action, module |
| execution(워크플로의 1회 실행) | run(명사로), job, invocation |
워크플로 수명 주기#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| publish, unpublish a workflow; published workflow | activate, deactivate, enable, disable, turn on, go live, deploy |
| run, execute a workflow(동사로) | kick off, fire |
| pin data; pinned data | mock data, freeze data, lock data, sample data |
노드#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| app node | integration node, service node |
| core node | system node |
| cluster node; root node; sub-node | parent node, child node, super node |
| community node(설치 가능, 커뮤니티가 게시) | custom node, third-party node, plugin, add-on |
| Execute Sub-workflow Trigger node; Execute Sub-workflow node | Execute Workflow Trigger node, Execute Workflow node(더 이상 사용하지 않는 이름) |
| AI Agent node | Agent node(단독으로) |
자격 증명과 연결#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| credential(서비스의 인증 세부 정보를 저장) | connection(자격 증명의 동의어로) |
| connection(캔버스에서 두 노드 사이의 연결) | wire, link |
n8n 인터페이스는 때때로 자격 증명의 인증 링크를 "connection"으로 표시합니다(예: 비공개 자격 증명의 공유 메시지). 문서에서는 두 용어를 구분해 사용하세요. credential은 서비스에 인증하는 것이고, connection은 캔버스에서 노드를 연결하는 것입니다.
캔버스와 편집기#
대소문자 규칙은 두 가지입니다. 용어는 선택/클릭/열기 지시의 직접적인 대상일 때만 볼드로 표기하고, 위치를 가리킬 뿐일 때는 볼드로 표기하지 않습니다. 정의된 요소의 이름은 첫 단어만 대문자로 시작합니다(예: "Workflow menu"이며 "Workflow Menu"가 아닙니다).
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| canvas | editor board, diagram, workspace, graph |
| sticky note | comment, annotation, label, memo |
| sub-workflow | subworkflow, sub workflow, subflow, child workflow, nested workflow |
| left menu(Overview, Projects, Favorites 등을 포함하는 앱 전체의 왼쪽 탐색) | sidebar, left sidebar, navigation menu, main menu |
| Canvas header(프로젝트/워크플로 이름, Workflow menu, 편집기/실행/평가 전환, Publish를 포함하는 캔버스 상단 표시줄) | top navigation bar, top menu |
| Workflow menu(Canvas header에 있는 가로 ⋯ 아이콘) | three dots icon, the three dots, Options(세로 아이콘 전용으로 예약됨) |
| Options menu(세로 ⋮ 아이콘, 캔버스 요소가 아닌 행/항목별 메뉴) | three-dot menu(방향이 모호함), three dots menu |
| Nodes panel(캔버스의 + 버튼에서 열림) | Node Panel(대문자 단수형), add node menu, "What happens next?" panel |
| Node details view(노드를 더블 클릭하면 열림) | node editor view, NDV(먼저 정의하지 않은 경우) |
| input panel; output panel(Node details view의 측면 창) | Input panel/Output panel(대문자), INPUT/OUTPUT pane |
| Logs panel(캔버스 하단) | bottom panel, bottom menu, canvas footer |
+Workflow menu 아이콘은 three-dots-horizontal.png이고, Options menu 아이콘은 three-dot-options-menu.png입니다. 이 메뉴를 언급할 때 인라인으로 사용하세요. 인라인 아이콘의 서식은 스타일 가이드를 참고하세요.
AI와 에이전트#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| sub-agent | subagent, child agent |
n8n에는 워크플로 구축을 위한 서로 다른 AI 기반 기능이 여러 개 있습니다. 각각은 일반적인 설명이 아니라 특정 n8n 제품 이름이므로 서로 바꿔 쓰지 마세요.
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| n8n Assistant(채팅 기반 에이전트: 워크플로와 에이전트를 만들고, 편집하고, 테스트하고, 게시함) | assistant, the AI, chatbot, AI Assistant |
| AI Workflow Builder(레거시, 프롬프트로 단일 워크플로를 생성하고 개선함) | workflow builder, builder |
| Ask n8n AI(레거시 도움말 어시스턴트, 더 이상 적극적으로 개발되지 않음, 독자를 AI Assistant로 안내) | AI assistant(이것의 동의어로), help assistant |
기능 성숙도#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| Preview(기능의 성숙도 라벨, 첫 글자 대문자) | beta, alpha, early access |
플랫폼과 배포#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| self-hosted | self hosted, on-premise, on-premises, on-prem |
| n8n Cloud | Cloud, hosted version, SaaS, the cloud, managed n8n |
| instance(실행 중인 n8n 시스템) | server, box, deployment(실행 중인 시스템을 가리키는 명사로) |
| Enterprise(요금제) | enterprise edition, premium, paid tier |
"Deployment"가 완전히 금지된 것은 아닙니다. 배포 행위("deployment methods", "the deployment finishes")와 쿠버네티스 Deployment 리소스를 가리킬 때는 올바른 표현입니다. 실행 중인 n8n 시스템 자체를 가리키는 명사로 쓰였을 때만 "instance"로 바꾸세요.
요금제와 등급#
다음의 정확한 대문자 요금제 이름을 낮은 등급부터 높은 등급 순으로 사용하세요. 다른 이름을 임의로 만들지 마세요(예: "professional plan", "team tier").
- n8n Cloud: Starter, Pro, Enterprise
- Self-hosted: Community, Registered Community, Business, Enterprise
모든 등급을 한꺼번에 가리킬 때는 등급을 나열하지 말고 "All plans" 또는 "All editions"라고 쓰세요.
기능#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| project | workspace, team space |
| folder | directory(앱 내에서), group |
| environment variable | env(명사로), config var |
| data table | database table, datatable, the table feature |
제품 및 브랜드 이름#
| 사용할 용어 | 사용하지 않을 용어 |
|---|---|
| n8n(항상 소문자) | N8n, N8N, n8N |
| GitHub, npm, JavaScript, OAuth2 | Github, NPM, Javascript, oAuth |