Skip to main content

​
Flow Studio

경로: 하단 툴바 Flow Studio 복잡한 다단계 워크플로를 시각적으로 설계·실행합니다. LLM 호출·Tool 호출·조건 분기·반복 등을 노드 그래프 로 엮어 재사용 가능한 Flow 로 저장하고, Scheduler 에 연결해 정기 실행까지 자동화합니다.
Image

​
탭 구성

​
Studio 탭

​
좌측 — Flows 라이브러리

저장된 Flow 목록.

​
중앙 — 캔버스

선택한 Flow 의 노드 그래프 편집. 빈 상태에서는 Select a flow or create a new one to get started. 안내.

​
우측 상단 헤더

​
노드 유형

​
변수 (Variables)

​
History 탭

Studio 탭 옆의 History 는 과거 실행 이력입니다.

​
상단 필터

​
목록 동작

  • 목록이 비어 있으면 No executions found / Select an execution to view details 표시
  • 개별 실행 클릭 → 각 노드의 입출력·소요 시간·에러 확인

​
실행 엔진

app/agents/flow_executor.py — DAG 기반 Flow 실행기.
  • 노드 상태: Pending → Running → Success / Failed
  • 입출력 캐시: 각 노드 결과를 세션 컨텍스트에 축적
  • 에러 처리: 노드별 retry / fallback 설정 가능
  • 병렬 실행: 의존성 없는 노드는 동시 실행

​
Flow vs Team Control vs Scheduler

​
사용 시나리오

Generate 기능 — 자연어로 "매일 아침 GitHub PR 요약을 Slack 에 보내는 Flow" 입력 시 LLM 이 초기 Flow 를 생성해 줍니다. 이후 수동으로 세부 조정.

​
운영 주의

  • Flow 는 재사용 자산 — 중요한 Flow 는 버전을 남기고 변경 시 Save 로 새 버전 생성 권장.
  • 민감 값(토큰·비밀번호) 은 Flow 노드 인자에 직접 넣지 말고, 환경변수 또는 Variables 로 분리.
  • 무한 Loop 위험 — Loop 노드에 종료 조건·최대 반복 수를 반드시 지정.
  • 외부 API 호출 실패 처리 — 네트워크 일시 장애를 감안해 retry 3 회 + fallback 설정.
  • 비용 폭증 — LLM 노드가 많거나 Loop 내부에 있으면 실행당 비용이 크게 증가. 한도·요금: Billing

​
관련 문서