비주얼 편집기

워크플로 편집기는 매일 가장 많은 시간을 보내는 페이지입니다. 이 기사에서는 모든 영역과 모든 버튼에 대해 설명하므로 X를 수행하려는 경우 어디를 클릭해야 하는지 알 수 있습니다.

전체 레이아웃

편집기는 일반적인 3열 레이아웃입니다.

• 상단 도구 모음 — 저장/검증/실행/가져오기/내보내기/버전 기록 등 핵심 작업
• 왼쪽 열 캔버스 — 드래그 앤 드롭 노드, 연결, 확대/축소 및 미니 맵을 갖춘 DAG 시각화
• 오른쪽 열 YAML — Monaco Editor는 구문 강조/자동 완성/오류 프롬프트를 사용하여 YAML 소스를 직접 편집합니다.
• 하단 상태 표시줄 — 상태 저장, 잠금 보유자 편집, 공동작업자 커서 위치, 마지막 확인 시간
• 오른쪽 서랍 — AI 도우미, 중단점 패널, 변수 스냅샷(요청 시 열림)

캔버스 대 YAML: 양방향 바이트 수준 동기화

이것이 Braidrun와 다른 브랜드의 가장 분명한 차이점입니다. DAG 그래프와 YAML은 바이트 수준으로 동일합니다.

• YAML에서 라인을 변경하면 캔버스의 해당 노드가 즉시 업데이트됩니다.
• 캔버스에서 연결선을 드래그하면 YAML의 해당 종속 항목 필드가 동시에 나타납니다.
• 주석/빈 줄/필드 순서는 손실되지 않습니다. 내보낸 YAML은 편집기에 표시되는 것과 정확히 동일합니다.

상단 도구 모음

저장

기본적으로 5초 동안 입력을 멈춘 후 자동으로 한 번 저장됩니다. Ctrl / Cmd + S를 눌러 수동으로 실행할 수도 있습니다. 저장할 때마다 버전 스냅샷(간단한 재정의가 아님)

실행 취소 / 다시 실행

툴바에 실행 취소 / 다시 실행 두 버튼이 있으며, 단축키는 Ctrl / Cmd + Z와 Ctrl / Cmd + Shift + Z입니다. 이것은 편집기 수준의 이력 스택입니다: 캔버스 드래그, YAML 수정, AI 어시스턴트가 단계별로 구성한 각 단계가 모두 같은 이력에 들어가므로 "AI가 한 단계를 망친 것"도 마찬가지로 원클릭으로 되돌릴 수 있습니다. 연속 입력은 하나의 레코드로 병합되고, 자동 저장이 기록하는 타임스탬프는 불필요한 이력을 만들지 않습니다. 최근 50개 스냅샷까지 유지되며, 다른 워크플로로 전환하면 이력이 초기화됩니다.

확인

왕복을 수행하려면 플랫폼 파서를 호출하세요.

1. YAML → WorkflowDefinition 객체(구문 계층)
2. WorkflowDefinition → 의미론적 검증(변수 참조를 구문 분석할 수 있는지, 사전 설정을 찾을 수 있는지, 종속성에 루프가 있는지 여부)
3. WorkflowDefinition → YAML 왕복(편차가 있는 경우 오류가 보고됨)

오류는 YAML 행 단위에 빨간 물결선으로 표시되며, 클릭하면 해당 행으로 이동합니다. 심층 검증 결과도 아래에서 소개하는 진단 문제 패널에 병합됩니다. 깨끗이 고친 뒤 저장하여 배포하십시오.

실행하다

이 버튼을 클릭하면 다음을 수행할 수 있는 대화 상자가 나타납니다.

• 워크플로 변수를 입력합니다(기본값은 미리 채워져 있음).
• 확인/취소 dry-run (기본적으로 선택되어 있습니다. 처음 실행하는 경우 적극 권장됩니다)
• 트리거 소스 선택(수동/스케줄-시뮬레이션)

"실행 시작"을 클릭하면 편집기가 자동으로 오른쪽에 서랍을 열어 실시간 이벤트 흐름을 표시하는 동시에 현재 탭에서 실행 세부 정보를 엽니다.

가져오기/내보내기

• YAML 가져오기 - 현재 콘텐츠를 덮어쓰는 파일/페이스트보드/URL에서 YAML을 로드합니다.
• YAML 내보내기 - 현재 YAML을 로컬 파일로 다운로드합니다. Git 버전 관리에 적합합니다.
• Dify/Langflow - Pro 이상의 패키지와 같은 외부 형식을 가져오면 플랫폼이 자동으로 Braidrun YAML로 변환됩니다.

버전 기록

저장할 때마다 스냅샷이 생성되고 기본적으로 100개의 버전이 유지됩니다(Enterprise의 경우 제한 없음). 다음을 수행할 수 있습니다.

• 모든 스냅샷 나열(시간, 절약, 변경된 라인 수 포함)
• 현재 버전 차이점과 비교
• 모든 기록 버전으로 롤백(롤백하면 새 스냅샷이 생성되고 실제로 기록을 덮어쓰지 않음)

Promote to module / Demote from module

캔버스에서 여러 연속 단계를 선택하고 "모듈로 승격"을 클릭하여 이러한 단계를 독립적인 sub_workflow 모듈로 추출하면 원래 위치가 모듈 호출이 됩니다. 역방향 작업을 강등합니다. 세부정보 보기 모듈화 및 재사용.

왼쪽 열 캔버스 작업

새 노드 추가

• 왼쪽 하단 모서리에 있는 "+" 버튼은 단계 유형 선택기를 열고 기본 모드를 선택합니다.
• 오른쪽 열의 "단계 템플릿 조각"을 캔버스로 드래그하여 추가할 수도 있습니다.

