첫 워크플로우 만들기¶

이 튜토리얼에서는 수동 트리거 → AI 에이전트 → 이메일 전송으로 이어지는 실용적인 워크플로우를 단계별로 만들어봅니다.

완성 목표¶

단계	노드	역할
입력	수동 트리거	고객 문의 내용 수신
처리	AI 에이전트	GPT-5-mini로 답변 생성
출력	이메일 전송 스킬	생성된 답변을 이메일로 전송

전제 조건¶

w5w 계정 및 프로젝트
SMTP 인증 정보 등록 (이메일 전송용)

SMTP 인증 정보 등록

아직 등록하지 않았다면 프로젝트 설정 > 인증 정보에서 SMTP를 추가합니다. Gmail의 경우 앱 비밀번호를 사용합니다.

필드	Gmail 예시
Host	`smtp.gmail.com`
Port	`587`
Username	`your-email@gmail.com`
Password	Gmail 앱 비밀번호 (16자리)

Step 1: 워크플로우 생성¶

프로젝트 대시보드에서 새 워크플로우를 클릭합니다.
이름: 고객 문의 자동 답변
생성을 클릭하면 에디터가 열립니다.

Step 2: 트리거 노드 설정¶

캔버스에 기본으로 추가된 트리거 노드를 클릭합니다.

설정 탭:

트리거 타입: 수동 실행(Manual) 선택

테스트 탭:

테스트 데이터 입력:

{
  "customer_name": "홍길동",
  "customer_email": "customer@example.com",
  "question": "결제 수단을 변경하고 싶습니다. 어떻게 해야 하나요?"
}

Step 3: AI 에이전트 노드 추가 및 설정¶

노드 추가¶

트리거 노드 하단의 + 버튼을 클릭합니다.
AI 에이전트를 선택합니다.
자동으로 트리거 → 에이전트 엣지가 연결됩니다.

에이전트 설정¶

에이전트 노드를 클릭하여 우측 패널에서 설정합니다.

기본 설정:

항목	값
LLM 모델	GPT-5-mini
시스템 프롬프트	아래 참조

시스템 프롬프트:

당신은 w5w 고객 지원 담당자입니다.

역할:
- 고객의 문의에 한국어로 답변합니다.
- 답변은 3~5문장으로 간결하게 작성합니다.
- 고객의 이름을 포함하여 친근하게 답변합니다.

규칙:
- 존댓말을 사용합니다.
- 해결 방법을 단계별로 안내합니다.
- 추가 문의는 support@w5w.ai로 안내합니다.

입력 프롬프트:

고객명: {{ $('trigger').data_content.customer_name }}
문의 내용: {{ $('trigger').data_content.question }}

위 고객 문의에 대한 답변을 작성해주세요.

Step 4: 이메일 전송 스킬 노드 추가¶

노드 추가¶

에이전트 노드 하단의 + 버튼을 클릭합니다.
스킬을 선택합니다.

스킬 설정¶

스킬 노드를 클릭하여 설정합니다.

스킬 선택: 이메일 전송 (send_email)

인증 정보: 등록한 SMTP 인증 정보 선택

파라미터 설정:

파라미터	값
수신자(to)	`{{ $('trigger').data_content.customer_email }}`
제목(subject)	`[w5w] 문의에 대한 답변드립니다`
본문(body)	`{{ $('agent_1').text_content }}`

변수 셀렉터 활용

파라미터 입력 시 {{를 입력하면 변수 셀렉터가 나타납니다. 트리거와 에이전트 노드의 출력 필드를 클릭하여 변수를 삽입할 수 있습니다.

Step 5: 완성된 워크플로우 확인¶

3개의 노드가 순서대로 연결된 워크플로우가 완성되었습니다.

Step 6: 테스트 실행¶

상단의 테스트 실행 버튼을 클릭합니다.
트리거 테스트 데이터를 확인하고 실행을 클릭합니다.

노드가 순서대로 실행됩니다:
- 트리거: 테스트 데이터 전달
- AI 에이전트: LLM이 답변 생성 (실시간 스트리밍으로 표시)
- 이메일 전송: 생성된 답변을 이메일로 전송
실행이 완료되면 각 노드를 클릭하여 결과를 확인합니다.

주의

테스트 실행 시에도 이메일이 실제로 전송됩니다. 반드시 테스트용 이메일 주소를 사용하세요.

Step 7: 워크플로우 활성화¶

테스트가 성공하면 워크플로우를 활성화합니다.

상단의 활성화 토글을 켭니다.
이후 수동 트리거를 통해 언제든 이 워크플로우를 실행할 수 있습니다.

응용: 웹훅 트리거로 확장¶

수동 실행 대신 웹훅 트리거로 변경하면 외부 시스템에서 자동으로 워크플로우를 호출할 수 있습니다.

트리거 노드에서 웹훅(Webhook)을 선택합니다.
생성된 웹훅 URL을 복사합니다.

https://api.w5w.ai/webhook/{workflow_id}/inquiry

외부 시스템에서 POST 요청을 보내면 워크플로우가 자동 실행됩니다:

curl -X POST https://api.w5w.ai/webhook/abc123/inquiry \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "홍길동",
    "customer_email": "customer@example.com",
    "question": "서비스 해지 방법이 궁금합니다."
  }'

다음 단계¶

에디터 가이드 — 에디터의 모든 기능을 익혀봅니다.
변수 시스템 — 노드 간 데이터 전달을 자세히 알아봅니다.
노드 가이드 — 9가지 노드 타입을 모두 활용해봅니다.