본문으로 건너뛰기
FlowAgent
Coming Soon · 정식 문서 사이트 준비 중

문서

아래는 핵심 내용 요약입니다. 곧 풀 문서 사이트로 확장할 예정 — 그 전까진 GitHub README와 이 페이지로 안내드려요.

01 · Quickstart

1분 안에 첫 워크플로우 실행

설치 마법사 없음. 압축 풀고 더블클릭 한 번이면 끝.

  1. STEP 1

    압축 풀기

    다운로드한 .zip을 원하는 폴더에 압축 해제.

  2. STEP 2

    start.bat 더블클릭

    Windows. Node·pnpm 자동 설치 + 서버 시작. macOS·Linux는 터미널에서 pnpm install && pnpm dev.

  3. STEP 3

    브라우저 자동 오픈

    localhost:3000에서 카드 클릭으로 실행. 결과는 SSE로 실시간 스트리밍.

02 · YAML 스키마

워크플로우 한 파일 구조

workflows/<slug>.yaml로 저장하면 자동 감지. 다른 의존성 없음.

workflows/example.yaml 
name: example
description: "한 줄 설명 (카드에 표시됨)"
category: "운영 / PM"
persona: "매니저·리드"

steps:
  - id: load
    run: shell
    cmd: cat data.csv

  - id: summarize
    run: llm
    prompt: |
      아래를 1-pager로 요약:
      {{ load.stdout }}

필드 빠른 참조

name
파일명 기준 slug — 카드에 표시
description
카드 본문 한 줄
category
분류 뱃지 (영업관리·운영·총무 등)
persona
페르소나 필터 키 (선택)
steps[].id
단계 식별자 — 다른 단계가 {{ id.stdout }}로 참조
steps[].run
llm 또는 shell
steps[].prompt
LLM 단계 프롬프트 (Claude 호출)
steps[].cmd
셸 단계 명령어 (sandboxed)

정식 풀 스키마는 곧 별도 문서로. 현재는 5개 기본 워크플로우 ( 템플릿 페이지)에서 실제 작성 예시 참고.

03 · Troubleshooting

자주 마주치는 문제

start.bat 더블클릭 시 검은 창이 떴다가 즉시 닫혀요

대부분 줄바꿈(LF/CRLF) 또는 cmd 파싱 문제입니다. v0.1.0에서 fix 되었으니 GitHub Release 최신본을 다시 다운받아 보세요. 그래도 문제면 cmd 창에서 직접 start.bat을 실행해 에러 메시지를 확인할 수 있어요.

"포트 3000이 사용 중" 에러

이미 다른 FlowAgent 인스턴스 또는 다른 프로그램이 3000번 포트를 점유 중입니다. 종료 후 재시작하거나, 환경변수 PORT=3001로 포트를 바꿔 실행하세요.

# Windows (PowerShell)
$env:PORT=3001; pnpm dev

# macOS / Linux
PORT=3001 pnpm dev
API 키를 입력했는데도 LLM 단계가 실패해요

.env 파일의 ANTHROPIC_API_KEY= 뒤에 공백·따옴표 없이 키를 붙여넣었는지 확인하세요. sk-ant-로 시작하는 게 정상입니다. 저장 후 서버를 한 번 재시작 (cmd 창 닫고 start.bat 다시 더블클릭).

워크플로우 카드가 안 보여요

workflows/ 디렉토리에 .yaml 파일이 있는지 확인. 파일명이 _ (언더스코어)로 시작하면 템플릿으로 분류되어 카드에 노출되지 않습니다. YAML 문법 오류 시 카드가 빠질 수 있으니 yamllint.com으로 검증해 보세요.

macOS / Linux에서 start.bat가 안 돼요

맞아요, start.bat은 Windows 전용입니다. macOS·Linux에서는 터미널에서 pnpm install && pnpm dev로 직접 실행하세요. v0.2.0에서 start.sh 동등 스크립트 추가 예정.

Your workflows are plain YAML files.
Your data stays on your machine.

더 자세한 정보는 GitHub README와 소스 코드를 참고하세요.

GitHub README 보기 ↗ 무료 다운로드