콘텐츠로 이동

핵심 개념

w5w 플랫폼을 효과적으로 활용하기 위해 알아야 할 핵심 개념들을 설명합니다.


워크플로우(Workflow)

워크플로우는 자동화할 업무 흐름을 정의한 것입니다. 여러 노드를 연결하여 데이터가 흘러가는 파이프라인을 구성합니다.

워크플로우 전체 구조 예시 — 트리거에서 시작하여 여러 노드가 연결된 모습

  • 하나의 트리거로 시작합니다.
  • 노드 간 엣지(Edge)로 실행 순서를 정의합니다.
  • 이전 노드의 출력을 다음 노드의 입력으로 변수를 통해 전달합니다.
  • 조건 분기, 반복, 분류 등의 흐름 제어가 가능합니다.

워크플로우 흐름 예시 — 트리거 → AI 에이전트 → 조건 분기


노드(Node)

노드는 워크플로우의 개별 작업 단위입니다. w5w는 9가지 노드 타입을 제공합니다.

노드 타입 아이콘 설명 상세
트리거(Trigger) 워크플로우의 시작점 가이드
AI 에이전트(Agent) LLM 기반 AI가 스킬을 활용하여 작업 수행 가이드
스킬(Skill) 이메일 전송, DB 조회 등 단일 기능 직접 실행 가이드
조건(Condition) IF/ELSE 분기로 데이터에 따라 다른 경로 실행 -
텍스트 분류(Text Classifier) AI가 텍스트를 사전 정의된 카테고리로 분류 -
반복(Iterator) 배열 데이터를 순회하며 각 항목에 대해 하위 노드 실행 -
파일 검색(File Search) 업로드된 지식 베이스에서 관련 문서를 검색 (RAG) -
응답(Response) 웹훅 트리거의 HTTP 응답을 정의 -
메모(Memo) 워크플로우 내 메모/주석 (실행에 영향 없음) -

에디터에서 노드를 추가하는 메뉴 — 9가지 노드 타입 목록


트리거(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 빠른 응답, 한국어 우수
Google Gemini 2.5 Flash 빠른 처리
xAI Grok 4 Fast 빠른 추론

AI 에이전트 설정 패널 — 모델 선택, 시스템 프롬프트, 스킬 할당

자세한 내용은 AI 에이전트 노드 가이드를 참고하세요.


스킬(Skill)

스킬은 에이전트 또는 스킬 노드가 실행할 수 있는 개별 기능입니다. 30개 이상의 내장 스킬을 제공합니다.

카테고리 주요 스킬 필요 인증
이메일 전송, 수신, 검색, 삭제, 이동, 읽음 처리 SMTP / IMAP
커뮤니케이션 Telegram 메시지·문서·사진 전송, SMS 전송 Telegram Bot / 문자콕 API
HTTP GET, POST, PUT, PATCH, DELETE 요청 API Key (선택)
데이터베이스 조회, 쓰기, 삭제, 스키마 조회 Database
파일 읽기, 쓰기, PDF 추출, 템플릿 내보내기 -
데이터 처리 분석, 분류, 조인, 수식, 필터, 컬럼 변환 -

자세한 내용은 스킬 노드 가이드를 참고하세요.


변수(Variable)

변수 시스템을 통해 노드 간에 데이터를 전달합니다.

변수 참조 형식

{{ $('노드_ID').속성.경로 }}

자주 사용하는 패턴

참조 설명
{{ $('trigger').data_content.email }} 트리거 입력의 이메일 필드
{{ $('agent_1').text_content }} 에이전트가 생성한 텍스트
{{ $('skill_1').data_content.result }} 스킬 실행 결과
{{ $('skill_1').data_content.results[0].name }} 배열의 첫 항목

변수 셀렉터

에디터에서 {{를 입력하면 변수 셀렉터 UI가 나타나 이전 노드의 출력을 시각적으로 선택할 수 있습니다.

변수 셀렉터 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

인증 정보 관리 화면 — 등록된 인증 목록


다음 단계