> 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/reference/ko/inference/inference-sdk/workflows.md).

# Workflows

workflow ID 또는 인라인 사양으로 inference-sdk 클라이언트를 통해 Roboflow Workflow를 실행하세요.

로컬 추론 서버를  `inference server start`로 시작한 다음 Workflow를 실행하세요:

```python
from inference_sdk import InferenceHTTPClient, InferenceConfiguration

# ROBOFLOW_API_KEY를 Roboflow API 키로 바꾸세요
CLIENT = InferenceHTTPClient(
    api_url="http://localhost:9001",
    api_key="ROBOFLOW_API_KEY"
).configure(InferenceConfiguration(api_key_transport="header"))

CLIENT.run_workflow(
    specification={
        "version": "1.0",
        "inputs": [
            {"type": "InferenceImage", "name": "image"},
            {"type": "InferenceParameter", "name": "my_param"},
        ],
        # ...
    },
    # 또는
    # workspace_name="my_workspace_name",
    # workflow_id="my_workflow_id",

    images={
        "image": "url or your np.array",
    },
    parameters={
        "my_param": 37,
    },
)
```

다음 중 하나를 수행합니다.  `specification` 에 Workflow 정의를 제공하며, 정의 방법은  [Workflow 정의](https://docs.roboflow.com/workflows/developer-guide/developer-guide/definitions)를 참조하세요. 또는  `workspace_name` 과  `workflow_id` 를 모두 지정하여 Roboflow 앱에 미리 정의된 Workflow를 사용합니다. `workspace_name` 브라우저에 워크스페이스의 기본 패널이 표시되면 Roboflow 앱 URL에서 확인할 수 있습니다.

{% hint style="info" %}
**서버 측 Workflow 정의 캐싱:**   `run_workflow(...)` 에서  `workspace_name` 과  `workflow_id`를 사용하면 서버는 기본적으로 정의를 메모리 또는 Redis에 15분 동안 캐시합니다. Workflows UI에서 정의를 변경하고 메서드를 다시 실행해도 변경 사항이 표시되지 않을 수 있습니다. 이 캐시를 우회하려면  `use_cache=False` 를 다음 메서드의 매개변수로 전달하세요:  `run_workflow(...)`. 연결 오류, 시간 초과 또는 API의  `5xx`  응답이 발생하면 서버는 일치하는 파일 캐시 정의로 대체할 수 있습니다.
{% endhint %}

**Workflows 프로파일링:**  프로파일러 추적을 요청하려면  `enable_profiling=True` 를 다음 메서드에 전달하세요:  `run_workflow(...)`. 서버 설정에서 trace 노출을 활성화하면 다음으로 지정된 디렉터리에서 trace가 포함된 JSON 파일을 찾을 수 있습니다. `profiling_directory` 매개변수는 [`InferenceConfiguration`](https://docs.roboflow.com/reference/ko/inference/inference-sdk/configuration.md) (기본값: `inference_profiling` 이며, 현재 작업 디렉터리에 있습니다). trace는 Google Chrome에서 다음 주소로 불러와 렌더링할 수 있습니다. `chrome://tracing`.
