비주얼 및 Python 워크플로우
최신 EKB 워크플로우는 두 가지 빌더 스타일로 제공됩니다. Tools 캔버스에서 직접 만들거나, Autopilot(빌드 모드)에게 대신 작성하도록 요청할 수 있습니다. 이 페이지는 두 스타일의 차이점, Autopilot의 역할, 플로우차트와 요약 뷰를 읽는 방법을 다룹니다.
클래식 V1 대 V2 제품 라인과 마이그레이션은 워크플로우 개요 및 Workflow Builder V2를 참고하세요.
비주얼 대 Python 한눈에 보기
| 비주얼 (Workflows v2) | Python (Workflows v3 / 코드 모드) | |
|---|---|---|
| 편집하는 것 | 트리거, 에이전트, 도구, 조건, 출력의 드래그 앤 드롭 캔버스 | 워크플로우 로직을 정의하는 Python 소스 |
| 읽는 방식 | 캔버스 그래프 | 일반 영어 단계 레이블, 연결된 앱, 접을 수 있는 루프/분기 카드가 있는 읽기 쉬운 플로우차트 — 선택적 개발자(코드) 뷰 포함 |
| 적합한 용도 | 시각적으로 조립하고 검사하고 싶은 프로세스 | 코드로 표현하기 더 쉬운 로직, 또는 Autopilot이 Python으로 처음부터 끝까지 작성해야 하는 로직 |
| 에디터에서의 Autopilot | 채팅 / AI로 만들기 흐름으로 Autopilot이 도움 | 빌드 및 다듬는 동안 Autopilot 채팅이 캔버스에 고정됨 |
| 수동 "새 플로우" / 빈 도구 | 수동 생성의 기본값 | 빈 수동 생성의 기본값이 아님 (아래 참조) |
Tools 목록의 워크플로우에 Python 배지가 있으면 코드 모드(v3) 워크플로우라는 뜻입니다.
워크플로우 생성
Autopilot으로 구축 (두 스타일 모두 권장)
- 프로젝트를 엽니다 (읽기 전용 Autopilot 시스템 프로젝트가 아닌).
- 빌드 모드에서 Autopilot을 사용하거나, Tools를 열고 Build workflow with AI / Autopilot 생성 흐름을 시작하세요.
- 워크플로우가 수행할 작업을 설명합니다 (컨텍스트를 위해 파일을 첨부할 수 있습니다).
- 생성 대화 상자에 Autopilot이 기본적으로 Workflows v3 / Python 또는 Workflows v2 / Visual 워크플로우를 구축할지 표시됩니다.
- Autopilot이 계획하고, 필요할 때 명확화 질문을 하고, 워크플로우를 구축하며, 채팅을 계속하며 다듬을 수 있습니다.
새 Autopilot 채팅은 기본적으로 에이전트 모드입니다. Autopilot이 워크플로우를 생성하거나 변경하기를 원하면 빌드로 전환하세요. Autopilot 모드를 참고하세요.
Autopilot 생성 시 비주얼 대 Python은 누가 제어하나요?
슈퍼 관리자 설정 — Default new Autopilot workflows to Workflows v3 — 가 기본값을 선택합니다:
- 켬 — Autopilot은 기본적으로 Python / 코드 모드 워크플로우를 생성합니다
- 끔 — Autopilot은 기본적으로 비주얼 (v2) 워크플로우를 생성합니다
수동 빈 워크플로우 생성은 비주얼 빌더에 머물러 있습니다.
수동 생성 (비주얼)
- Tools로 이동합니다.
- New Flow를 사용하거나 빈 사용자 정의 도구를 생성합니다.
- 트리거를 추가하고, 노드를 캔버스로 끌어넣고, 연결하고, 실행한 다음 게시하세요.
세부 정보: Workflow Builder V2.
Autopilot이 구축한 워크플로우
Autopilot이 빌드 모드에서 워크플로우를 구축할 때 일반적으로:
- 트리거, 단계, 앱, 출력을 명확화합니다
- 비주얼 또는 Python 모드로 워크플로우를 생성합니다 (위의 플랫폼 기본값에 따름)
- 단계 / Python 소스를 구성합니다
- 해당되는 경우 검증 및 테스트를 수행합니다
- 생성된 내용의 요약을 제공합니다
같은 채팅을 계속할 수 있습니다: 단계를 다듬고, 실패를 수정하거나, 추가 작성 없이 결과를 실행하거나 추론하기 위해 에이전트 모드로 전환할 수 있습니다. Autopilot 작동 방식을 참고하세요.
에디터에 고정된 Autopilot
Python (코드 모드) 워크플로우의 경우, Autopilot은 에디터 캔버스에 고정되어 플로우차트를 보면서 변경 사항을 설명하고 (개발자 뷰에서) 소스가 업데이트되는 것을 볼 수 있습니다.
비주얼 워크플로우의 경우, Autopilot 채팅 / "AI로 만들기" 흐름으로 작성하고 반복하세요. 캔버스는 노드를 끌어넣고 구성하는 장소로 남습니다.
플로우차트 및 요약 뷰
플로우차트 (Python 워크플로우)
Python 워크플로우는 읽기 쉬운 플로우차트로 렌더링됩니다:
- 일반 영어 단계 레이블 (원시 코드 식별자만이 아니라)
- 흐름에 표시되는 연결된 앱
- 복잡한 제어 흐름을 위한 접을 수 있는 루프 및 분기 카드
- 개요 대 개발자 세부 정보: 개요는 비즈니스 흐름을 강조하고, 개발자는 그래프 옆에 Python 소스를 노출합니다
과거 실행을 검사할 때도 동일한 플로우차트가 사용되며, 단계별 상태가 겹쳐져 무엇이 실행되었고 건너뛰었는지, 실패했는지 볼 수 있습니다.
요약 (비주얼 및 Python)
비주얼 및 Python 워크플로우 모두 요약 뷰를 지원합니다 — 구조화된 단계와 함께 워크플로우가 수행하는 작업을 한눈에 보여주는 설명입니다. 요약은 게시와 연동되어 생성/업데이트됩니다. 게시 후 워크플로우를 변경하면 요약을 최신으로 유지하기 위해 다시 게시해야 할 수 있습니다.
슈퍼 관리자는 워크플로우 요약과 단계 노트를 작성할 모델을 구성할 수 있습니다 (플랫폼 모델 설정).
어떤 것을 언제 사용할지
| 목표 | 권장 |
|---|---|
| 노드를 끌어넣고 조건을 연결하여 프로세스 조립 | 비주얼 |
| Autopilot이 상당한 분기 / 데이터 로직을 코드로 작성하게 함 | Python |
| 반복하는 동안 Autopilot을 라이브 플로우차트 옆에 고정 | Python |
| 기존 V2 캔버스 문서 및 노드 카탈로그 따르기 | 비주얼 → Workflow Builder V2 |
| 채팅에서 "주간 보고서 워크플로우를 만들어줘" | Autopilot 빌드 모드 (모드 = 플랫폼 기본값) |
관련 문서
- 워크플로우 개요 — V1 대 V2 제품 라인
- Workflow Builder V2 — 비주얼 캔버스 사용법
- Autopilot 개요 — Autopilot이 구축할 수 있는 것
- Autopilot 모드 — 에이전트 대 빌드
- EKB as MCP — Builder — Claude / Cursor에서 동일한 빌드 표면
- 2.4.0 변경 로그 — 비주얼 및 Python 워크플로우 빌더 릴리스 노트