01. 시작하기¶
로그인부터 첫 워크플로우를 실제로 돌려보기까지, 순서대로 따라가면 10분쯤 걸립니다.
1. 로그인¶
app.eeumsae.com에 접속해 Google로 계속하기를 누릅니다. 베타에서는 Google 계정 로그인만 지원합니다. 별도 회원가입 절차는 없고, 첫 로그인 시 계정이 만들어집니다.
화면 언어는 브라우저 언어에 맞춰 한국어 또는 영어로 자동 설정됩니다. 화면에서 직접 바꿀 수도 있고, 고른 언어는 다음 방문에도 유지됩니다. 이 가이드는 한국어 화면 기준입니다.
2. 워크스페이스 선택¶
로그인하면 워크스페이스 목록이 나옵니다. 워크스페이스는 자동화·연결·변수·데이터가 담기는 공간입니다. 처음이라면 기본 워크스페이스 하나가 준비되어 있습니다. 클릭해서 들어가면 사이드바가 있는 메인 화면이 나옵니다.
워크스페이스가 여러 개라면 사이드바 맨 위 스위처로 전환합니다. 연결·변수·데이터셋은 워크스페이스마다 따로 관리되므로, Slack을 A 워크스페이스에 연결했다면 B 워크스페이스에서는 다시 연결해야 합니다.
3. 첫 워크플로우 만들기¶
사이드바에서 워크플로우 → 오른쪽 위 + 새 워크플로우 버튼을 누릅니다.
| 입력 항목 | 설명 |
|---|---|
| 이름 | 사람이 읽을 이름. 예: 첫 자동화 테스트 |
| slug | URL·웹훅 주소에 쓰이는 식별자. 이름에서 자동 생성되며 직접 고칠 수 있습니다. |
만들면 워크플로우 상세 화면으로 들어갑니다. 탭이 세 개 있습니다.
| 탭 | 하는 일 |
|---|---|
| 개요 | 웹훅 주소 확인, 실행 이력 보기, 켜기/끄기 |
| 비주얼 에디터 | 노드를 끌어다 놓고 선으로 잇는 그림 편집기 |
| YAML | 워크플로우 정의를 텍스트로 직접 작성 |
두 편집 탭은 같은 워크플로우를 다르게 보여주는 것입니다. 비주얼 에디터에서 만든 걸 YAML 탭에서 볼 수 있고, 반대도 됩니다.
4. YAML로 만들어보기 (가장 빠른 길)¶
YAML 탭을 열고 아래를 통째로 붙여넣습니다. 외부 연결이 하나도 필요 없는 예제입니다.
id: my-first-workflow
name: 첫 자동화 테스트
nodes:
- id: trigger
name: 웹훅 트리거
type: ENTRYPOINT
trigger:
kind: WEBHOOK
input-schema:
type: object
required: [name]
properties:
name: { type: string }
- id: greet
name: 인사말 만들기
type: CALL
integration: transform_jmespath
input:
expression: "{message: join('', ['안녕하세요, ', name, '님!'])}"
data:
name: "${nodes.trigger.response.body.name}"
edges:
- from: trigger
to: greet
붙여넣었으면 저장(또는 Ctrl+S)을 누릅니다.
id는 워크스페이스 안에서 고유해야 합니다. 이미 쓰고 있는 값이면 저장이 거부되니 다른 이름으로 바꿔주세요.
무슨 뜻인지 한 줄씩 보면 이렇습니다.
trigger노드: 웹훅으로 시작하고, 요청 본문에name필드가 반드시 있어야 합니다.greet노드:transform_jmespath통합으로 데이터를 가공합니다. 앞 노드가 받은name을 가져다 인사말 문장을 만듭니다.edges:trigger다음에greet을 실행하라는 뜻입니다.
5. 실제로 실행해보기¶
개요 탭으로 갑니다. 웹훅 트리거를 쓰는 워크플로우라면 Webhook 트리거 카드에 호출 주소가 보입니다.
이 주소로 POST를 보내면 실행됩니다. 터미널에서 이렇게 확인할 수 있습니다.
curl -X POST "https://api.eeumsae.com/webhooks/<워크스페이스ID>/my-first-workflow" \
-H "Content-Type: application/json" \
-d '{"name": "보찬"}'
개요 탭의 실행 이력을 새로고침하면 방금 실행이 보입니다. 클릭하면 노드별로 무엇이 들어가고 무엇이 나왔는지 볼 수 있습니다.
greet 노드 출력에 {"message": "안녕하세요, 보찬님!"}이 있으면 성공입니다.
그다음은?¶
첫 워크플로우가 돌았다면, 실제로 쓸 만한 자동화로 넘어갈 차례입니다.
"매일 정해진 시간에 돌리고 싶어요" → 03. 트리거 설정하기의 스케줄러 편
"Slack으로 결과를 받고 싶어요"
→ 07. 연결 관리에서 Slack을 연결한 뒤 04. 통합 카탈로그의 slack_post_message
"카카오톡으로 알림을 받고 싶어요"
→ 07. 연결 관리 + kakao_send_memo
"CI·배포 결과를 챙기고 싶어요" → 04. 통합 카탈로그의 GitHub 통합
"내 서비스 API를 부르고 싶어요"
→ 04. 통합 카탈로그의 http_request
"AI한테 요약을 시키고 싶어요"
→ 04. 통합 카탈로그의 llm_chat
"그냥 말로 만들고 싶어요" → 11. AI 비서로 만들기
"완성된 예제부터 보고 싶어요" → 12. 실전 레시피