> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/workflow/workflow-execution.md).

# 워크플로 실행

이 문서에서는 워크플로의 실행 방법·미리보기 실행·트리거 설정을 설명합니다.

## 실행 트리거

워크플로는 다음 4가지 방법으로 시작할 수 있습니다.

| 트리거            | 설명                               |
| -------------- | -------------------------------- |
| 수동 실행          | 화면에서 즉시 워크플로를 시작합니다              |
| API 트리거        | HTTP 요청을 통해 외부 시스템에서 워크플로를 시작합니다 |
| 예약             | 정기 일정에 따라 워크플로를 자동 실행합니다         |
| GitHub Webhook | GitHub 이벤트를 계기로 워크플로를 자동 실행합니다   |

{% hint style="warning" %}
기본적으로 같은 워크플로를 여러 번 실행하면 동시에 실행됩니다. **API 액세스**, **예약**, **GitHub Webhook**에서는 트리거 설정에서 **병렬로 실행**과 **이전 실행 취소**를 선택할 수 있습니다.
{% endhint %}

## 수동 실행

워크플로는 목록 화면 또는 편집기 화면에서 수동으로 시작할 수 있습니다.

**목록 화면에서 실행하기**

워크플로 목록의 각 행 작업 메뉴에서 \*\*실행(▶실행 아이콘)\*\*을 클릭하십시오.

{% hint style="info" %}
워크플로에 사용자 입력이 설정되어 있지 않은 경우, 확인 화면이 표시되며 입력을 한 후 그대로 실행할 수 있습니다.
{% endhint %}

## 미리보기 실행

미리보기 실행에서는 일반 실행과 마찬가지로 실행 기록에는 기록되지만, 목록에서 "미리보기" 레이블이 붙어 운영 실행과 구별하여 확인할 수 있습니다.

또한 미리보기 실행으로 생성된 아티팩트는 "아티팩트" 목록에는 표시되지만, 지식 베이스에는 인덱싱되지 않습니다(검색 대상에서 제외됩니다).

### 워크플로 전체를 미리보기 실행하기

1. 편집기 화면을 여십시오.
2. 캔버스 오른쪽 아래의 도구 모음에 있는 \*\*미리보기(미리보기 아이콘)\*\*를 클릭하십시오.
3. 실행 대화 상자가 열립니다. 사용자 입력이 설정되어 있는 경우, 실행 전에 값을 확인·변경할 수 있습니다.
4. **워크플로 실행**을 클릭하여 실행을 시작하십시오.

실행 결과는 인스펙터의 **출력** 탭에서 확인할 수 있습니다.

미리보기 실행 중, 대상 블록을 선택하면 인스펙터 헤더에 **실행 중** 배지가 표시됩니다. 실행이 완료될 때까지 **세부 정보** 탭의 편집은 일시적으로 잠깁니다(**출력** 탭과 삭제 버튼은 평소대로 조작할 수 있습니다).

### 특정 블록까지 미리보기 실행하기

블록 왼쪽에 표시된 \*\*미리보기(미리보기 아이콘)\*\*를 클릭하면, 그 블록까지의 처리만 미리보기 실행할 수 있습니다. 부분적으로 동작을 확인하고 싶을 때 편리합니다.

<figure><img src="/files/FgISm4wy5toV3IrAmTCV" alt="특정 블록까지 미리보기 스크린샷"><figcaption><p>특정 블록까지 미리보기</p></figcaption></figure>

## 트리거 설정

워크플로 편집 화면 오른쪽 위에 있는 **기타 작업**에서 **트리거**를 클릭하면, 자동 실행 트리거를 설정할 수 있습니다.

<figure><img src="/files/J3TkHI7SAUJenVBurRuB" alt="트리거 설정 화면 스크린샷"><figcaption><p>트리거 설정 화면</p></figcaption></figure>

### API 액세스

HTTP 요청을 보내면 외부 시스템이나 CI/CD 파이프라인에서 워크플로를 시작할 수 있습니다.

<figure><img src="/files/EoQOUNh4OGNbVYmu3adm" alt="API 액세스 설정 스크린샷"><figcaption><p>API 액세스 설정</p></figcaption></figure>

1. **API 액세스** 스위치를 활성화하십시오.
2. **동시 실행 정책**에서 같은 워크플로의 이전 API 실행이 아직 대기 중이거나 실행 중일 때, 새 요청을 어떻게 처리할지 선택하십시오.

| 선택지      | 내용                                                       |
| -------- | -------------------------------------------------------- |
| 병렬로 실행   | 새 실행을 시작하고 이전 실행도 그대로 계속합니다                              |
| 이전 실행 취소 | 같은 워크플로의 API 실행에서 대기 중이거나 실행 중인 이전 실행을 취소한 후 새 실행을 시작합니다 |

3. 표시되는 **API 엔드포인트**의 URL을 복사하십시오.
4. `x-api-key` 헤더에 API 키를 포함한 POST 요청을 보내십시오.

```http
POST {API 엔드포인트 URL}
x-api-key: {API 키}
Content-Type: application/json

{
  "필드명": "값"
}
```

