Workflows
개요
워크플로우는 Agentic Work의 핵심 구성 요소입니다. 각 워크플로우는 시각적 캔버스 위에서 정의되는 독립적인 실행 단위로, 시작부터 끝까지 정해진 순서대로 실행되는 연결된 노드들의 그래프로 이루어져 있습니다.
이 페이지에서는 워크플로우를 구성하고, 빌드하고, 관리하는 방법을 안내합니다. 워크플로우에서 사용할 수 있는 노드 유형에 대한 자세한 내용은 아래를 참고하세요.
자동 실행 스케줄 및 트리거 설정은 아래를 참고하세요.
Workflow 구성
COS Workflow 는 아직 개선 중인 기능이기에 실행 결과가 불안정할 수 있습니다.
워크플로우 탭에는 현재 사용자가 접근 가능한 모든 워크플로우가 표시되며, 소유권과 권한 수준에 따라 세 가지 섹션으로 구분됩니다.
COS Workflows는 CommerceOS에서 기본 제공하는 워크플로우입니다. YouTube 키워드 검색 데이터 수집, 네이버 쇼핑 가격 정보 스크래핑 등 자주 쓰이는 작업들이 포함되어 있으며, 바로 실행할 수 있지만 수정은 불가합니다.
My Workflows는 현재 사용자가 직접 만든 워크플로우입니다. 편집, 새 버전 배포, 자동화 연결, 실행 로그 조회, 온디맨드 실행, 삭제 등 모든 권한을 가집니다.
Team Workflows는 같은 팀의 다른 멤버가 만든 워크플로우입니다. 실행과 자동화 연결은 가능하지만 직접 수정할 수는 없습니다. 팀원들의 작업을 파악하면서도 공유 프로세스에 의도치 않은 변경이 생기는 것을 방지하기 위한 제한체제입니다.
각 섹션에는 이름으로 워크플로우를 검색하는 검색창이 있으며, 페이지 상단 필터를 통해 배포 상태나 태그로 목록을 좁힐 수 있습니다.
Workflow Builder
워크플로우를 새로 만들거나 편집하면 Workflow Builder가 열립니다. 워크플로우의 로직을 시각적으로 구성하는 캔버스 기반 에디터로, 노드 추가, 연결, 설정, 배포 전 테스트까지 모든 작업을 수행합니다.
캔버스
캔버스는 워크플로우를 구성하는 작업 공간입니다. 모든 워크플로우는 프로세스를 시작하는 Start 노드로 시작되고, 완료를 표시하는 하나 이상의 End 노드로 종료됩니다. 그 사이에 각 단계를 정의하는 노드들이 배치됩니다.
노드와 노드 사이를 엣지로 연결하면 실행 순서가 결정됩니다. 단순한 순차 실행 구조도 되고, 병렬 경로나 조건 분기가 포함된 복잡한 구조도 구성할 수 있습니다. 각 노드는 이름과 간략한 설명을 표시하며, 노드 유형에 따라 아이콘으로 시각적으로 구분됩니다.
캔버스 왼쪽 툴바에는 다음 컨트롤이 있습니다.
- 노드 추가 — 노드 선택 메뉴를 엽니다
- 손 도구 — 캔버스를 탐색합니다 (Space를 누른 채 드래그로도 가능)
- 선택 도구 — 개별 노드를 선택하고 이동합니다
- 노드 정렬 — 그래프 레이아웃 재구성을 도와줍니다
실행 취소 및 다시 실행 컨트롤도 제공됩니다. 오른쪽 하단에는 줌 컨트롤과 전체 화면 버튼이 있어 큰 워크플로우를 다룰 때 뷰를 편하게 관리할 수 있습니다.
노드 설정
캔버스에서 노드를 선택하면 에디터 오른쪽에 해당 노드의 설정 패널이 열립니다. 설정 항목은 노드 유형마다 다르며, 각 노드 유형의 상세 설정은 해당 페이지에서 확인할 수 있습니다.
모든 노드에는 두 가지 공통 필드가 있습니다. Name은 워크플로우 내에서 노드를 고유하게 식별하는 이름이고, Description은 노드의 역할을 간략하게 설명하는 텍스트입니다. 필수 설정이 누락된 노드에는 설정 패널과 캔버스 노드 위에 경고 표시(예: “1 required”)가 주황색 점으로 나타납니다.
노드 유형
Add Node 패널에서 사용 가능한 노드 유형을 확인할 수 있습니다. 각 노드는 워크플로우 내에서 고유한 역할을 담당합니다.
- Agent — AI 모델을 사용하여 자연어 지시를 기반으로 작업을 수행합니다.
- Code — 커스텀 Python 코드를 실행합니다.
- Condition — 조건 로직을 기반으로 워크플로우를 분기합니다.
- Wait — 정해진 시간 동안 워크플로우 실행을 일시 중지합니다.
- Email — SMTP를 통해 이메일을 발송합니다.
- HITL (Human-in-the-Loop) — 워크플로우 실행을 일시 중지하고 진행 전에 사람의 승인을 요청합니다.
- Create Ontology — 출력 데이터를 구조화된 객체로 Ontology에 저장합니다.
- Ontology Query — SQL 스타일 쿼리로 Ontology 데이터를 읽습니다.
Build 모드와 Run 모드
Workflow Builder는 에디터 상단 탭으로 전환하는 두 가지 모드로 동작합니다.
Build 모드는 설계 환경입니다. 노드를 추가·설정·연결·이동·삭제할 수 있으며, 모든 설정 항목을 자유롭게 편집할 수 있습니다. Build 모드에서의 변경 사항은 현재 드래프트에 저장되며 이미 배포된 버전에는 영향을 주지 않습니다. Build 모드는 편집 권한이 있는 경우에만 열 수 있습니다 — 워크플로우 생성자와 그룹 오너(모든 워크플로우에 전체 접근 권한을 가짐)만 Build 모드로 열 수 있습니다.
Run 모드는 테스트 환경입니다. 노드 설정 패널이 읽기 전용으로 전환되고, 화면 오른쪽에 Workflow Run Log 패널이 나타납니다. Test Run 버튼을 누르면 현재 드래프트 워크플로우가 실행되고, 로그 패널에서 어떤 노드가 어떤 순서로 실행됐는지, 성공 여부를 실시간으로 확인할 수 있습니다. 프로덕션에 배포하기 전에 워크플로우 동작을 검증하는 데 활용하세요.
에디터 메뉴
빌더 우측 상단의 ”…” 메뉴에서 추가 작업을 수행할 수 있습니다.
- 권한 관리 — 워크플로우에 대한 열람 및 자동화 권한을 관리합니다
- 태그 수정 — 워크플로우에 부여된 태그 내역을 수정합니다
- History — 워크플로우의 편집 기록을 확인합니다
- Delete — 워크플로우를 완전히 삭제합니다