Grablo Reflex 사용설명서

규칙의 동작 원리

모든 규칙은 「이 조건들이 모두 충족되면, 이 동작들을 순서대로 실행한다」는 하나의 문장으로 표현됩니다. 이것이 규칙 모델의 전부이며, 나머지는 세부 설정입니다.

조건은 AND 로 결합됩니다. 규칙은 모든 조건이 동시에 충족되는 순간에 한 번 발동하며, 조건이 충족된 상태가 유지되는 동안 반복 실행되지 않습니다. 다시 발동하려면 조건 중 하나가 거짓이 되었다가 다시 참이 되어야 합니다.

알아두기 지속 시간이 중요한 이유가 여기에 있습니다. 감지 결과는 짧은 시간에 참과 거짓을 반복할 수 있으며, 지속 시간이 없으면 그때마다 규칙이 발동합니다. 반복 실행 제어를 참고합니다.

조건

조건은 감시할 상황을 정의합니다. + 조건 추가를 클릭하면 12가지 조건 종류가 표시됩니다.

조건	감시 대상
AI 카메라	카메라 영상. 사람, 얼굴, 번호판, 화재, 코드, 문자, 직접 학습시킨 대상.
스케줄	요일과 시간대.
주기	일정한 간격의 반복.
I/O 장치	센서 값 또는 보드 입력.
MQTT · Modbus · OPC UA · 사용자 정의 통신	브로커, PLC, 직접 정의한 프로토콜에서 수신하는 값.
텔레그램	봇으로 수신되는 메시지.
사운드 분류	소리. 유리 파손음, 개 짖는 소리, 경보음 등.
음성 인식 (STT)	음성으로 말한 문구.
직접 조건 만들기	위 조건으로 표현할 수 없는 판정. 블록 또는 스크립트로 작성합니다.

조건은 조합하여 사용할 수 있습니다. 카메라 조건에 스케줄을 추가하면 「사람 감지, 야간에만」이 되고, 센서 값을 추가하면 「사람 감지, 장비 가동 중에만」이 됩니다.

카메라 조건의 설정 항목

카메라와 분석. 기존 항목을 선택하거나, 이 창에서 새로 만듭니다.
판정 기준. 조건 목록은 분석에 따라 달라집니다. 얼굴 분석에는 아는 얼굴/모르는 얼굴이, 번호판 분석에는 등록/미등록이 표시됩니다.
대상. 이름이 필요한 조건에는 대상 값 항목이 표시됩니다. 객체 종류, 인물, 번호판, 문자 중 하나를 입력합니다.
신뢰도와 지속 시간. 판정의 확실성 기준과 지속 시간을 설정합니다. 나머지 항목은 고급 옵션에 있습니다.

주의 대상 값은 문자열 그대로 비교됩니다. 객체는 직접 입력하지 말고 목록에서 선택합니다. 표기 규칙이 고정된 두 경우(객체 이름은 소문자, 번호판은 대문자)는 자동으로 보정되지만, 직접 지정한 이름은 입력한 그대로 비교됩니다.

보조 조건: 발동 시점에만 검사하기

조건은 별도로 지정하지 않으면 계속 검사됩니다. 조건 하나를 보조 조건으로 변경하면, 나머지 조건이 모두 충족된 시점에 한 번만 검사하여 동작 실행 여부를 결정합니다.

대표적인 용도는 두 번째 카메라입니다. 초인종이 눌리면(상시 검사), 그 시점에 문 앞 얼굴이 등록된 사람인지 확인하는(발동 시점에만 검사) 구성입니다. 두 번째 카메라를 상시 분석할 필요가 없습니다.

행 메뉴의 보조 조건으로 변경을 사용합니다. 목록에 보조 표시가 붙으며, 상시 감시가 아니라 발동 시점에 한 번 검사하는 조건이므로 지속 시간 설정은 없습니다.

규칙에는 일반 조건이 최소 하나 있어야 합니다. 보조 조건만으로 구성된 규칙은 발동할 수 없으므로, Reflex 가 해당 변경을 차단하고 이유를 안내합니다.

Ask LLM: 감지 결과를 LLM 으로 재검증하기

카메라 조건 창의 Ask LLM 스위치는 고급 옵션 바깥, 지속 시간 바로 아래에 있습니다. 활성화하면 조건이 충족되는 순간 사진을 촬영하여 LLM 에 함께 전달하고, LLM 이 승인한 경우에만 동작이 실행됩니다. 오탐이 잦은 조건을 한 단계 더 검증하는 용도입니다.

항목	설명
LLM 연결	질의할 LLM 제공자. 없으면 이 창에서 만듭니다.
질의문	LLM 에 전달할 질문. 필수 항목입니다. 예: 「사람이 실제로 문을 두드리고 있습니까?」
촬영 장수	함께 전달할 사진 수. 1~10장.
촬영 간격	사진 촬영 간격. 0~5,000ms.

규칙 하나에 하나만 설정할 수 있으며, 카메라 조건이 있어야 활성화할 수 있습니다.

반복 실행 제어

과도한 알림을 방지하는 핵심 설정은 두 가지이며, 모두 카메라 조건 창에 있습니다.

설정	동작	값을 올려야 할 때
지속 시간	설정한 시간 동안 감지가 지속되어야 규칙이 발동합니다. 순간적인 감지는 무시됩니다.	실제로 없는 대상에 알림이 발생할 때.
다시 실행까지	동작 실행 후, 조건이 충족되지 않는 상태가 설정한 시간만큼 지속되어야 다시 발동합니다.	같은 상황이 반복해서 보고될 때.