{% hint style="info" %}
API 키 관리는 **설정 > API 키**에서 할 수 있습니다.
{% endhint %}

### 예약

정기 일정에 따라 워크플로를 자동 실행할 수 있습니다.

1. **예약** 스위치를 활성화하십시오.
2. **빈도**에서 **매시간**, **매일**, **평일**, **매주**, **사용자 지정** 중 하나를 선택하십시오.
3. **실행할 분** 또는 **시간**을 설정하고, 필요에 따라 **요일**, **시간대**, **cron 표현식**을 지정하십시오.
4. 일정 미리보기와 **다음 실행** 목록을 확인한 뒤, **동시 실행 정책**에서 이전 예약 실행이 아직 대기 중이거나 실행 중일 때 새 실행을 어떻게 처리할지 선택하십시오.

| 선택지      | 내용                                                 |
| -------- | -------------------------------------------------- |
| 병렬로 실행   | 새 실행을 시작하고 이전 실행도 그대로 계속합니다                        |
| 이전 실행 취소 | 같은 워크플로의 대기 중이거나 실행 중인 이전 예약 실행을 취소한 후 새 실행을 시작합니다 |

5. **일정 저장**을 클릭하십시오.

{% hint style="warning" %}
**사용자 지정**을 사용하는 경우, 일정 실행 간격은 최소 15분 이상이어야 합니다.
{% endhint %}

{% hint style="info" %}
예약으로 트리거되는 경우, 워크플로의 사용자 입력에는 기본값이 사용됩니다.
{% endhint %}

### GitHub Webhook

GitHub 이벤트를 계기로 워크플로를 자동 실행할 수 있습니다.

{% hint style="warning" %}
GitHub Webhook을 사용하려면 사전에 워크스페이스에 GitHub를 연동해야 합니다. **설정**에서 GitHub 연동을 진행하십시오.
{% endhint %}

<figure><img src="/files/FoAq6hUzjyO4yywk9X77" alt="GitHub Webhook 설정 스크린샷"><figcaption><p>GitHub Webhook 설정</p></figcaption></figure>

1. **GitHub Webhook** 스위치를 활성화하십시오.
2. **다음 이벤트에서 트리거**에서 워크플로를 시작할 이벤트를 선택하십시오.

| 이벤트    | 내용                                   |
| ------ | ------------------------------------ |
| 푸시     | 코드가 브랜치에 푸시되었을 때 트리거됩니다              |
| 풀 리퀘스트 | 풀 리퀘스트가 열리거나, 닫히거나, 업데이트되었을 때 트리거됩니다 |
| 릴리스    | 새 릴리스가 게시되었을 때 트리거됩니다                |

3. **동시 실행 정책**에서 같은 조건에 일치하는 GitHub 이벤트의 이전 실행이 아직 대기 중이거나 실행 중일 때, 새 이벤트를 어떻게 처리할지 선택하십시오.

| 선택지      | 내용                                                                  |
| -------- | ------------------------------------------------------------------- |
| 병렬로 실행   | 새 실행을 시작하고 이전 실행도 그대로 계속합니다                                         |
| 이전 실행 취소 | 같은 워크플로·같은 브랜치·같은 이벤트에 일치하는 대기 중이거나 실행 중인 이전 실행을 취소한 후, 새 실행을 시작합니다 |

4. 필요에 따라 **리포지토리**에서 대상 리포지토리를 선택하십시오. 선택하지 않은 경우, 연동된 모든 리포지토리가 대상이 됩니다.
5. 필요에 따라 **브랜치**에 브랜치 패턴을 입력하십시오(예: `main`, `release/*`). 입력하지 않은 경우, 모든 브랜치가 대상이 됩니다.

{% hint style="info" %}
GitHub에 의해 트리거되는 경우, 워크플로의 사용자 입력에는 기본값이 사용됩니다.
{% endhint %}

## 실행 중 조작

### 실행 중지

실행 중이거나 대기 중인 워크플로를 수동으로 중지할 수 있습니다.

1. 실행 세부 정보 화면을 여십시오.
2. **중지**를 클릭하십시오.

중지한 워크플로는 상태가 **취소됨**이 됩니다. 나중에 재개할 수도 있습니다.

{% hint style="info" %}
실행에는 타임아웃이 없습니다. 처리가 완료될 때까지 자동으로 중지되지 않습니다. 장시간 실행이 예상되는 경우, 수동으로 중지 작업을 수행하십시오.
{% endhint %}

{% hint style="info" %}
**이전 실행 취소**를 선택한 경우, 새 API 요청, 예약 실행, GitHub 이벤트가 도착했을 때 이전 실행이 자동으로 취소될 수 있습니다. 실행 세부 정보 헤더에는 **새 트리거로 인해 취소됨**이라고 표시됩니다.
{% endhint %}

### 실행 재개

중지(취소됨)한 워크플로를 재개할 수 있습니다.

1. 실행 세부 정보 화면을 여십시오.
2. **재개**를 클릭하십시오.

