> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ko/manage/manage-workflows.md).

# Workflows 관리

폴더에서 워크플로를 정리하고 웹 앱, REST API, Python SDK 및 CLI를 통해 관리하세요.

## 정보

[Roboflow Workflows](https://docs.roboflow.com/workflows/ko/build/create-a-workflow.md) 는 웹 앱에서 만들고 호스팅 엔드포인트로 배포하는 시각적 컴퓨터 비전 파이프라인입니다. 이 페이지에서는 웹 앱, HTTP API, Python SDK, CLI를 통해 Workspace의 Workflows를 구성하고, 목록을 확인하고, 가져오고, 만들고, 업데이트하고, 포크하는 방법을 설명합니다. 이미지나 동영상 스트림에서 Workflow를 실행하는 방법은 다음을 참조하세요. [Workflow 배포](https://docs.roboflow.com/workflows/ko/deploy/deploy-a-workflow.md).

## 웹 앱

### Workflows 구성

관련된 Workflows를 그룹화하려면 Workflows 페이지에서 폴더 추가 버튼을 클릭하고 이름을 입력한 다음 "폴더 만들기"를 클릭합니다. Workflow를 이동하려면 점 3개 메뉴를 열고 "Workflow 이동"을 선택한 다음 대상을 지정하고 "Workflow 이동"을 클릭합니다.

역할에 다음 권한을 관리할 수 있는 권한이 있다면 [폴더 권한](https://docs.roboflow.com/datasets/manage/project-folders/project-folder-permissions)폴더의 점 3개 메뉴를 열고 "권한 설정"을 선택하여 해당 폴더의 Workflows를 읽거나 수정할 수 있는 사용자를 제어합니다.

## HTTP API

이 엔드포인트는 Workflows를 관리합니다. Workflow를 실행하지는 않습니다. Workflow는 Serverless Hosted API(예: `https://serverless.roboflow.com`).

### 프로젝트 기본 Workflow

각 Project에는 호스팅 모델 엔드포인트의 기반이 되는 기본 Workflow가 있습니다. 이 엔드포인트를 사용해 해당 Workflow를 읽거나 Workflow에서 실행할 모델을 선택하세요. 데이터 수집을 활성화하거나, 수집 한도를 설정하거나, 검토 대기열의 이미지 목록을 확인하려면 다음을 사용하세요. [Active Learning HTTP API](https://docs.roboflow.com/deployment/monitoring-and-analytics/active-learning#http-api).

#### 프로젝트 기본 Workflow 가져오기

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/{project}/deploy" method="get" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

#### 프로젝트 기본 Workflow 모델 선택

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/{project}/deploy/model" method="post" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflow 목록 보기

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/workflows" method="get" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflow 가져오기

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/workflows/{workflowId}" method="get" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflow 버전 목록 보기

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/workflows/{workflowId}/versions" method="get" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflow 만들기

사양을 다음과 같이 감싸서 `{"specification": {...}}` JSON 문자열로 `config`에 전송합니다. Python SDK는 이 래핑을 대신 처리하지만, HTTP를 직접 호출할 때는 직접 래핑해야 합니다.

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/createWorkflow" method="post" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflow 업데이트

업데이트하면 사양 전체가 대체되고 새 버전이 저장됩니다. Workflow에 배포 게이트가 없으면 해당 버전이 게시됩니다. 게이트가 설정된 Workflow는 직접 게시할 수 없습니다. 대신 다음을 사용하세요. [버전 저장 및 게시](#save-and-publish-a-version). Workflow의 `id` 는 URL 슬러그가 아니라 Workflow 목록에서 가져온 값을 보내세요. 여기서는 프로젝트 기본 Workflow를 업데이트할 수 없습니다.

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/updateWorkflow" method="post" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### 버전 저장 및 게시

저장된 버전을 선택하거나 게시하지 않은 채 새 후보 버전을 저장한 다음, 필수 검사를 실행하고 통과한 버전을 게시합니다. 작업 스키마와 필수 scope를 확인하려면 Workspace의 배포 게이트 OpenAPI 문서를 가져오세요.

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/workspaces/{workspace}/workflows/deploy-gates/openapi.json" method="get" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

아래의 모든 경로는 다음으로 시작합니다. `https://api.roboflow.com/workspaces/{workspace}/workflows`:

1. 원하는 정의가 이미 포함된 저장된 버전이 있으면 해당 버전을 다시 사용하세요. 새 후보 버전이 필요하면 전체 정의와 함께 다음을 전송합니다. `POST /{workflowId}/versions` 이 요청은 Auto-Publish 모드에서도 게시하거나 검사를 시작하지 않고 초안으로 저장합니다.
2. Eval 게이트의 경우 다음을 전송합니다. `POST /{workflowId}/versions/{versionId}/deploy-gates/run`. 추론 크레딧이 사용될 수 있습니다. 수동 승인의 경우 다음을 확인하고 `GET /{workflowId}/versions/{versionId}/deploy-gates/manual-approval` 승인 자격이 있는 사용자가 Roboflow 앱에서 승인하도록 하세요. 수동 승인만 필요한 버전은 실행 요청이 필요하지 않으며, API로는 승인할 수 없습니다.
3. 검사가 보류 중인 동안 다음을 폴링합니다. `GET /{workflowId}/versions/{versionId}/deploy-gates` 게이트가 실패하거나, 오류가 발생하거나, 취소되거나, 승인자가 버전을 거부하면 작업을 중단하고 결과를 보고합니다. 다음 요청은 `POST /{workflowId}/versions/{versionId}/deploy` 다음 조건을 충족할 때만 `publishable` 은 `true`입니다. 자동 게시 모드에서는 모든 게이트를 통과한 후 가장 최근에 저장된 초안이 자동으로 게시될 수 있습니다.

저장 및 검사 실행 작업에는 UUID v4 `Idempotency-Key` 헤더가 필요합니다. 동일한 요청을 재시도할 때 이 값을 재사용하세요.

### 워크플로 포크하기

이 워크스페이스 또는 Roboflow 템플릿의 워크플로를 이 워크스페이스에 복사합니다. 폴더 범위 API 키를 사용하면 워크플로 만들기와 동일한 폴더 규칙에 따라 복사본이 배치됩니다. 다른 워크스페이스의 워크플로를 복사하려면 해당 워크플로의 [공유 링크](https://docs.roboflow.com/workflows/ko/manage/share-a-workflow.md) 그곳에서 포크하세요.

{% openapi src="/files/beb516c254028e5c3df57f808341d40dffa59fe5" path="/{workspace}/forkWorkflow" method="post" %}
[manage-workflows.yaml](https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### 워크플로 삭제

워크플로를 삭제하면 휴지통으로 이동하며, 여기서 복원할 수 있습니다. 자세한 방법은 [휴지통 관리](https://docs.roboflow.com/platform/workspaces/trash#delete-a-workflow).

## Python SDK

[Roboflow Workflows](https://docs.roboflow.com/workflows/ko/build/create-a-workflow.md) 는 시각적 컴퓨터 비전 파이프라인입니다. SDK는 목록 조회, 가져오기, 생성을 `Workspace`에서 바로 제공합니다. 업데이트, 포크, 삭제 기능은 저수준 `rfapi` 어댑터.

### 워크플로 나열

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

workflows = workspace.list_workflows()
for w in workflows:
    print(w["id"], w["name"], w["url"])
```

### 워크플로 가져오기

```python
workflow = workspace.get_workflow("slow-webhooks")
print(workflow["specification"])
```

이 `url` 인수는 워크플로의 슬러그(웹 앱의 URL 표시줄에서 확인 가능)이며, Firestore ID가 아닙니다.

### 워크플로 만들기

```python
workflow = workspace.create_workflow(
    name="My Workflow",
    definition={
        "version": "1.0",
        "inputs": [...],
        "steps": [...],
        "outputs": [...],
    },
)
print(workflow["id"], workflow["url"])
```

통과 `definition=None` 나중에 웹 앱에서 편집할 빈 워크플로 셸을 만들기 위해 사용합니다.

SDK는 래핑되지 않은 사양 딕셔너리(`{"version": ..., "steps": ...}`) 또는 래핑된 사양(`{"specification": {...}}`); 래핑을 자동으로 정규화하고 UTF-8 BOM이 있으면 제거합니다.

### 워크플로 업데이트

`Workspace` 에서는 업데이트 기능을 직접 제공하지 않습니다. 저수준 어댑터를 사용하세요.

```python
from roboflow.adapters import rfapi

rfapi.update_workflow(
    api_key="YOUR_API_KEY",
    workspace_url=workspace.url,
    workflow_id=workflow["id"],
    workflow_name="My Workflow",
    workflow_url="my-workflow",
    config={"version": "1.0", "steps": [...]},
)
```

### 워크플로 포크

워크플로를 워크스페이스 내에서 복사합니다. Roboflow 템플릿에서 시작하려면 `source_workspace` 를 `templates`:

```python
from roboflow.adapters import rfapi

forked = rfapi.fork_workflow(
    api_key="YOUR_API_KEY",
    workspace_url=workspace.url,
    source_workspace=workspace.url,
    source_workflow="my-workflow",
    name="My Fork",       # 선택 사항. 기본값은 원본 이름입니다
    url="my-fork",        # 선택 사항. 기본값은 자동 생성된 슬러그입니다
)
```

### 워크플로 버전 목록

```python
versions = rfapi.list_workflow_versions(
    api_key="YOUR_API_KEY",
    workspace_url=workspace.url,
    workflow_url="my-workflow",
)
```

### 워크플로 삭제(소프트 삭제)

```python
rfapi.delete_workflow(api_key="YOUR_API_KEY", workspace_url=workspace.url, workflow_url="my-workflow")
```

이렇게 하면 워크플로가 워크스페이스의 [휴지통](https://docs.roboflow.com/platform/workspaces/trash#python-sdk) 으로 이동하며, 영구 삭제되기 전까지 30일 동안 보관됩니다. 다음을 사용해 복원하세요. `Workspace.restore_from_trash("workflow", id)` - 자세한 내용은 [삭제 및 복원](https://docs.roboflow.com/platform/workspaces/trash#workflows).

### 워크플로 실행

워크플로 실행 기능은 [Inference SDK](https://inference.roboflow.com) 와 [Workflows runtime](https://docs.roboflow.com/workflows/ko/deploy/deploy-a-workflow.md)에 있으며, `roboflow` 패키지에는 없습니다. Python에서는 다음과 같이 사용합니다.

```python
from inference_sdk import InferenceHTTPClient, InferenceConfiguration

client = InferenceHTTPClient(
    api_url="https://serverless.roboflow.com",
    api_key="YOUR_API_KEY",
).configure(InferenceConfiguration(api_key_transport="header"))
result = client.run_workflow(
    workspace_name="my-workspace",
    workflow_id="my-workflow",
    images={"image": "photo.jpg"},
)
```

## CLI

명령줄에서 워크플로를 나열하고, 만들고, 업데이트하고, 포크하고, 버전을 관리할 수 있습니다.

### Workflow 목록 보기

```bash
roboflow workflow list
```

```bash
roboflow workflow list --json
```

### 워크플로 세부정보 가져오기

```bash
roboflow workflow get my-workflow
```

```bash
roboflow workflow get my-workflow --json
```

### Workflow 만들기

```bash
roboflow workflow create --name "My Workflow"
```

JSON 정의 파일 사용:

```bash
roboflow workflow create --name "My Workflow" --definition workflow.json
```

#### 옵션

| 플래그             | 설명             |
| --------------- | -------------- |
| `--name`        | 워크플로 이름(필수)    |
| `--definition`  | JSON 정의 파일의 경로 |
| `--description` | 워크플로 설명        |

### Workflow 업데이트

워크플로 정의 업데이트:

```bash
roboflow workflow update my-workflow --definition updated.json
```

### Workflow 버전 목록 보기

```bash
roboflow workflow version list my-workflow
```

```bash
roboflow workflow version list my-workflow --json
```

### 워크플로 포크하기

현재 워크스페이스의 워크플로 포크하기:

```bash
roboflow workflow fork my-workflow
```

Roboflow 템플릿 포크하기:

```bash
roboflow workflow fork templates/general-segmentation-api
```

### JSON 출력

모든 워크플로 명령은 `--json` 을 지원하며, 구조화된 출력을 제공합니다:

```bash
roboflow workflow list --json | jq '.[].name'
roboflow workflow create --name "Test" --json
```

종료 코드: 0 = 성공, 1 = 오류, 2 = 인증 오류, 3 = 찾을 수 없음.

## MCP 서버

AI 에이전트를 [MCP 서버](https://docs.roboflow.com/agents/mcp-server) 에 연결해 워크플로를 만들고 실행하세요.

다음을 사용하세요: `workflow_versions_save` 초안을 저장하고, `workflow_version_deploy_gates_run` 을 Eval 검사에 사용하고, `workflow_version_deploy_gates_get` 을 호출해 모든 게이트의 판정 결과를 확인하세요. 수동 승인을 받으려면 `workflow_version_approval_get` 을 읽고 자격을 갖춘 사람에게 Roboflow 앱에서 결정해 달라고 요청하세요. 다음을 호출하세요: `workflow_version_deploy` 단, `publishable` 이 `true`. MCP는 Workflow 버전을 승인할 수 없습니다.

<table data-search="false"><thead><tr><th width="290">도구</th><th>설명</th></tr></thead><tbody><tr><td><code>workflows_list</code></td><td>작업공간에 저장된 Workflow 목록을 표시합니다.</td></tr><tr><td><code>workflows_get</code></td><td>저장된 Workflow의 세부 정보를 가져옵니다.</td></tr><tr><td><code>workflows_create</code></td><td>새 Workflow를 만들고 저장합니다.</td></tr><tr><td><code>workflows_update</code></td><td>저장된 Workflow의 이름과 정의를 업데이트합니다.</td></tr><tr><td><code>workflows_run</code></td><td>저장된 Workflow를 하나 이상의 이미지에서 실행합니다.</td></tr><tr><td><code>workflows_delete</code></td><td>저장된 Workflow를 삭제하여 작업공간 휴지통으로 이동합니다.</td></tr></tbody></table>