통행량이 많은 출입구에서는 다시 실행까지를 오히려 낮추는 것이 적합합니다. 여러 사람이 하나의 이벤트로 묶이지 않고 각각 기록됩니다. 비워 두면 지속 시간과 같은 값이 적용됩니다.

움직임 조건의 추가 설정

움직임 있음과 움직임 없음 조건에는 두 가지 설정이 추가됩니다.

이동 허용치(px)	감지된 상자의 중심이 이 값보다 크게 이동해야 「움직임」으로 판정합니다. 값을 올리면 미세한 흔들림을 무시하고, 내리면 느린 움직임도 감지합니다.
정지 유지 시간	설정한 시간 동안 정지해 있어야 「정지」로 판정합니다. 흔들리는 물체가 반복 발동하는 것도 이 값으로 방지합니다.

동작

+ 동작 추가를 클릭하면 16가지 동작이 표시됩니다.

목적	동작
알림 전송	푸시 알림, 이메일, 텔레그램
기록	로깅
소리 출력	미디어 재생, 텍스트 음성 변환 (TTS)
장비 제어	I/O 장치, Zigbee 제어, Modbus, OPC UA, 사용자 정의 통신
소프트웨어 연동	MQTT 발행, HTTP 요청, SQL 데이터베이스, 셸 명령
대기	시간지연

동작은 위에서 아래로 순서대로 실행되며, 행을 드래그하여 순서를 변경할 수 있습니다. 실행 시간이 긴 동작이 있으면 순서가 중요합니다. 1초가 걸리는 알림 하나가 그 뒤의 모든 동작을 그만큼 지연시킵니다. 동작 사이에 시간지연을 넣으면 간격을 둘 수 있습니다. 경고 방송 후 일정 시간 대기하고 전원을 차단하는 구성이 그 예입니다.

알아두기 사진을 첨부할 수 있는 동작(푸시, 이메일, 텔레그램, 로깅)은 이벤트 하나에 사진 한 장을 공유합니다. 규칙이 발동할 때 한 번 촬영하고 모든 동작이 같은 사진을 첨부하므로, 휴대폰으로 수신한 사진과 기록에 남은 사진이 항상 일치합니다. 규칙이 여러 카메라를 감시하는 경우 어느 카메라에서 촬영할지 동작 설정에서 선택합니다.

주의 푸시 알림을 수신하려면 휴대폰에 Grablo 앱이 설치되어 있고, 같은 계정으로 로그인되어 있으며, 휴대폰 설정에서 알림이 허용되어 있어야 합니다.

이벤트 기록 남기기

로깅 동작은 발동 시점을 사진과 함께 이벤트 로그에 기록하며, 필요하면 영상 클립도 함께 저장합니다. 로그를 활용하려면 이 동작이 필요하므로, 대부분의 규칙에 하나씩 포함하는 것을 권장합니다.

설정	내용
이름	필수 항목입니다. 로그, CSV, 인쇄 보고서에서 이 항목을 가리키는 이름입니다. 자동으로 번호가 입력되므로 식별 가능한 이름으로 변경합니다.
대상	기록할 대상. 카메라, 분석, 값 중 하나입니다.
형태	스냅샷 또는 영상 클립. 클립을 선택해도 목록 썸네일용 사진은 촬영됩니다.
이벤트 이전 · 이후	발동 시점 앞뒤로 몇 초씩 영상에 포함할지.
영상 길이	고정 시간 또는 감지되는 동안. 후자는 감지가 지속되는 동안 계속 녹화합니다.

세 가지 대상은 기록하는 내용이 다릅니다.

대상	기록되는 것
카메라	사진과 영상만 기록됩니다. 이 규칙이 감시하지 않는 카메라를 정황 증거로 함께 첨부할 때 사용합니다.
분석	사진과 함께 AI 판정 결과가 기록됩니다. 이후 로그에서 AI 판정을 교정할 수 있는 대상은 이것뿐입니다.
값	발동 시점의 값만 기록됩니다. 첨부는 없습니다.

주의 영상은 저장 전까지 메모리에 유지됩니다. 이벤트 이전을 길게 설정할수록 컨트롤러 메모리 사용량이 늘고, 클립이 길수록 파일이 커집니다. 감지되는 동안은 카메라당 하나만 사용할 수 있습니다. 다른 기록이 이미 사용 중이면 이 기록은 고정 시간으로 대체되며, 화면에 해당 내용이 안내됩니다.

규칙 관리

작업	방법
이름 변경	가운데 영역 상단의 이름을 클릭하여 수정합니다.
복제	규칙 행 메뉴의 복제. 조건, 동작, 설정이 함께 복제됩니다.
삭제	행 메뉴의 삭제. 포함된 조건과 동작도 함께 삭제됩니다.
일시 중지	규칙 이름 옆의 스위치. 규칙, 개별 조건, 개별 동작에 각각 있습니다.

스위치를 끄는 것은 안전한 작업입니다. 설정이 그대로 유지되므로 언제든지 다시 켤 수 있습니다.

알아두기 여러 카메라에 같은 규칙을 적용하는 가장 빠른 방법은 복제입니다. 규칙을 복제한 뒤, 사본의 카메라 조건에서 다른 카메라를 선택합니다.

주의 실행 중에는 편집할 수 없습니다. 컨트롤러는 시작 시점에 수신한 프로젝트로 동작하므로, 실행 중의 변경은 반영되지 않습니다. 정지 후 수정하고 다시 시작합니다. 얼굴 등록과 학습 샘플 추가는 예외적으로 실행 중에도 가능합니다. 실행 상태에서 수행해야 하는 작업이기 때문입니다.