연결하다

한 노드의 출력 엔드포인트를 다른 노드의 입력 엔드포인트로 끌어서 YAML에 종속 관계를 자동으로 추가합니다. 플랫폼에서는 루프를 형성하는 가장자리를 그리는 것을 허용하지 않습니다. 루프를 그리려고 하면 튕겨져 나가게 됩니다.

노드 마우스 오른쪽 버튼 클릭 메뉴

• 편집 - 부분 편집을 위해 이 단계의 YAML 코드 조각을 엽니다.
• 복사 - 현재 단계의 복사본을 복제합니다(ID에는 자동으로 접미사가 붙습니다).
• 삭제 - 삭제할 때 다운스트림 참조가 있으면 경고가 표시됩니다.
• 시작/끝으로 설정 - 워크플로의 명시적인 시작/종료를 표시합니다(state_machine에만 필요함).

확대/축소 및 미니맵

오른쪽 하단에는 미니맵이 있어 복잡한 작업흐름이 캔버스 크기를 초과할 때 빠르게 점프할 수 있습니다. 확대/축소하려면 Ctrl / Cmd + 스크롤 휠; 스페이스바를 누른 채 드래그하여 이동하세요.

오른쪽 열 YAML

자동완성

JSON Schema를 기반으로 공통 필드명, 사전 설정 이름, 기존 단계 ID를 완성할 수 있습니다. Ctrl / Cmd + 스페이스 포스 각성.

Fold / Unfold

전체 단계를 축소하려면 왼쪽 줄 번호 옆에 있는 화살표를 클릭하세요. 바로 가기 키 Ctrl / Cmd + Shift + [ / ].

검색 및 바꾸기

Ctrl / Cmd + F 검색, Ctrl / Cmd + H 바꾸기. 규칙성을 지원합니다. 현재 워크플로에만 영향을 미치며 다른 워크플로에는 영향을 주지 않습니다.

진단 및 문제 패널

편집기에는 두 층의 lint가 있으며, 같은 규칙 코드 세트를 공유합니다:

• 클라이언트 실시간 진단 — 편집할 때마다 로컬에서 즉시 재계산하며(의존성 순환, 매달린 참조, 철자가 유사한 step id 제안 등 구조 규칙), 지연 없이 문제 패널, 노드 배지, 툴바 배지를 구동합니다.
• 서버 심층 검증 — 툴바의 「검증」을 클릭하면 호출되며, POST /api/workflows/lint, 한 번에 모든 문제를 받아오고(저장 검증은 첫 오류를 만나면 멈추지만 lint는 그렇지 않습니다), agent 프리셋, 모듈 계약처럼 서버 데이터가 필요한 규칙을 보완합니다.

툴바의 배지는 오류 / 경고 수를 실시간으로 표시하며(오류가 있으면 빨간색, 경고만 있으면 노란색), 클릭하면 심층 검증을 한 번 트리거하고 문제 패널을 엽니다. 패널의 각 문제에는 단계 위치 칩(클릭하면 해당 노드로 이동)과 수정 제안이 딸려 있습니다. 단일 또는 전체를 「AI에게 수정 맡기기」할 수도 있습니다 — 편집기가 문제를 구조화된 prompt로 조립하여 AI 어시스턴트에게 보냅니다.

오른쪽 서랍

AI 어시스턴트

확장하려면 오른쪽 열 중앙에 있는 "AI Assistant" 아이콘을 클릭하세요. 지원:

• 자연어를 사용하여 변경될 논리 부분을 설명하면 어시스턴트가 차이점 미리보기를 제공합니다.
• Slash 명령: /execute、/validate、/export、/new、/undo、/help;
• /undo는 어시스턴트의 수정을 되돌립니다(최대 10단계). 편집기 자체의 Ctrl / Cmd + Z도 AI의 변경을 단계별로 실행 취소할 수 있습니다.

전체 기능 보기 AI 도우미를 사용하여 조율.

중단점 패널

이 패널은 디버그 모드에서 실행이 실행될 때 켜집니다. 일시 중지 중에 중단점을 추가/삭제하고, 적중 기록을 보고, 변수를 편집할 수 있습니다. 세부정보 보기 중단점 디버깅.

변수 스냅샷

단계를 클릭하면 단계가 실행되기 전에 사용 가능한 모든 변수(var:* / steps.*.data / classifier.* / credential.* 포함)(자격 증명 값은 둔감하게 표시됩니다).

공동 편집 잠금

한 번에 한 사람만 동일한 작업 흐름을 편집할 수 있습니다. 먼저 입장하는 사람이 잠금을 얻습니다. 다른 사람이 액세스하면 읽기 전용 모드가 되며 상태 표시줄에 "xxx 편집 중"이 표시됩니다. 잠금은 5분 동안 활동이 없으면 자동으로 해제되거나 관리자에 의해 강제로 잠금 해제됩니다.

자주 사용하는 단축키

편집기에서 가장 일반적으로 사용되는 것 중 일부 - 전체 목록 보기 키보드 단축키.

• Ctrl / Cmd + S — 저장
• Ctrl / Cmd + E — 실행(대화상자 열기)
• Ctrl / Cmd + Shift + V — 확인
• Ctrl / Cmd + Z — 실행 취소(YAML 편집기 + AI 도우미 모두에 적용 가능)
• Ctrl / Cmd + Shift + Z — 다시 실행
• Alt + A — AI 보조 서랍 전환
• Alt + B — 중단점 패널 전환

다음 단계

• 8단계 유형 — 각 단계 작성 방법에 대한 권위 있는 참고 자료
• YAML 구문 참조 — 보다 심층적인 현장 참조
• AI 어시스턴트 — 자연어를 사용하여 작업 흐름 변경