01. 시작하기¶

로그인부터 첫 워크플로우를 실제로 돌려보기까지, 순서대로 따라가면 10분쯤 걸립니다.

1. 로그인¶

app.eeumsae.com에 접속해 Google로 계속하기를 누릅니다. 베타에서는 Google 계정 로그인만 지원합니다. 별도 회원가입 절차는 없고, 첫 로그인 시 계정이 만들어집니다.

2. 워크스페이스 선택¶

로그인하면 워크스페이스 목록이 나옵니다. 워크스페이스는 자동화·연결·변수·데이터가 담기는 공간입니다. 처음이라면 기본 워크스페이스 하나가 준비되어 있습니다. 클릭해서 들어가면 사이드바가 있는 메인 화면이 나옵니다.

워크스페이스가 여러 개라면 사이드바 맨 위 스위처로 전환합니다. 연결·변수·데이터셋은 워크스페이스마다 따로 관리되므로, Slack을 A 워크스페이스에 연결했다면 B 워크스페이스에서는 다시 연결해야 합니다.

3. 첫 워크플로우 만들기¶

사이드바에서 Workflows → 오른쪽 위 생성 버튼을 누릅니다.

입력 항목	설명
이름	사람이 읽을 이름. 예: `첫 자동화 테스트`
slug	URL·웹훅 주소에 쓰이는 식별자. 이름에서 자동 생성되며 직접 고칠 수 있습니다.

만들면 워크플로우 상세 화면으로 들어갑니다. 탭이 세 개 있습니다.

탭	하는 일
Overview	웹훅 주소 확인, 실행 이력 보기
Visual Editor	노드를 끌어다 놓고 선으로 잇는 그림 편집기
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

붙여넣었으면 Save(또는 Ctrl+S)를 누릅니다.

id는 워크스페이스 안에서 고유해야 합니다. 이미 쓰고 있는 값이면 저장이 거부되니 다른 이름으로 바꿔주세요.

무슨 뜻인지 한 줄씩 보면 이렇습니다.

trigger 노드: 웹훅으로 시작하고, 요청 본문에 name 필드가 반드시 있어야 합니다.
greet 노드: transform_jmespath 통합으로 데이터를 가공합니다. 앞 노드가 받은 name을 가져다 인사말 문장을 만듭니다.
edges: trigger 다음에 greet을 실행하라는 뜻입니다.

5. 실제로 실행해보기¶

Overview 탭으로 갑니다. 웹훅 트리거를 쓰는 워크플로우라면 Webhook 트리거 카드에 호출 주소가 보입니다.

https://api.eeumsae.com/webhooks/{워크스페이스ID}/{워크플로우slug}

이 주소로 POST를 보내면 실행됩니다. 터미널에서 이렇게 확인할 수 있습니다.

curl -X POST "https://api.eeumsae.com/webhooks/<워크스페이스ID>/my-first-workflow" \
  -H "Content-Type: application/json" \
  -d '{"name": "보찬"}'

Overview 탭의 실행 이력을 새로고침하면 방금 실행이 보입니다. 클릭하면 노드별로 무엇이 들어가고 무엇이 나왔는지 볼 수 있습니다. greet 노드 출력에 {"message": "안녕하세요, 보찬님!"}이 있으면 성공입니다.

그다음은?¶

첫 워크플로우가 돌았다면, 실제로 쓸 만한 자동화로 넘어갈 차례입니다.

"매일 정해진 시간에 돌리고 싶어요" → 03. 트리거 설정하기의 스케줄러 편

"Slack으로 결과를 받고 싶어요" → 07. 연결 관리에서 Slack을 연결한 뒤 04. 통합 카탈로그의 slack_post_message

"내 서비스 API를 부르고 싶어요" → 04. 통합 카탈로그의 http_request

"AI한테 요약을 시키고 싶어요" → 04. 통합 카탈로그의 llm_chat

"그냥 말로 만들고 싶어요" → 11. AI 비서로 만들기

"완성된 예제부터 보고 싶어요" → 12. 실전 레시피