### 여기서 편집 후 재실행

과거 실행 결과를 확인하면서 특정 AI 에이전트 블록의 프롬프트를 다시 작성하여 재실행할 수 있습니다. 상위 블록의 출력은 그대로 인계되므로, 상위 처리를 다시 할 필요가 없습니다. 프롬프트 편집은 이번 재실행에만 적용되며, 워크플로 템플릿 자체는 변경되지 않습니다.

1. 워크플로의 실행 세부 정보 화면을 여십시오.
2. 그래프에서 재실행할 AI 에이전트 블록을 클릭하여 선택하십시오.
3. 인스펙터, 또는 그래프 노드의 호버 버튼에서 **여기서 편집 후 재실행**을 클릭하십시오.
4. 대화 상자에서 프롬프트를 편집하고 **워크플로 재실행**을 클릭하십시오.

새 실행이 작성되어, 상위 블록의 출력과 산출물을 인계한 채로 편집한 블록부터 뒤가 재실행됩니다.

{% hint style="info" %}
보관된 워크플로의 실행에서는 여기서 편집 후 재실행을 할 수 없습니다.
{% endhint %}

### 블록 검토

블록에 승인 플로가 설정되어 있는 경우, 그 블록의 실행 완료 후에 **검토 대기 중** 상태가 됩니다. 담당자가 검토할 때까지 워크플로는 다음 블록으로 진행되지 않습니다.

<figure><img src="/files/gLL6YnMvgiwe0IE06WgX" alt="블록 검토 스크린샷"><figcaption><p>블록 검토</p></figcaption></figure>

"검토"를 클릭하면 출력 확인 화면이 표시됩니다.

* **승인**을 클릭하면 워크플로가 다음 블록으로 진행됩니다.
* **변경사항으로 승인**을 클릭하면 블록의 출력 내용을 편집한 후에 승인할 수 있습니다.
* **거부**를 클릭하면 워크플로 실행이 실패로 종료됩니다.

## 실행 상태

| 상태      | 설명                                      |
| ------- | --------------------------------------- |
| 대기 중    | 실행 시작을 기다리는 상태                          |
| 실행 중    | 처리가 진행 중인 상태                            |
| 검토 대기 중 | 블록 승인을 기다리는 상태                          |
| 완료      | 모든 블록이 정상적으로 완료된 상태                     |
| 실패      | 오류가 발생하여 처리가 중단된 상태                     |
| 취소됨     | 사용자가 수동으로 중지했거나, 새로운 일치 조건의 트리거로 대체된 상태 |
| 건너뜀     | 조건부 블록 등에 의해 실행에서 제외된 상태                |

{% hint style="warning" %}
어느 블록이든 실패하면, 그 시점에서 후속 블록은 실행되지 않고 워크플로 전체가 **실패**로 종료됩니다. "블록이 실패해도 후속 처리를 계속한다" 옵션은 없습니다.
{% endhint %}

{% hint style="info" %}
조건부 분기로 루프를 구성한 경우, 최대 루프 횟수를 초과하면 강제로 오류로 종료됩니다. 최대 루프 횟수는 블록 설정에서 변경할 수 있으며, 설정하지 않은 경우 3회가 사용됩니다.
{% endhint %}

## 문제 해결

### 사용자 입력 유효성 검사 오류

| 메시지                                                                    | 원인                           | 해결 방법                       |
| ---------------------------------------------------------------------- | ---------------------------- | --------------------------- |
| 텍스트 필드 "{label}"은(는) 비워둘 수 없습니다. 값을 입력하세요.                             | 필수 텍스트 필드에 값이 입력되지 않음        | 해당 필드에 값을 입력한 후 실행하십시오      |
| 숫자 필드 "{label}"은(는) 비워둘 수 없습니다. 값을 입력하세요.                              | 필수 텍스트 필드나 숫자 필드에 값이 입력되지 않음 | 해당 필드에 값을 입력한 후 실행하십시오      |
| 파일 "{label}"을(를) 찾을 수 없거나 더 이상 사용할 수 없습니다. 파일을 다시 업로드하거나 다른 파일을 선택하세요. | 업로드된 파일이 삭제되었거나 사용할 수 없게 됨   | 파일을 다시 업로드하거나 다른 파일을 선택하십시오 |

### 사용 제한 오류

| 상황                              | 원인             | 해결 방법                       |
| ------------------------------- | -------------- | --------------------------- |
| "사용 한도에 도달했습니다"라고 표시되어 실행할 수 없음 | 조직의 사용 제한에 도달함 | 관리자에게 연락하여 사용 제한 상향을 요청하십시오 |

### GitHub Webhook 오류

| 상황                            | 원인                         | 해결 방법                   |
| ----------------------------- | -------------------------- | ----------------------- |
| GitHub Webhook 스위치를 활성화할 수 없음 | 워크스페이스에 GitHub가 연동되어 있지 않음 | **설정**에서 GitHub를 연동하십시오 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genesis.autify.com/features-ko/workflow/workflow-execution.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.