스킬 노드¶

스킬(Skill) 노드는 단일 기능을 직접 실행합니다. AI 에이전트 없이 이메일 전송, DB 조회 등의 작업을 확정적으로 수행할 때 사용합니다.

에이전트 노드 vs 스킬 노드

	AI 에이전트 노드	스킬 노드
스킬 선택	AI가 상황에 따라 자율 선택	사용자가 고정 지정
파라미터	AI가 자동 구성	사용자가 직접 설정 (변수 가능)
적합한 경우	유연한 판단이 필요한 작업	항상 동일한 동작이 필요한 작업
비용	LLM 호출 비용 발생	LLM 비용 없음

스킬 설정 방법¶

1. 스킬 선택¶

스킬 노드를 클릭하면 우측 패널에서 실행할 스킬을 선택합니다.

2. 인증 정보 연결¶

선택한 스킬에 필요한 인증 정보를 연결합니다.

3. 파라미터 설정¶

스킬별 입력 파라미터를 설정합니다. 고정값 또는 변수를 사용할 수 있습니다.

스킬 카탈로그¶

이메일 스킬¶

스킬	설명	주요 파라미터	인증
이메일 전송	SMTP로 이메일 전송	to, subject, body, cc, attachments	SMTP
이메일 수신	IMAP으로 최근 이메일 조회	folder, limit, since	IMAP
이메일 검색	조건으로 이메일 검색	query, folder, limit	IMAP
이메일 삭제	이메일 삭제	message_id	IMAP
이메일 이동	폴더 간 이메일 이동	message_id, target_folder	IMAP
읽음 처리	읽음/읽지 않음 표시	message_id, mark_as	IMAP

이메일 전송 예시¶

파라미터	예시 값
수신자(to)	`{{ $('trigger').data_content.email }}`
제목(subject)	`[w5w] 문의 답변`
본문(body)	`{{ $('agent_1').text_content }}`
참조(cc)	`manager@example.com` (선택)

커뮤니케이션 스킬¶

스킬	설명	주요 파라미터	인증
Telegram 메시지	텍스트 메시지 전송	chat_id, text	Telegram Bot
Telegram 문서	파일 전송	chat_id, file	Telegram Bot
Telegram 사진	이미지 전송	chat_id, photo	Telegram Bot
Telegram 업데이트 조회	최근 메시지 조회	limit	Telegram Bot
SMS 전송	SMS/LMS 문자 전송	to, message	문자콕 API

Telegram 메시지 전송 예시¶

파라미터	예시 값
chat_id	`{{ $('trigger').data_content.chat_id }}`
text	`{{ $('agent_1').text_content }}`

HTTP 스킬¶

스킬	설명	주요 파라미터	인증
HTTP GET	GET 요청	url, headers, params	API Key (선택)
HTTP POST	POST 요청	url, headers, body	API Key (선택)
HTTP PUT	PUT 요청	url, headers, body	API Key (선택)
HTTP PATCH	PATCH 요청	url, headers, body	API Key (선택)
HTTP DELETE	DELETE 요청	url, headers	API Key (선택)

HTTP POST 예시¶

파라미터	예시 값
url	`https://api.example.com/orders`
headers	`{"Authorization": "Bearer xxx"}`
body	`{{ $('trigger').data_content }}`

데이터베이스 스킬¶

스킬	설명	주요 파라미터	인증
DB 조회	SELECT 쿼리 실행	query	Database
DB 쓰기	INSERT/UPDATE 실행	query	Database
DB 삭제	DELETE 실행	query	Database
스키마 조회	테이블 구조 확인	table_name	Database

지원 DB: MySQL, PostgreSQL, SQLite

DB 조회 예시¶

파라미터	예시 값
query	`SELECT * FROM orders WHERE date = CURDATE()`

파일 스킬¶

스킬	설명	주요 파라미터	인증
파일 읽기	파일 내용 읽기	file_path 또는 URL	-
파일 쓰기	파일 생성/저장 (S3)	file_name, content	-
PDF 추출	PDF에서 텍스트/표 추출	file_path 또는 URL	-
템플릿 내보내기	Excel 템플릿 기반 문서 생성	template, data	-

데이터 처리 스킬¶

스킬	설명	주요 파라미터	인증
데이터 분석	LLM 기반 데이터 분석	data, prompt	-
데이터 분류	LLM 기반 데이터 분류	data, categories	-
데이터 조인	두 데이터셋 병합	left, right, key	-
수식 계산	수식/계산 실행	expression, data	-
데이터 필터	조건으로 데이터 필터링	data, condition	-
컬럼 변환	컬럼 추가/수정/삭제	data, transforms	-

파라미터에 변수 사용¶

모든 스킬 파라미터에 변수를 사용할 수 있습니다.

변수 셀렉터¶

파라미터 입력 필드에서 {{를 입력하면 변수 셀렉터가 나타납니다.

고정값과 변수 혼합¶

[w5w] {{ $('trigger').data_content.customer_name }}님의 문의 답변

위 예시처럼 고정 텍스트와 변수를 함께 사용할 수 있습니다.

스킬 출력¶

출력 구조¶

{
  "node_type": "skill",
  "status": "success",
  "text_content": "스킬 실행 결과 요약",
  "data_content": {
    "result": { "..." }
  }
}

출력 참조¶

{{ $('skill_1').text_content }}           → 결과 요약 텍스트
{{ $('skill_1').data_content.result }}    → 실행 결과 데이터