핵심 개념¶
w5w 플랫폼을 효과적으로 활용하기 위해 알아야 할 핵심 개념들을 설명합니다.
워크플로우(Workflow)¶
워크플로우는 자동화할 업무 흐름을 정의한 것입니다. 여러 노드를 연결하여 데이터가 흘러가는 파이프라인을 구성합니다.
- 하나의 트리거로 시작합니다.
- 노드 간 엣지(Edge)로 실행 순서를 정의합니다.
- 이전 노드의 출력을 다음 노드의 입력으로 변수를 통해 전달합니다.
- 조건 분기, 반복, 분류 등의 흐름 제어가 가능합니다.
노드(Node)¶
노드는 워크플로우의 개별 작업 단위입니다. w5w는 9가지 노드 타입을 제공합니다.
| 노드 타입 | 아이콘 | 설명 | 상세 |
|---|---|---|---|
| 트리거(Trigger) | 워크플로우의 시작점 | 가이드 | |
| AI 에이전트(Agent) | LLM 기반 AI가 스킬을 활용하여 작업 수행 | 가이드 | |
| 스킬(Skill) | 이메일 전송, DB 조회 등 단일 기능 직접 실행 | 가이드 | |
| 조건(Condition) | IF/ELSE 분기로 데이터에 따라 다른 경로 실행 | - | |
| 텍스트 분류(Text Classifier) | AI가 텍스트를 사전 정의된 카테고리로 분류 | - | |
| 반복(Iterator) | 배열 데이터를 순회하며 각 항목에 대해 하위 노드 실행 | - | |
| 파일 검색(File Search) | 업로드된 지식 베이스에서 관련 문서를 검색 (RAG) | - | |
| 응답(Response) | 웹훅 트리거의 HTTP 응답을 정의 | - | |
| 메모(Memo) | 워크플로우 내 메모/주석 (실행에 영향 없음) | - |
트리거(Trigger)¶
트리거는 워크플로우를 실행시키는 조건을 정의합니다. 모든 워크플로우는 반드시 하나의 트리거를 가집니다.
| 트리거 타입 | 설명 | 예시 |
|---|---|---|
| 수동(Manual) | 사용자가 직접 실행 | 테스트, 일회성 작업 |
| 스케줄(Scheduled) | Cron 표현식으로 주기적 실행 | 매일 오전 9시 보고서 생성 |
| 웹훅(Webhook) | 외부 HTTP 요청으로 실행 | 결제 시스템 알림 수신 |
| 앱 이벤트(App Event) | 외부 서비스의 이벤트 감지 | Gmail 새 메일 수신 시 실행 |
지원하는 앱 이벤트¶
| 서비스 | 감지 방식 | 트리거 조건 |
|---|---|---|
| Gmail | 폴링 (60초 간격) | 새 이메일 수신 |
| Google Sheets | 폴링 | 스프레드시트 변경 |
| Google Drive | 폴링 | 파일 추가/수정 |
| Telegram | 웹훅 (실시간) | 봇 메시지 수신 |
자세한 내용은 트리거 노드 가이드를 참고하세요.
에이전트(Agent)¶
에이전트는 LLM(대규모 언어 모델)을 활용하여 자율적으로 작업을 수행하는 AI 단위입니다.
구성 요소¶
| 구성 요소 | 설명 |
|---|---|
| LLM 모델 | AI 제공자와 모델 선택 (GPT-5-mini, Claude 4.5 Haiku 등) |
| 시스템 프롬프트 | 에이전트의 역할, 행동 규칙, 출력 형식 정의 |
| 입력 프롬프트 | 실행 시 에이전트에게 전달할 지시사항 (변수 참조 가능) |
| 스킬 | 에이전트가 사용할 수 있는 도구 (이메일, DB 등) |
지원 LLM 모델¶
| 제공자 | 기본 모델 | 특징 |
|---|---|---|
| OpenAI | GPT-5-mini | 빠르고 경제적 |
| Anthropic | Claude 4.5 Haiku | 빠른 응답, 한국어 우수 |
| Gemini 2.5 Flash | 빠른 처리 | |
| xAI | Grok 4 Fast | 빠른 추론 |
자세한 내용은 AI 에이전트 노드 가이드를 참고하세요.
스킬(Skill)¶
스킬은 에이전트 또는 스킬 노드가 실행할 수 있는 개별 기능입니다. 30개 이상의 내장 스킬을 제공합니다.
| 카테고리 | 주요 스킬 | 필요 인증 |
|---|---|---|
| 이메일 | 전송, 수신, 검색, 삭제, 이동, 읽음 처리 | SMTP / IMAP |
| 커뮤니케이션 | Telegram 메시지·문서·사진 전송, SMS 전송 | Telegram Bot / 문자콕 API |
| HTTP | GET, POST, PUT, PATCH, DELETE 요청 | API Key (선택) |
| 데이터베이스 | 조회, 쓰기, 삭제, 스키마 조회 | Database |
| 파일 | 읽기, 쓰기, PDF 추출, 템플릿 내보내기 | - |
| 데이터 처리 | 분석, 분류, 조인, 수식, 필터, 컬럼 변환 | - |
자세한 내용은 스킬 노드 가이드를 참고하세요.
변수(Variable)¶
변수 시스템을 통해 노드 간에 데이터를 전달합니다.
변수 참조 형식¶
자주 사용하는 패턴¶
| 참조 | 설명 |
|---|---|
{{ $('trigger').data_content.email }} |
트리거 입력의 이메일 필드 |
{{ $('agent_1').text_content }} |
에이전트가 생성한 텍스트 |
{{ $('skill_1').data_content.result }} |
스킬 실행 결과 |
{{ $('skill_1').data_content.results[0].name }} |
배열의 첫 항목 |
변수 셀렉터¶
에디터에서 {{를 입력하면 변수 셀렉터 UI가 나타나 이전 노드의 출력을 시각적으로 선택할 수 있습니다.
자세한 내용은 변수 시스템 가이드를 참고하세요.
인증 정보(Credential)¶
외부 서비스 연동에 필요한 인증 정보를 안전하게 관리합니다. 프로젝트 단위로 관리되며 워크플로우 간에 공유할 수 있습니다.
| 인증 타입 | 용도 | 필요 필드 |
|---|---|---|
| SMTP | 이메일 전송 | host, port, username, password |
| IMAP | 이메일 수신 | host, port, username, password |
| Google OAuth | Gmail, Drive, Sheets 연동 | OAuth 플로우 (자동) |
| Telegram Bot | Telegram 봇 메시지 | bot_token |
| Database | 외부 DB 연결 | driver, host, database, username, password |
| API Key | 범용 API 인증 | api_key |
다음 단계¶
- 첫 워크플로우 만들기 — 실용적인 워크플로우를 단계별로 만들어봅니다.
- 에디터 가이드 — 에디터 사용법을 자세히 알아봅니다.





