> 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/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/trigger-a-stream.md).

# 스트림 트리거

"Triggered" 모드로 설정된 스트림은 모든 프레임에 대해 추론을 실행하지 않습니다. 대신 카메라에서 프레임을 지속적으로 캡처하고, 가장 최근 프레임에 대해 구성된 워크플로를 실행하기 위한 명시적인 트리거를 기다립니다. 이는 추론 비용이 클 때, 결과가 특정 순간에만 필요할 때(예: PLC가 부품이 제자리에 있다고 신호할 때), 또는 외부 시스템이 검사 주기를 제어할 때 유용합니다.

스트림을 트리거하는 방법은 두 가지입니다:

1. 클라우드에서 Deployment Manager 대시보드를 사용합니다.
2. 엣지에서 디바이스의 로컬 HTTP 엔드포인트를 호출합니다.

어떤 방법을 사용하든, 스트림은 이미 "Triggered" 모드로 설정되어 있어야 합니다. 당신이 [추가할 때](/deployment/ko/self-hosted/enterprise/deployment-manager/setting-up/add-a-stream.md) 또는 [디바이스 구성을 업데이트하여](/deployment/ko/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

## 클라우드 트리거

클라우드 트리거는 Roboflow 앱에서 발행되어 Deployment Manager를 통해 디바이스로 전달됩니다. 수동 트리거, 데모, 또는 트리거를 시작하는 시스템이 인터넷에 연결되어 있지만 디바이스의 로컬 네트워크에는 없는 경우에 사용하세요.

Deployment Manager 대시보드에서 스트림이 호스팅되는 디바이스를 클릭합니다. 각 트리거된 스트림에는 "Trigger" 버튼이 있습니다. 최신 프레임에 대해 단일 추론 실행을 발생시키려면 "Trigger"를 클릭합니다:

디바이스가 트리거를 처리하는 동안 스트림에는 "Waiting for device..."가 표시됩니다. 디바이스가 결과를 반환하면 상태가 "Inference complete"로 업데이트되고 렌더링된 프레임이 워크플로 출력으로 새로 고쳐집니다.

트리거는 디바이스의 명령으로 대기열에 추가되며, 디바이스가 Deployment Manager를 다음에 폴링할 때 처리됩니다(일반적으로 몇 초 이내). 클라우드 트리거는 고빈도 트리거용으로 설계되지 않았습니다. 1초 미만의 지연 시간이 필요하거나 분당 몇 번을 넘는 트리거를 발생시켜야 한다면, 대신 엣지 트리거를 사용하세요.

## 엣지 트리거

엣지 트리거는 디바이스에서 실행 중인 추론 서버에 직접 보내는 HTTP 호출입니다. PLC, 로컬 스크립트 또는 디바이스와 같은 네트워크에 있는 모든 시스템에서 프로덕션 트리거용으로 사용하세요. 엣지 트리거는 Deployment Manager를 거치는 왕복을 피할 수 있으며, 지연 시간에 민감한 통합에 권장되는 방법입니다.

디바이스의 추론 서버는 실행 중인 각 스트림에 대해 트리거 엔드포인트를 제공합니다:

```
POST http://<device-ip>:8000/inference_pipelines/{pipeline_id}/trigger
```

다음으로 바꾸세요 `<device-ip>` 를 네트워크상의 디바이스 IP 주소로, 그리고 `{pipeline_id}` 를 트리거하려는 스트림의 ID로 바꾸세요. 파이프라인 ID는 Deployment Manager의 스트림 세부 정보에서 찾을 수 있습니다.

요청 본문은 선택 사항입니다. 단일 트리거에 대해 스트림에 구성된 워크플로 매개변수를 덮어쓰려면, 본문에 포함하세요:

```json
{
  "workflows_parameters": {
    "confidence": 0.7
  }
}
```

성공적인 트리거는 캡처된 프레임에 대한 워크플로 출력을 반환합니다:

```json
{
  "success": true,
  "data": {
    "frame_id": 1024,
    "timestamp": 1716220800.123,
    "workflow_output": [
      {
        "predictions": []
      }
    ]
  }
}
```

디바이스가 아직 프레임을 캡처하지 않았거나 파이프라인이 실행 중이 아니면, 응답은 `success: false` 원인을 설명하는 메시지와 함께 반환됩니다.

{% hint style="info" %}
엣지 트리거 엔드포인트는 디바이스의 로컬 네트워크에서만 접근할 수 있습니다. 외부에서 호출하려면 자체 네트워크 인프라를 통해 디바이스를 노출하거나 클라우드 트리거를 사용하세요.
{% endhint %}

## 클라우드와 엣지 트리거 중 선택하기

| 사용 사례                             | 권장 트리거 |
| --------------------------------- | ------ |
| Roboflow 앱에서 스트림을 수동으로 검사하기       | 클라우드   |
| 트리거된 스트림을 데모하거나 테스트하기             | 클라우드   |
| 디바이스와 같은 네트워크의 PLC, 센서 또는 바코드 스캐너 | 엣지     |
| 같은 요청에서 추론 결과를 되돌려 받아야 하는 로컬 스크립트 | 엣지     |
| 고빈도 트리거링(분당 몇 번 이상)               | 엣지     |