Features
- Agent 판단 영역 반환: 각 분석의 agent_meta.boxes에 앱 표시용 최종 영역을, agent_meta.original_boxes에 선택·여백·전체 프레임 대체 전의 원본 근거 영역을 함께 반환합니다. 좌표는 마지막 원본 프레임 기준이며 scenario_analysis의 alert·details·response 구조를 유지합니다.
- Stepwise BBOX 근거: VLM이 원본 이미지에서 근거 영역을 직접 생성하는 raw_generated_boxes를 3.3.0 기본 설정으로 제공합니다. 설정에 따라 번호가 표시된 후보 영역에서 근거를 선택하는 masked_candidate_boxes도 사용할 수 있습니다.
- PPE·Thinking 표시 영역 개선: PPE는 실제 판정에 사용한 사람 영역을 원본 근거로 보존하고 미착용 대상에 crop과 동일한 5% 여백을 적용합니다. Thinking은 True로 판정한 incident의 focus 영역에 20% 여백을 적용해 표시하며, 원본 근거에는 True·False incident의 영역을 함께 보존합니다.
- Simple 요청 영역 전달: 검증된 요청 객체의 BBOX를 Agent 결과에 전달하여 앱에서 요청에 사용된 영역을 확인할 수 있습니다.
Validation & Reliability
- 요청 BBOX 검증: 각 좌표는 [x_min, y_min, x_max, y_max] 순서와 양의 면적을 만족해야 합니다. 역순 좌표나 너비·높이가 0인 입력은 요청 검증에서 거부합니다.
- 프레임·픽셀 경계 정합성: 응답 영역을 마지막 원본 프레임의 크기에 맞춰 변환하며, 앱용 우하단 좌표는 마지막 픽셀인 W−1·H−1을 넘지 않도록 보정합니다.
- 근거가 없는 알림 처리: Stepwise의 True 판정에 유효한 근거 영역이 없으면 전체 프레임을 표시합니다. PPE·Thinking은 해당 시나리오의 근거가 유효하지 않으면 알림을 억제하며, 한 시나리오의 좌표·이미지 처리 오류를 다른 시나리오와 분리합니다.
- 공유 원본 이미지 설명: 저장 대상이 있는 요청은 원본 전체 이미지의 설명을 한 번 생성해 모든 시나리오의 details에 공유합니다. 설명 모델 호출 실패는 한 번 기록하고 빈 설명으로 처리하며, 결정적인 상태·설정 오류는 숨기지 않습니다.
Internal Improvements
- 피드백 메타정보 보존: 피드백 검색 결과를 기존 agent_meta에 추가하도록 변경하여 원본·최종 BBOX가 응답과 Qdrant 저장 과정에서 유지됩니다.
- 시나리오 임베딩 제거: 시나리오 문구는 camera_id·prompt_case 정확 일치 필터로 검색 후보를 제한합니다. 원본 이미지와 공유 설명을 각각 한 번 임베딩하며 새 데이터에는 image·details 벡터를 저장합니다. 기존 scenario 벡터가 있는 컬렉션은 유지합니다.
- 탐지 후처리 통합: 모든 탐지 subgraph가 끝난 뒤 공통 BBOX 후처리, 알림 메시지, 이미지 설명, 최종 응답을 순서대로 생성하도록 흐름을 정리했습니다. Stepwise의 구조화 출력은 근거 번호·좌표를 검증하고 잘못된 번호나 범위 밖 좌표를 제거합니다.
- 시나리오 안내문 정리: PPE·Thinking·Stepwise 안내문에서 기존 매뉴얼·블로그 링크를 제거했습니다.
Deployment & Compatibility
- 3.3.0 배포 버전 정렬: eva-agent 이미지와 eva-agent·eva-agent-vllm Helm chart를 3.3.0으로 맞췄습니다. 기본 이미지 저장소는 211722900905.dkr.ecr.ap-northeast-2.amazonaws.com/spectrabrain/eva-agent로 변경되므로 이미지 pull 권한과 ECR 갱신 설정을 확인해야 합니다.
- Agent 모델 캐시 배포 변경: eva-agent chart의 기존 persistence·sharedPvcStorage, 관련 PV·PVC 생성/마운트와 S3 모델 preload를 제거했습니다. 해당 설정에 의존한 배포는 업그레이드 전에 values와 캐시 구성을 확인해야 합니다.
- vLLM S3 캐시 경로 설정: vLLM shared HF cache preload는 유지하며 initContainer.s3Uri로 원본 경로를 지정할 수 있습니다. 기본 경로는 s3://spectrabrain-eva-agent/vllm/hf이며 AWS region·bucket 접근 권한을 함께 확인해야 합니다.
- 태그 기반 자동 배포: GitHub Actions에서 정식·프리릴리즈 태그의 버전 검증, CPU 이미지 빌드·OIDC 기반 ECR 게시, Helm 패키징과 chart 저장소 index 갱신을 수행합니다. 정식 버전의 기존 이미지·차트 패키지는 보존하고 프리릴리즈는 재게시를 허용합니다.