주요 콘텐츠로 건너뛰기
문서달리다수동 실행

워크플로를 수동으로 실행

편집기에서 '실행'을 누르거나 목록에서 일괄 실행하고, 오른쪽의 실시간 이벤트 스트림을 파악할 수 있습니다.

수동 실행은 워크플로를 실행하는 가장 기본적인 방법입니다. 개발 및 디버깅, 일회성 비즈니스 요구 사항, 정기 및 예정되지 않은 보고서는 모두 이 입구를 사용합니다. 이 문서에서는 "어디를 클릭해야 하는지, 대화 상자의 각 항목은 무엇인지, 실행 후 표시되는 내용"에 대해 명확하게 설명합니다.

수동 실행 입구 3개

1. 편집기에서 "실행"을 클릭하세요.

가장 일반적으로 사용됩니다. 워크플로를 변경하고 즉시 사용해 보고 싶은 사용자에게 적합합니다.

2. 워크플로우 목록 카드에서 "▶실행"을 클릭합니다.

이미 안정적이고 편집기를 열고 싶지 않은 작업 흐름에 적합합니다.

3. 일괄 실행

워크플로 목록 상단의 여러 항목을 확인하고 "Batch Execute"를 클릭하세요. 팝업 창에서:

  • 각 워크플로에 대해 별도로 변수를 입력합니다(또는 기본값을 직접 사용).
  • 동시에 열리는 회선 수를 제어하려면 동시성 수(1~10)를 선택하세요.
  • 실패 전략 선택: 하나의 실패가 다른 실패를 방해할지 여부

대화 상자 해체 수행

No matter which entry is entered, after clicking "Execute", a dialog box with the same structure will pop up:

매개변수(변수) 영역

Workflow.variables별로 각 매개변수를 자동으로 표시합니다.

  • 기본값으로 미리 채우기
  • 필수 필드는 빨간색 별표로 표시됩니다.
  • 설명 위에 마우스를 올리면 설명을 볼 수 있습니다.
  • 열거 유형은 드롭다운 메뉴를 사용합니다.
  • 배열/객체 유형은 JSON을 직접 편집합니다.

드라이런 스위치

처음 실행 시 확인란을 선택하는 것이 좋습니다. 자세한 내용은 위의 빠른 시작을 참조하세요.

트리거 소스(디버그)

기본 매뉴얼. 디버깅을 위해 "Timed Trigger" 또는 "Webhook Trigger"를 시뮬레이션하려는 경우 전환할 수 있습니다. 일부 단계의 조건은 이에 따라 달라질 수 있습니다.

복구 스위치(Pro+)

워크플로에서 Recovery.autoResumeOnRestart를 선언하면 "이 실행에 대해 자동 계속이 허용되는지 여부" 대화 상자에 추가 토글이 있습니다. 세부정보 보기 자동 재개.

디버그 스위치(Pro+)

확인 후 이 실행은 디버그 모드로 전환됩니다. 중단점을 설정하고, 단일 단계 실행을 수행하고, 변수를 보고, 변수를 수정할 수 있습니다. 세부정보 보기 중단점 디버깅.

시작 후 동작

"실행 시작"을 클릭한 후:

  1. 프런트 엔드는 즉시 실행 기록을 생성하고(PENDING 상태) 페이지가 자동으로 실행 세부 정보로 이동합니다.
  2. 平台调度器拉起执行（通常 < 200ms 内从 PENDING 变 RUNNING）。
  3. 페이지는 SSE 연결을 설정하고 각 이벤트가 푸시되어 UI를 실시간으로 새로 고칩니다.
  4. 캔버스의 "실행 단계"가 강조 표시됩니다. 완료된 단계는 녹색으로 강조 표시되고 실패한 단계는 빨간색으로 강조 표시됩니다.

오른쪽의 라이브 이벤트 스트림

실행 세부정보 페이지 오른쪽 열은 '로그 + 이벤트' 혼합 스트림입니다. 중요한 이벤트 유형:

  • execution.started / execution.finished — 실행의 시작과 끝
  • step.started / step.completed / step.failed / step.skipped — 단계 수명주기
  • step.log — 코드 단계의 stdout / stderr
  • agent.message — 상담원의 중간 진술(group_chat에서 가장 일반적임)
  • agent.tool_call — 에이전트 호출 도구 + 매개변수 + 반환 값
  • artifact.emitted — 제품제작(Markdown/Excel/Image/JSON)
  • breakpoint.hit — 중단점 적중
  • approval.requested / approval.granted / approval.denied

각 이벤트에는 타임스탬프, 수준(디버그/정보/경고/오류) 및 속성 단계가 있습니다. 필터 표시줄을 사용하면 유형/수준별로 필터링할 수 있습니다.

도중에 취소

실행 세부정보 페이지의 오른쪽 상단에 있는 "취소" 버튼을 사용하면 RUNNING 실행을 적극적으로 중지할 수 있습니다.

  1. 상태가 먼저 CANCELING으로 변경됩니다.
  2. 현재 실행 중인 단계는 인터럽트 신호를 수신합니다(코드 단계는 SIGTERM을 수신하고 LLM 단계는 적극적으로 중단됩니다).
  3. 모든 단계가 중지되면 상태가 CANCELLED로 변경됩니다.

시간이 많이 걸리는 일부 작업(긴 네트워크 시간 초과)은 즉시 응답하지 않을 수 있습니다. 샌드박스 수준의 하드 시간 초과가 이를 처리하며 최대 5분 후에 확실히 중지됩니다.

실행 후 결과를 보는 방법

실행 세부정보 페이지

  • 간트 차트 — 전체 일정 및 각 단계에 소요되는 시간
  • 단계 목록 — 순차적 단계 상태 개요
  • 단계 세부정보 — 입력/출력/이벤트 로그/도구 호출
  • 변수 패널 — 이 단계가 실행되기 전 사용 가능한 모든 변수의 스냅샷
  • 제품 칼럼 — 생성된 파일입니다. 미리보거나 다운로드하려면 클릭하세요.

토큰 및 비용

상단 요약 표시줄에는 총 소요 시간, 총 토큰(입/출), 총 비용(USD)이 표시됩니다. 각 LLM 단계의 개별 소비를 보려면 클릭하여 확장하세요.

일반적인 작업

동일한 매개변수로 다시 실행

실행 세부 정보 페이지의 오른쪽 상단에 있는 "재시도" 버튼은 이 실행 변수를 사용하여 즉시 새 실행을 시작합니다. 두 결과를 비교하는 것이 편리합니다.

중간에 특정 단계부터 다시 실행

단계 옆에 있는 "이 단계에서 다시 시도"를 클릭하세요. 이전에 완료된 단계의 결과는 유지되며 이 단계부터 다시 시작할 수 있습니다. "특정 단계 오류를 수정한 후 처음부터 돈을 쓰고 싶지 않은 경우"에 적합합니다.

수출실행보고서

상단의 "내보내기"는 전체 실행의 메타데이터 + 단계 세부 정보 + 제품을 JSON으로 내보낼 수 있습니다. 나중에 검토하거나 동료와 공유하는 데 적합합니다.

수동 실행은 언제 사용해야 하며 언제 다른 트리거를 사용해야 합니까?

  • 매뉴얼 — 개발 및 디버깅, 일회성 요구 사항, "지금 실행하고 싶습니다"
  • 예약 실행 — 고정 주파수 자동 트리거링
  • 웹훅 — 외부 시스템 이벤트 기반

다음 단계