본문으로 건너뛰기

EVA Agent Release Note

v3.0.4 (2026년 7월 3일)​

권장 Helm 차트​

컴포넌트Chart 버전
eva-agent3.0.4
eva-agent-vllm3.0.4
eva-agent-init1.0.0
qdrant1.16.3

주요 변경​

  • Meta agent VM 모델 추천 fallback: 기본 소스를 사용할 수 없을 때도 meta agent가 VM 모델 추천을 반환하도록 fallback 경로를 추가했습니다.
  • Meta agent vision 모델을 EVA Vision에서 로드: meta agent의 후보 vision 모델을 고정 목록 대신 EVA Vision에서 로드합니다.
  • Enrich 프롬프트/few-shot 튜닝: 영어 enrich few-shot 예시, excluded-situation 생성, EXAone/Qwen3 프롬프트 문구를 업데이트했습니다.

차트 및 런타임 변경​

  • 차트/이미지 3.0.4 반영: eva-agent와 eva-agent-vllm 차트를 3.0.4로 packaging했습니다. release values 템플릿 세트는 3.0.3과 동일합니다.
  • 기본 이미지 태그 보정: eva-agent 차트 기본 image.tag가 릴리스 버전(3.0.4)을 따르도록 보정했습니다. 이전에는 3.0.2에 고정돼 기본 설치 시 예전 이미지를 받는 문제가 있었습니다.

수정​

  • OPENAI_API_KEY 정규화: 빈 OPENAI_API_KEY를 EMPTY로 정규화하여 OpenAI 호환 클라이언트가 정상적으로 초기화되도록 했습니다.

v3.0.3 (2026년 6월 25일)​

권장 Helm 차트​

컴포넌트Chart 버전
eva-agent3.0.3
eva-agent-vllm3.0.3
eva-agent-init1.0.0
qdrant1.16.3

주요 변경​

  • LangChain 1.x / Langfuse SDK v4 업그레이드: 런타임을 LangChain v1, Langfuse SDK v4로 이전했으며, v4 SDK에서 span의 tag를 업데이트할 수 있도록 tag helper를 추가했습니다.
  • 요청별 detection-mode 태그: 추적/필터링을 위해 요청별로 detection-mode 태그를 부착합니다.
  • Qwen3-VL 및 영어 enrich: Qwen3-VL 모델 지원과 영어 enrich 변형을 추가하고, enricher의 person-related 추론과 target 생성 로직을 업데이트했습니다.
  • 평가 지표 보강: detection-agent 평가에 F1, accuracy, precision 리포팅을 추가했습니다.

차트 및 런타임 변경​

  • 차트/이미지 3.0.3 반영: eva-agent와 eva-agent-vllm 차트를 3.0.3으로 packaging하고 downstream vLLM 차트 기본값을 갱신했습니다.
  • vLLM GPU 프로파일 세트 업데이트: release/3.0.3 vLLM values 템플릿을 업데이트했습니다(3.0.2에 있던 PRO5000-MIGx6 K3s 프로파일 제거).

수정​

  • Fire routing / thinking 시나리오 매칭: fire 라우팅 처리와 thinking 모드 시나리오 매칭을 수정했습니다.
  • PPE 임계값: PPE 탐지 임계값을 0.1로 낮췄습니다.
  • OPENAI_API_KEY fallback: OPENAI_API_KEY 없이 ChatOpenAI가 생성되는 경우에 대한 fallback을 추가했습니다.
  • Config 정리: EXAone 4.0 config와 기타 미사용/이전 config를 제거하고 graph 이름 및 config 위치를 조정했습니다.

v3.0.2 (2026년 6월 19일)​

권장 Helm Chart​

컴포넌트Chart 버전
eva-agent3.0.2
eva-agent-vllm3.0.2
eva-agent-init1.0.0
qdrant1.16.3

Highlights​

  • 최신 3.0.x 설치 기준: eva-agent chart/image는 3.0.2, eva-agent-vllm chart는 3.0.2 조합을 사용합니다.
  • Detection mode 명칭 정렬: 기존 내부 default mode를 stepwise로 변경하고 runtime code, prompt config, validation helper, 문서 명칭을 맞췄습니다.
  • HF cache/runtime 보강: Hugging Face 접근 실패 시 HF_OFFLINE을 자동 설정하고, init 단계에서 cache directory가 없으면 생성하도록 보완했습니다.
  • Thinking mode 제한 강화: 지원하는 incident category로 thinking mode routing을 제한하고, fire/smoke triage 경로를 분리했습니다.
  • 평가 도구 갱신: Detection Agent evaluation 기본 모델을 Qwen3.5-VL로 맞추고, multi detection mode 평가, bbox path, v3.0.0 평가 예제를 갱신했습니다.

Chart and Runtime Changes​

  • vLLM chart 3.0.2: downstream eva-agent-vllm chart를 3.0.2로 packaging하고 router 기본값을 3.0.2 release values와 맞췄습니다.
  • Standalone values 템플릿: EVA Agent, Qdrant, vLLM의 3.0.2 release values를 provider별 standalone 파일로 전환했습니다. 공통 base values.yaml은 더 이상 필요하지 않습니다.
  • 설치 스크립트 기본 동작: Dependency/Agent 설치 스크립트는 provider values를 명시적으로 전달하지 않으면 chart default로 설치합니다. values-secret.yaml은 별도 optional secret overlay로 유지됩니다.
  • Provider runtime 값 명시: vLLM provider values에 서버별 변동값인 runtimeClassName, strategy.type, replicaCount, requestGPU, requestGPUType, K3s NFS cache path를 명시했습니다.

Fixes​

  • Root-user chart/runtime 조정: 3.0.2 package에서 사용하는 root-user runtime 경로에 맞게 image와 chart values를 정리했습니다.
  • Prompt/config 정리: advanced_config의 detection mode 순서를 정리하고 PPE, thinking, stepwise 관련 prompt 문구를 보정했습니다.
  • Meta Agent threshold 튜닝: threshold 감소 추천을 막고, 3.0.1에서 상향한 minimum image count 기준을 유지했습니다.

v3.0.1 (2026년 6월 16일)​

권장 Helm Chart​

컴포넌트Chart 버전
eva-agent3.0.1
eva-agent-vllm3.0.1
eva-agent-init1.0.0
qdrant1.16.3

Highlights​

  • Chart/deployment patch: chart metadata와 기본값을 3.0.1 라인으로 갱신했습니다.
  • Static PV와 S3 sync 안정화: static mode PV binding을 수정하고, 실패한 init sync가 이후 기동을 막지 않도록 stale S3 sync lock 제거 로직을 추가했습니다.
  • vLLM init container 수정: EVA shared cache layout에서 사용하는 downstream vLLM init container script 동작을 고정·보정했습니다.
  • Enrich prompt 언어 처리 수정: default enrich prompt details 언어 처리와 duration 기반 timeline metadata prompt를 보정했습니다.
  • Meta Agent 튜닝: 성급한 추천 업데이트를 줄이기 위해 META_AGENT_MIN_IMAGE_COUNT를 20에서 30으로 변경했습니다.

Fixes​

  • Values 동기화: Helm repo에 packaging된 기본값과 source tree chart values가 일치하도록 정리했습니다.
  • Legacy cleanup: patch release에 맞춰 오래된 code path를 제거하고 package/version metadata를 갱신했습니다.

v3.0.0 (2026년 6월 12일)​

권장 Helm Chart​

컴포넌트Chart 버전
eva-agent3.0.0
eva-agent-vllm3.0.1
eva-agent-init1.0.0
qdrant1.16.3

Highlights​

  • Detection Agent 아키텍처 재구성: 기존 Visual Agent runtime을 simple, plain, stepwise, ppe, thinking graph path 중심의 Detection Agent로 재구성했습니다.
  • Enrich Agent graph 리팩터링: single/multi scenario 분기, detection mode 선택, 공통 metadata 생성, 최종 scenario 조립 흐름을 main enrich graph로 정리했습니다.
  • Chat Agent graph 분리: chat 처리를 pre_chat, action, qna subgraph로 분리하고 short-circuit/error 경로를 명확히 했습니다.
  • Validation endpoint 추가: enriched scenario를 저장하거나 Detection Agent runtime에 전달하기 전에 deterministic validation을 수행하는 endpoint를 추가했습니다.
  • Meta Agent 추가: threshold recommendation, runtime experiment config, queue/candidate debug API, inactive state cleanup 로직을 추가했습니다.
  • Observability 확장: parser error collection, Langfuse parser error tag/metadata, Kubernetes runtime discovery 기반 vLLM engine health 지원을 추가했습니다.

Breaking Changes​

  • Visual Agent 경로 대체: legacy visual-agent schema/runtime 가정 대신 Detection Agent API/schema 경로를 사용해야 합니다.
  • Detection mode 계약 확장: scenario 처리는 simple, plain, stepwise, ppe, thinking 등 명시적 detection mode를 사용합니다.
  • 저장 전 validation 필요: application은 enriched scenario를 저장하거나 dispatch하기 전에 새 validation endpoint로 검증하는 흐름을 사용해야 합니다.

Features​

  • PPE runtime 지원: equipment synonyms, body visibility, worn-item check, candidate filtering, output fallback을 위한 PPE 전용 graph node를 추가했습니다.
  • Thinking runtime 지원: 지원 hazard incident에 대한 triage와 localized prompt details 처리를 추가했습니다.
  • No-alert feedback sampling: no-alert Qdrant 저장 정책을 request 단위로 결정해 sampled image description과 feedback 저장 여부가 어긋나지 않도록 했습니다.
  • Config layout 갱신: Exaone4.0, Qwen3-VL, Qwen3.5-VL 계열의 v3.0.0 prompt config를 추가하고 model-first folder 구조로 정리했습니다.
  • 개발/평가 도구: live API check, Detection Agent evaluation tooling, 개발 실행 helper, scenario validation reference를 추가했습니다.

Config & Deployment​

  • Chart/image 상향: eva-agent chart/image 3.0.0을 추가하고 package metadata를 3.0 라인에 맞췄습니다.
  • Runtime env 추가: VISION_ML_BASE_URL, VLLM_ENGINE_HEALTH_MODE, vLLM engine health RBAC 지원을 추가했습니다.
  • Model 기본값 갱신: Qwen3.5-VL 기반 runtime에 맞춰 model config와 vLLM/router 기본값을 갱신했습니다.

v2.7.0 (Apr 17, 2026)​

Highlights​

  • VM recommendation 흐름 추가: 런타임 맥락에 맞는 모델 추천을 위해 전용 VM recommendation agent, API route, graph, schema, 버전별 설정을 추가했습니다.
  • Langfuse retention 지원: Langfuse trace/media 정리를 위한 retention 도구와 런타임 지원을 추가하고, 관련 환경 변수 및 배포 기본값을 정비했습니다.
  • Parser 파이프라인 리팩터링: 기존 parser 경로를 pre-parse, post-parse, output normalization 유틸로 재구성하여 structured/plain-text node 처리 일관성을 높였습니다.
  • 시나리오/영역 계약 업데이트: scenario/image와 area 관련 스키마를 정비하여 list 기반 image 입력과 list 기반 area naming을 enrich 메타데이터에 반영했습니다.
  • 멀티 프레임/전처리 개선: MFM trace/state 처리, polygon 영역 전처리, manager/bootstrap 경로의 DI 구성을 확장했습니다.
  • 릴리즈 라인 갱신: 패키지와 배포 기본값을 2.7.0 라인으로 상향하고 compose/chart 기본값을 최신 릴리즈에 맞췄습니다.

Breaking Changes​

  • Scenario image 계약 변경: scenario image 입력이 list 기반 값을 허용하므로, 단일 문자열만 가정하던 연동 로직은 요청 생성 방식을 갱신해야 합니다.
  • Area 필드 전환: 영역 메타데이터가 기존 단일 필드 대신 list 중심 필드(area_names, areas)를 사용하므로 downstream schema binding 점검이 필요합니다.
  • Brightness 명령 동작 강화: 채팅 기반 brightness 변경은 더 엄격하게 제한되며, brightness mode는 none 같은 문자열 값을 명시적으로 사용합니다.

Features​

  • VM recommendation agent: Exaone4.0, Qwen3-VL, Qwen3.5-VL용 버전별 설정과 함께 새로운 recommendation API/graph 경로를 추가했습니다.
  • Langfuse retention 도구: trace/media cleanup을 위한 retention script, observability helper, secret/env 지원을 추가했습니다.
  • Custom parser 스택: output parser, pre-parse, post-parse, normalization 유틸을 도입해 node 출력 처리를 표준화했습니다.
  • Polygon area 전처리: polygon 기반 영역 전처리와 area-name 처리 로직을 추가해 scenario/region 처리를 개선했습니다.
  • MFM trace/queue 가시성: 멀티 프레임 요청에 대해 frame 단위 trace 분리, queue state trace, early-return span 처리를 추가했습니다.
  • Bootstrap/API 정리: bootstrap 관심사를 전용 API bootstrap 모듈로 옮기고, MFM manager를 직접 생성하지 않고 DI로 주입하도록 정리했습니다.

Fixes​

  • Chat 스키마 정리: chat history 처리, scenario typing, plain-text node parsing을 보완해 chat 파이프라인 안정성을 높였습니다.
  • Area/스키마 보정: area type 처리와 area naming을 보정하고 brightness/scenario payload 기본값을 정리했습니다.
  • 모니터링 제어 수정: turn-off 동작과 brightness 설정 예외를 수정하고 none/None 계열 값 처리를 명확히 했습니다.
  • Visual agent 안정화: VLM priority, scenario wording, preprocessing 동작을 계속 조정해 응답 일관성을 개선했습니다.

Config & Deployment​

  • 릴리즈 버전 상향: package metadata, chart 기본값, docker-compose 기본값을 2.7.0으로 상향했습니다.
  • 기본 런타임 로그 레벨 추가: EVA Agent chart 기본 values에 LOGURU_LEVEL=INFO를 추가해 기본 런타임 로그 기준을 명확히 했습니다.
  • 환경 샘플 갱신: .env.sample, .env.eva-agent.sample을 현재 runtime 분리 구조와 observability 설정에 맞게 갱신했습니다.
  • vLLM router 지원: 여러 static engine과 함께 사용할 수 있도록 공식 vLLM router 지원 코드와 설정을 추가했습니다.

Changelog (selected commits)​

펼쳐보기
  • c59bf2a3 feat: new area preprocess logic(polygon)
  • 33393045 Hotfix/chat history schema
  • fa0143d4 fix area type
  • b8f60168 fix turn-off mode
  • 8bfbec43 add: dynamic pydantic model description utils
  • ad851737 add type of the scenario list
  • 713e1bda change scenario.image (str) to (list)
  • 9570e267 (ban) change brightness via chat
  • cb4884a3 feat: add vm recommendation agent
  • 26ccb7d8 feat: meta_core's area to area_names (field name: areas, list of area name)
  • 5e500f81 feat: frame별 trace 분리 + mask function 적용 (timeout 이슈)
  • 47275b59 feature: add mfm_early_return span and mfm queue state for each request
  • d6edb736 update: bright setting schema to allow string 'none' and allow None for offset
  • 5486a5b7 update: api schema
  • 5da8f586 feat: langfuse retention temp commit
  • 69a98726 refactor: applied custom parser to remaining nodes, reqplaced StructuredOutputParser to Pydantic
  • ed016eb4 feat: custom parser w/ output normalization
  • 04cc7e01 upgrade VLM prioirty
  • 1f040747 add tag folder
  • 3a2d307f upgrade VA
  • a75cf8df refactor: inject MFMManager using DI (not instantiate at router directly)
  • 16b73492 chore: change folder name service to bootstrap (API layer)
  • 17980ed3 chore: add LOGURU_LEVEL as 'init' for default chart values (EVA Agent)
  • 90b60d9a add: vllm router for multiple static vllm engines (official vllm router from vllm production stack)

v2.6.0 (Mar 17, 2026)​

Highlights​

  • Visual Agent 모드 분리: 시나리오 계약에 detection_mode를 추가하고 vm_only 경로를 분리하여 그래프 선택을 모드 기반으로 전환했습니다.
  • 멀티 프레임 추론 확장: multi-frame manager/queue 경로를 도입·확장하고 vm-only 및 timeline 계열 감지 간격 제어를 강화했습니다.
  • Feedback 파이프라인 재구성: feedback record/apply 흐름을 전용 graph로 분리하고 분석 단위 vector search 메타데이터를 후속 처리에 활용할 수 있게 정리했습니다.
  • Chat/Enrich 계약 정렬: lang 전환을 이어가고 capture/priority/query 처리 규칙을 정리하면서 enrich/visual 스키마를 앱 계약과 맞췄습니다.
  • 모델/배포 구성 갱신: Qwen3.5-VL 설정을 추가하고 기본 vLLM 이미지를 0.17.1로 갱신했으며, downstream eva-agent-vllm chart와 Qdrant 운영 유틸을 확장했습니다.

Breaking Changes​

  • 시나리오 요청 계약 변경: Visual request의 scenario_list 항목에 detection_mode가 포함되며, 실제 그래프 선택도 이 필드에 따라 결정됩니다.
  • Enrich 출력 계약 변경: Enrich 결과에도 detection_mode가 포함되며, capture mode 의미가 기존 temporal 표현에서 Timeline 중심 의미로 정리되었습니다.
  • 응답 스키마 조정: AnalysisItem.label은 optional이 되었고, 분석 항목별로 agent_meta.vector_search_info가 포함될 수 있으므로 응답 소비 측 로직 점검이 필요합니다.
  • 언어 필드 전환: app_lang는 lang로 전환되었으므로 기존 필드에 의존하던 클라이언트는 요청/응답 처리 로직을 갱신해야 합니다.

Features​

  • Detection mode 지원: vm_only와 multi_step를 구분하는 schema/config를 추가하고 앱 계약과 맞춘 detection mode 분류를 도입했습니다.
  • Multi-frame manager 지원: timeline 계열 추론을 위해 multi-frame manager/queue 구성과 detection interval 기반 package control을 추가했습니다.
  • Vector search 메타데이터 노출: 분석 단위 vector search 메타데이터를 저장하고 visual-agent 응답에 포함해 feedback/app 후속 처리에 활용할 수 있게 했습니다.
  • Feedback graph 분리: feedback record/apply API를 전용 feedback graph와 service-layer node로 분리했습니다.
  • 모델 커버리지 확장: Qwen3.5-VL 프롬프트/설정 변형을 추가하고 Qwen3.5 계열용 vLLM instruction-mode extra_body를 지원했습니다.
  • Enrich 로직: 멀티 프레임 기반으로 동작할 수 있는 시나리오로 enrich 하도록 업데이트 했습니다..
  • Chat 로직: 새로 추가된 사항 및 변경된 동작에 맞는 답변을 하도록 업데이트 했습니다.

Fixes​

  • VM-only 라우팅 안정화: graph-name 해석 및 vm-only 스키마/프롬프트 불일치를 수정해 잘못된 그래프 경로로 빠지는 문제를 보완했습니다.
  • Threshold/interval 튜닝: monitoring 경로의 오동작을 줄이기 위해 vm-only threshold와 detection interval 제어를 여러 차례 조정했습니다.
  • Schema/parser 보강: AnalysisItem.label optional 처리, detection mode/capture mode 스키마 정렬, 파싱/정규화 예외 처리를 보강했습니다.
  • Chat/Enrich 요청 정리: chatstate -> chatinput 처리, language normalization, user query normalization, 프롬프트/설정 불일치를 다수 정리했습니다.

Config & Deployment​

  • 배포 버전 상향: chart/image/docker-compose 기본값을 2.6.0 릴리즈 라인에 맞췄습니다.
  • vLLM 스택 업데이트: 기본 vLLM 이미지를 0.17.1로 올리고 shared PV 배포 패턴을 위한 downstream eva-agent-vllm Helm chart를 추가했습니다.
  • Qdrant 운영 도구 확장: Qdrant migration, snapshot, restore, backup, vector rebuild/update 유틸을 추가·확장했습니다.
  • Helm/runtime 정리: Helm PV 동작을 보정하고 S3 sync init container를 flag 기반으로 제어하며, 이전 deploy override 파일들을 새 chart 구조에 맞게 정리했습니다.

Changelog (non-chore, 167 commits)​

펼쳐보기
  • d002689 update: default image tag to 2.6.0
  • cbad2e7 update: chart version to 2.6.0
  • 8b18017 add: extra_body for vllm's instruction mode (Qwen3.5 VL model only)
  • 933737b add: qwen3.5-vl-9b model confif yaml files
  • 4397cf5 update: vllm default image tag to 0.17.1 to use qwen3.5 family
  • 33f33d7 upgrade message
  • 50df0e3 change prompt for set target
  • 8bd2573 update: docker compose yaml file
  • 50f0935 add: span + trace level score at feedback apply graph (node-level)
  • 72ba9e2 modify config & fix node utils
  • c96065f modify config
  • 0c93142 rm files
  • b832ab0 upgrade configs
  • 09dfc37 upgrade chat/alert message
  • 8fca3be add: trace metadata for mfm early returned requests
  • d6000ea update function
  • bb063a6 apply MR commnets
  • 7bb5fe1 fix lang
  • 14dc255 fix capture mode to lower
  • 4d1bb3c fix: apply updated img description schema for vm-only graph
  • 6f6ce6d rm logs
  • 5c2d24b upgrade chat
  • 4eaaf58 update: trace name for each mode for visual agent API
  • 0d1fce2 fix: apply mfm for vm_only to control detection interval
  • e4c5602 update: set vm_only mode's threshold value to 0.98 (from 0.99)
  • 099c895 upgrade vision model info for chat agent
  • d49f405 fix code based on the MR's comment
  • c51e1ba hotfix: update vm_only threshold value to 0.99
  • d59a67c fix normalize function
  • 643fbe5 fix normalize function
  • 326131f clean enrich state
  • 1b02e35 fix chatstate->chatinput for the chat api request
  • c410b75 change get language function name
  • 26bce9c fix: _resolve_graph_name always return vm_graph
  • 7d5b4b7 Applied parallel
  • 2c8b12f Changed description abatch -> ainvoke
  • 2824baa rm Exceptions
  • 1723047 update chat messages
  • 0c9dd5f rm lines from mfm preprocess
  • a324013 rm configs (exaone-vlm)
  • 11fe760 upgrade enricher
  • 3ef75ad Added VmState & Seperated VmGraph
  • 54d5f9a upgrade configs(Exaone)
  • 728ada2 upgrade multi step
  • 362deeb Edit get_output.py
  • 420dc60 fix codes based on Merge Review's comments
  • b2ed805 add enricher's edge
  • 20ebaac Edit v2.5.0.yaml
  • 52cfaaa Formated vm_only detection message
  • f904b8d change order of the complied graph's input
  • 0533f24 change priority list
  • 687af55 add edge
  • cc51307 update normalize ndoe
  • e8e81e6 add function type and capitalize to the frame mode
  • ff87870 add var
  • 4cad6be upgrade priority chat
  • 1a01bef update context
  • 29a63b4 change the name of the context schema
  • 16015dd add logic
  • 233a3e1 del test code
  • 4be6474 update enricher;'s capture mode
  • ee7430b change capture mode
  • 6632b88 fixed bug
  • 6f5471d Added detection mode node
  • 3c6b98e upgrade temporal logic
  • 4ee6805 upgrade enrich prompt
  • ff668e4 upgrade priority
  • cf8065a upgrade chat1
  • 2de6c6e change priority;s default value to standard
  • d911b68 change low state to standard state
  • f3cf1e7 change str type
  • 3c181e4 rm priority from enrich
  • 12e794b upgrade multi frame
  • e372aa0 update img_description and check user query section
  • f2635a2 upgrade the exception logic
  • 5e84ce4 reverse upgrade
  • 7431ed3 fix parsing bug
  • 33741c8 fix: update AnalysisItem.label as optional
  • 7d9f6bc feat(schema): align detection mode and app-level config contract
  • d63c599 update enrich schema and rm debug log
  • 630ef2a feat(visual-agent): persist per-analysis vector search meta
  • 8402a86 rm logs
  • 83fcbd7 updage enrich fewshot
  • 0c35698 update multi image agent logic and preprocessing logic
  • 1ebd4a2 rm priority from enriched input
  • 7e2c806 clean states(enrich/chat)
  • 676cf0f change configs to llm(Exaone)
  • 36068fa rm logs; solve bugs
  • 96c4499 update english fewshots
  • f166d91 update english logits
  • d78a8b4 update configs
  • d944ec9 update configs
  • 0f83ff9 update configs
  • b477b7f update enrich
  • 5b46dc4 upgrade configs
  • d0e4009 update configs
  • cf778e5 upgrade enricher
  • 4c4ad0f upgrade enrich
  • 5038f2a change exception_condition_per_exception to exception_condition_per_scenario
  • f23160d add annotations; chat
  • aca1994 add annotations; enricher
  • f3eafcf refactor; enricher state
  • ab0657b refactor; chat state; change input state
  • 3ad9ac1 refactor; chat state
  • 1593ed4 update logic
  • 3971f8b update configs
  • 6ece08d update english fewshot
  • 24e5f5c update enrich
  • c252985 rm logs
  • 92bcab2 revert complete(collab upload version
  • 5c8752f revert 2ab7f3608e53e3e1a4141cfa32e76fb5aafcf518
  • e27216d revert 2ab7f3608e53e3e1a4141cfa32e76fb5aafcf518
  • 33b391f revert 2ab7f3608e53e3e1a4141cfa32e76fb5aafcf518
  • ec44b6f update detection performance
  • c0fcf41 revoke the exception upgrade
  • 37d924e upgrade detection logic(exception upgrade)
  • 6f3d1db upgrade schema
  • 0189600 update schema
  • efbd365 upgrade enrich
  • b49d619 update mask situation
  • 24014fd update schema and enrich fewshot
  • 44e7bf1 upgrade
  • c789218 update multi frame
  • dd7081d update prompt
  • 2ab7f36 update va schema
  • 8f21536 upgrade enrich
  • bd891c3 upgrade logic
  • 88594b5 upgrade fewshot
  • 97d1c00 fix bug
  • 58f2fe2 fix error
  • ce0212f update VA logic
  • f3fbb5a upgrade schema
  • 414a98c rm logs
  • 8a99abd upgrade exception logic (change to it to batch logic)
  • 619e0e5 change exceptions to excluded situations
  • 427ca0b app_lang->lang
  • 3c0bddc style: camera package log
  • 8eceb78 rm videos
  • 8d0bb2b resolve conflict
  • fea49c9 fix check user query bug
  • 1aa0d08 feat(graph_runtime): GraphExecutor를 CompiledStateGraph cache 중심 구조로 전환
  • 392e5e1 refactor(config): normalize YAML discovery + path parsing helpers (no behavior change)
  • 76d50a3 refactor(visual-api): delegate feedback apply stage to ApplyFeedbackGraph
  • 920426d refactor(feedback-api): route record endpoint through RecordFeedbackGraph
  • d4534b5 refactor(feedback-pipeline): extract feedback graph/node service layer foundation
  • 14ba636 refactor(graph-runtime): fix decorator typing + tighten graph instance types
  • 14cfcb9 fix(helm): gate s3 sync init container by flag
  • 5a854c3 feat: qdrant migration & backup helper utils
  • a57a346 remove: deprecated files
  • 59ba357 fix: chart behaviour (allow dynamic pv with values)
  • f2ff678 add: downstream custom vllm chart (allow dynamic shared pv + helm annotation)
  • 6cfa020 remove: helm values override yaml files
  • 07e5b04 feat: Package Control based on Detection Interval (Alert-Interval)
  • 31c9e9b refactor: minor changes
  • 2c41451 update eng fewshot
  • a781edf update pyproject
  • 925e488 upgrade agent logic
  • af8d6e3 fix last frame
  • 3aef014 add TODO
  • 57f8b51 update VA and EA for multi frame
  • 7a7665e refact: mfm refactor
  • 5bfeec4 fix: request param error
  • 60d25eb update: early return if no package
  • 181638d update: package class for visual agent
  • f830971 feat: add multi-frame manager and queues
  • 7f44c07 merge: save router as snapshot to merge develop branch (reflect latest)
  • 68f4eb1 merge: save router as snapshot to merge develop branch (reflect latest)

운영 영향 chore​

  • 7189158 minor version 기준을 2.6.0으로 상향
  • 8da76ce .dockerignore에 deploy/ 폴더 추가

v2.5.0 (Feb 12, 2026)​

Highlights​

  • 채팅 인터페이스 정리: chat_lang에서 lang 중심으로 전환을 시작하고, MetaBase 도입으로 공통 메타 스키마를 재정렬했습니다.
  • Visual-RAG 파이프라인 고도화: detection_scenario와 detection_case를 분리해 임베딩/업서트/검색 흐름의 정확도를 높였습니다.
  • RAG 검색 품질 개선: weighted_sum_power 점수 방식을 추가하고 텍스트 임베딩 모델 intfloat/multilingual-e5-small을 도입했습니다.
  • 배포 런타임 업데이트: Python 3.12 기반으로 전환하고 Qdrant 이미지를 공식 이미지로 정리했습니다.
  • 운영 자동화 강화: AWS/Kubectl/Qdrant 운영 스크립트를 확장하고 모델/프롬프트 동기화 유틸을 개선했습니다.

Breaking Changes​

  • 채팅 언어 필드 전환: chat_lang는 향후(v2.6.0) 제거 예정이며 lang 사용이 권장됩니다.
  • 메타 스키마 변경: MetaBase 기반으로 메타 구조가 재편되어 기존 메타 파싱 로직 점검이 필요합니다.
  • 컨테이너/환경 구성 변경: Ollama/Qdrant 관련 env 파일이 제거되고 Qdrant 컨테이너/헬스체크 방식이 변경되었습니다.

Features​

  • 파서 개선: 포맷 지시를 단순화하는 커스텀 Pydantic 파서를 추가했습니다.
  • RAG 유사도 측정 metric 추가: weighted_sum_power 기반 스코어 조합 로직을 추가했습니다.
  • Logit 레지스트리 완화: 미등록 키 조회 시 빈 dict를 반환하도록 정책을 완화했습니다.
  • Visual-RAG 구분 임베딩: detection scenario/case 분리 임베딩과 공통 지연 측정 로깅을 추가했습니다.

Fixes​

  • Enrich API 안정화: Enrich 요청에서 발생하던 422 오류를 수정했습니다.
  • Chat 라우팅/히스토리 보강: get_history, 에러 경로, 라우터 값 전달, parser 방어 로직을 다수 보강했습니다.
  • 벡터 임베딩 경로 정리: Visual Agent 벡터 임베딩/업서트/검색 경로의 공유 흐름을 정비했습니다.

Config & Deployment​

  • 기반 버전 업그레이드: Dockerfile/pyproject.toml/uv.lock을 Python 3.12 기준으로 정렬했습니다.
  • Qdrant 런타임 전환: 커스텀 Qdrant 이미지를 제거하고 공식 이미지 + bash 기반 헬스체크로 변경했습니다.
  • 모델/프롬프트 설정 동기화: model_config_util.sh를 agent 스코프와 model_type 동기화까지 확장했습니다.

Changelog (non-chore, 35 commits)​

펼쳐보기
  • 97b69ee Date: 2025-02-xx Scope: Visual agent vector embedding pipeline (shared embeddings, upsert/search flow)
  • 012e504 upgrade chat history
  • e2a2930 upgrade chat
  • e3fae36 update config
  • b81fd83 add: intfloat/multilingual-e5-small (text) embedding model
  • 9beba0c feat: custom parser for simpler format instruction
  • d55a20c feat(rag): add weighted_sum_power scoring
  • abbf149 feat(visual-rag): split detection_scenario vs detection_case for embedding + ChatState validation + traceback logging + shared embed latency debug
  • 9fa158b rm _ infront of function's name
  • 15cd4eb add TODO
  • c078393 rm redundent logic
  • 1c90f1d add edge for handle error
  • 81d9f6a add get_history node
  • eda1c7f refactor format_history
  • 52fa1c7 refactor format_history
  • 7ab2689 add todo
  • 2721184 rm error log
  • 045738b upgrade handel_error prompt
  • d7f8124 exaone prompt
  • 30e7c6d update: change chat_lang to lang (chat-lang will be deprecated from 2.6.0)
  • 98ca11c refactor(api): MetaBase 도입으로 Meta 분리
  • 1972859 fix: request 422 error
  • 17a503c update: base python version to 3.12 from 3.11
  • 9ba03d6 deprecate: ollama docker configs
  • e2bf6dd remove: custom qdrant and use official image
  • 5d8b641 update: qdrant healthcheck to use bash only (official image doesn't install curl)
  • 983ffe5 docs: update README
  • e115bc9 docs: update README
  • 1a097e3 docs: update .env.sample comment unnecessary fields & remove deprecated variable
  • ef9a6e1 remove: ollama related env files
  • e5f1950 remove: qdrant env files
  • 96d5f57 feat: loosen logit registry get policy (return empty dict if not exist)
  • 7212dcb remove: Exaone 4.0 configs from vlm relate agents
  • 37550bf update: config files to sync prompt & model_type
  • f288f47 feat(config): extend model_config_util with agent scoping and model_type update

운영 영향 chore​

  • 6b81e03 deploy 유틸 스크립트(AWS/S3/Kubectl/Qdrant) 추가
  • f0f16b5 deploy 스크립트 실행 권한 정리

v2.4.3 (Feb 09, 2026)​

Highlights​

  • EVA App 기준에 맞춰 set_target_threshold 범위를 서버와 일치시켰습니다.

Breaking Changes​

  • 외부 인터페이스 브레이킹 변경은 없습니다.

Features​

  • 신규 기능 추가 없음(정합성 핫픽스 릴리즈).

Fixes​

  • set_target_threshold 허용 범위를 [0.1, 1)로 고정하여 앱/에이전트 동작 불일치를 수정했습니다.

Config & Deployment​

  • 액션 노드/설정 파일의 임계치 검증 조건을 동기화했습니다.

Upgrade Notes​

  • 기존에 1.0 또는 0.1 미만 값을 보내던 클라이언트는 [0.1, 1) 범위로 조정해야 합니다.

Changelog (non-chore, 1 commit)​

펼쳐보기
  • 4d894e3 fix: match target threshold range to EVA App [0.1, 1)

v2.4.2 (Feb 04, 2026)​

Highlights​

  • Chat 라우팅 체계 재정리: router_values 전달 기반으로 action/qna 라우터 흐름을 정비했습니다.
  • 히스토리 처리 개편: get_history 경로와 상태 타입을 재정렬하여 QnA/에러 처리 연계를 강화했습니다.
  • Visual/Enrich 출력 정합성 강화: detection_case 반영, 우선순위/캡처 모드 표현 보정 등 스키마/출력 동기화를 진행했습니다.

Breaking Changes​

  • Chat 내부 라우팅 계약 변경: pre-chat → router → action/qna로 전달되는 state 필드가 조정되어, 커스텀 노드 확장 시 재확인이 필요합니다.
  • 출력 스키마 보정: enrich/visual 일부 필드명/출력 값 정규화가 반영되었습니다.

Features​

  • Chat QnA/Router 프롬프트와 가이드 문구를 확대하고, 경로별 방어 로직을 추가했습니다.
  • Exaone/Qwen 설정 파일을 대량 갱신하여 chat 흐름과 프롬프트 버전을 맞췄습니다.

Fixes​

  • QnA 라우터 반환값, task_type 전달, parser 예외 처리를 연속 수정했습니다.
  • get_history 누락/오동작과 에러 핸들링 경로를 보완했습니다.
  • Visual/Enrich 출력 타입 및 값 정규화를 통해 후속 파싱 오류를 줄였습니다.

Config & Deployment​

  • config/chat_agent/** 중심으로 액션/라우터/검증기 설정을 업데이트했습니다.

Changelog (non-chore, 50 commits)​

펼쳐보기
  • a4dc6fd change translation state to Any
  • f9f45b2 update route_task function and rm route_brightness function
  • d229cec change get_history
  • 0be5635 change chat_history 's type
  • cb42b84 change get_history function
  • 78c1fe7 set language
  • 08009b4 change set_target.py
  • c039bc7 rm () from keys
  • d3909d3 update prompts
  • e12d8fa add guide
  • fbf027e refactor chat llm
  • 772e98a update configs
  • 83fdb81 update configs(Exaone)
  • 7744092 add router value
  • 48fb79c add router value to router functions
  • f76bd93 fix error; action_router returns router_values
  • 0116c54 fix error; qna_router returns router_values
  • 9e5af87 fix error; give task_type to qna router
  • 573396b fix error; get_history
  • 47a0a8b add prompt
  • cabbf8e rm files and change history length
  • 31f05a2 update configs
  • 9975060 update configs
  • d5126af upgrade chat llm
  • 3d5c675 (fin) upgrade chat agent for 2.5.0
  • d9ae263 rm logs
  • 814c530 del Low in priority
  • 7536580 add detection case in visual agent schema
  • 472b70f change get output function
  • 53fd05a add lower to priority
  • bb98fd6 add lower to capture mode
  • 3b844a4 change output
  • aa3e3c6 update VA
  • d2c7bce update agent
  • 810ba76 fix bug
  • 8d967f6 change schemas
  • 658dbea add defence logic
  • 4395b58 change get_history
  • 8ed689a fix parsers
  • ad25013 fix error
  • 5f1f606 upgrade chat
  • aace1ce rm false positive feedback
  • 7d0feee update configs
  • 1079d55 change logs
  • 44924ed change camera
  • 2be4746 rm folders
  • bdc5782 rm vars
  • f2ff78a change settings
  • 596ebbc clean codes
  • 1790751 resolve conflict

v2.4.1 (Feb 01, 2026)​

Highlights​

  • Visual 그래프/노드 리팩토링: one_step/two_step을 single_step/multi_step으로 재정렬하고 체인 빌더/메시지 빌더를 공통화했습니다.
  • Enrich 파이프라인 확장: pre_enrich/enrich_scenario 구조 정리, meta_core/priority/window 처리 강화, 번역 그래프 연계를 추가했습니다.
  • Chat 구조 고도화: BaseModel 상태 전환, build_chain 통일, history 관리, 방어 로직 강화가 대규모로 반영되었습니다.
  • Helm 배포 개선: model cache(PVC/S3) 및 ECR refresh 경로를 추가하고 서비스 구성 변경을 반영했습니다.

Breaking Changes​

  • 그래프/노드 명칭 변경: visual graph 및 일부 노드 명칭 변경으로 내부 import/설정 경로를 재점검해야 합니다.
  • Enrich 설정 경로 변경: multi_scenario → pre_enrich, single_scenario → enrich_scenario로 구조가 바뀌었습니다.

Features​

  • Visual/Enrich 노드에서 입력 리스트/메시지 구성 유틸을 도입해 공통 처리 기반을 마련했습니다.
  • Translation graph/node를 추가해 enrich 흐름 내 번역 처리 경로를 명확히 분리했습니다.
  • Chat에서 방어 로직/메시지/프롬프트/스키마를 연속 개편했습니다.

Fixes​

  • Visual feedback metadata의 Pydantic 검증 오류를 핫픽스로 수정했습니다.
  • Visual Agent 요청 이미지 타입을 보정하고, enrich/translation 경로의 타입/로깅 이슈를 다수 정리했습니다.

Config & Deployment​

  • Helm chart에 model cache 관련 설정을 반영하고 chart 버전을 갱신했습니다.
  • Chat/Visual/Enrich/Translation 설정 파일을 v2.4.1/v2.5.0 기준으로 대규모 동기화했습니다.

Changelog (non-chore, 141 commits)​

펼쳐보기
  • bf2be72 add utils.py and build_messages function within
  • 110d6de add build_messages function to two step and fix bug in build_messages function
  • 6142c38 add build_messages function to one step node
  • bf18573 add build_messages function to img_description node
  • ff655b2 add build_messages function to alert_message node
  • e80bc6f add get_input_list function in utils.py
  • 9077a91 add get_input_list function to one_step node
  • 74615f1 fix typo
  • 18786e3 add get_input_list function to two_step node
  • 366c967 add get_input_list and build_message function to two_step node(exception node)
  • c7f4119 rm get_input_list function
  • 9cebc30 rm get_input_list function
  • 2f7afec add build_visual_llm_runnable
  • 6ca40e5 apply build_visual_llm_runnable
  • c39f0ad change build_llm_runner to chain builder
  • 20692f6 refactor build vlm chain
  • 82a7805 refactor basic_graph.py and base graph
  • 28d253b refactor base.py
  • e9d1f4a refactor one_step, two_step graphs
  • 2dbd6d8 change the one-step graph;s name to single-step
  • 9ff5916 change the two-step graph's name to multi-step
  • 6c407c5 change result to plural
  • c1a3803 clean state
  • 0db9cae rm area state
  • d116b54 seperate multi step graph's node
  • 500b6c4 clean node level python files
  • 6425524 change exception to exception condition
  • 18f41dc change exception to exception condition
  • 93eaada rm print and refactor check user query
  • 23efe54 refactor image processor
  • 656e124 add english to the language condition
  • e1a9ee4 apply get_vlm_chain function to enrich agent's node
  • 0da0953 refactor enrich-agent
  • b5fc250 seperate kor/eng fewshot
  • 6a6d75a fix error
  • 5d89744 rm translation node and rm logs
  • 354e95c rm logs
  • 1ea5fc4 rm unused fields
  • ed0f7c4 rm unused module
  • 04c60e3 add required translation
  • 402fbe3 refactor get_output.py
  • 3b27e9c change the folder level of enrich agent
  • 446747f change the node config for enrich agent"
  • 4cfd8f2 change the path of the configs for enrich agent(multi_scenario to pre_enrich and single_scenario to enrich_scenario
  • b047a39 update version of the configs
  • 10bcc08 update config version to 2.4.1
  • c71d44d change metadata to meta_core for adding the meta_priority and duration
  • 53b7780 add priority node and apply to overall enrich pipeline
  • 0d28fd6 add int>string convertion logic for priority
  • 680a197 add temporal scope node and apply to overall enrich pipeline
  • 596b4d6 upgrade priority prompt and fewshot
  • e14dd2b upgrade enrich priority's fewshot / prompt
  • 79398df update temporal scope description
  • e3e9cd3 change temporal_scope to window
  • b4c5895 rm annotations
  • f3a29d3 change window logic
  • e6840bb change window logic
  • 900a59b change window to monitoring and add monitoring range
  • c1a43ab rm korean examples from monitoring schema
  • e3f7cab change output format
  • 0171d90 update config versions"
  • 799b871 update check user query logic
  • 476b556 upgrade config's version
  • 53c9bea rm logger.error
  • d9e15d5 PR Title feat(helm): eva-agent에 model cache PVC 도입 + Service를 ClusterIP로 전환 (Chart/App 2.4.0)
  • cd05124 update utils.py
  • 3a7a218 update image type for Visual Agent request
  • c1992e0 upgrade utils.py
  • c39ecf4 rm getattr in single_enricher.py
  • eaec6ac rm useless getattr in this branch
  • 37ca4bf change output type of route_by_translation function(in single enricher)
  • 29ac7e8 change required_translation field to boolen type
  • 8e278bf rm logger in multi_step graph
  • 147a04a add START node
  • f109434 change enricher's logger (dict->pydantic)
  • b09224d rm translator-related functions from base.py
  • e73ef2e change output type of build_graph
  • cb2faf8 add translation nodes/and graph
  • 2189664 rm getattr
  • fced1d2 rm none
  • 2b69797 clean logs
  • f5ad44f add assert and clean enrich agent
  • fbb922d add defend logic
  • ae56d1c change type of the fewshotexample's payload
  • 17195be add language option to build_vlm_chain
  • 79bd30f apply defense logic
  • efad507 assign response's type
  • 98eed36 rm importing the time module for every node
  • c994878 update get_output
  • 0574a2a add defense logic
  • 97871b8 change the type of the content
  • 888586d allow more ascii chars in translation utils
  • 894e933 rm image_b64 from build_vlm_chain';s output
  • a355e7d rm assert scneario_list
  • 208b265 change type of the vars
  • 0daf8e0 clean enrich state(sep fewhsgot state
  • 89bb455 update utils.py
  • 7dbd221 clean states
  • 196a721 rm logs
  • eb53946 rm list type from images
  • 335f14e add mode/priority to agent logic
  • bae1e17 add defense logic for priority
  • 4a3fcf6 change logic for mode/prioirty
  • 8bab795 change camera settings to detection settings
  • d659fcd change logic to detection settings
  • ca7b2e8 change mod_str->monitoring_str
  • 7b0783c change monitoring to capture
  • 3bd66fb add type for parser
  • 8bdd7da change build_vlm_chain to build_chain
  • e7e3398 change state type from dict to basemodel
  • 6a13c29 change typed dict state to basemodel state
  • 6e391d3 add defense logic ( task_type=state.task_type or None, )
  • dc68000 add defense logic
  • c22ef3d apply build_chain(to classify task type node
  • f647832 replace codelines to the build_chain functions
  • 6d13a88 add is_vlm var to build_chain
  • c155a6a rm unused modules
  • 56e6cc9 limit chat history
  • ba2cecf clean configs and add src for chat_history
  • 88231d6 change prompt
  • 2269815 error fixed
  • 3a05ad3 clean prompt
  • c4e9475 upgrade chat llm
  • 5014a52 upgrade chat
  • 1d1f6de upgrade chat agent
  • 9c43e96 upgrade chat
  • e972f6d upgrade chat
  • 884e3e1 upgrade configs
  • 385ec25 add eng descriptions
  • 66649a0 add annotations
  • 32b2cd7 add schemas
  • 59e82d2 refactor llm agent
  • 9ed6f57 add defense logic
  • d5363ca change debugger's port
  • 7d7acaf update messages
  • d7dd0b2 update messages
  • dd79a12 update messages
  • b926f35 add defense logic
  • 5aeba08 update configs
  • 56b764e feat(chart): add ECR refresh + S3 model cache
  • e45f304 fix: visual agent feedback's metadata pydantic model validation

운영 영향 chore (선별)​

  • 3637012 모델 설정 보조 스크립트(model_config_util.sh) 추가
  • 3565456 deprecated Helm chart(ollama) 제거

v2.4.0 (Jan 21, 2026)​

Highlights​

  • 피드백-벡터 루프 강화: analysis_id 기반 피드백 upsert와 Visual 결과 연계 메타데이터 흐름을 추가했습니다.
  • RAG/Qdrant 검색 정교화: metadata filter 확장, 유사도 threshold 반영, Qdrant 연동 옵션을 강화했습니다.
  • API 부트스트랩 구조화: router 패키지화, DI 및 lifecycle 분리, graph registry bootstrap을 도입했습니다.
  • 언어/출력 품질 보정: visual/enrich/translation의 언어 처리 및 출력 스키마 정합성을 다수 개선했습니다.

Breaking Changes​

  • Qdrant 환경 변수 전환: QDRANT_HOST/QDRANT_PORT가 제거되고 QDRANT_BASE_URL 중심으로 변경되었습니다.
  • 벡터스토어 팩토리 인자 정리: host/port 분리 인자 제거에 따라 초기화 코드를 점검해야 합니다.
  • 출력 필드 변화: detection scenario/case 관련 출력 구조가 점진적으로 보정되었습니다.

Features​

  • analysis_id/image_id를 포함한 feedback payload 확장 및 analysis 단위 upsert를 지원합니다.
  • alert=True 결과의 자동 벡터 upsert를 추가해 후속 검색/보정 흐름을 강화했습니다.
  • KO/EN logit bias 레지스트리 및 Qwen3-VL-8B용 언어 편향 설정을 추가했습니다.
  • provider/model 카탈로그 조회 병렬화 및 기본 타임아웃 정비를 진행했습니다.

Fixes​

  • provider 옵션 캐시 누수, dictionary unbound, camera context nullable 검증 실패를 수정했습니다.
  • enrich classifier 예외 처리, language 강제 처리, 번역 전처리(숫자 단어 포함) 등 다수 보정이 반영되었습니다.
  • Visual/Enrich 상태 및 스키마 정리로 불필요 필드/로그를 제거하고 안정성을 높였습니다.

Config & Deployment​

  • docker build/compose 경로 및 런타임 env 분리를 정리하고, vLLM endpoint 분리를 반영했습니다.
  • .env.eva-agent.sample과 Qdrant 관련 환경변수 문서를 최신 구조에 맞춰 갱신했습니다.

Tests & Quality​

  • 대규모 리팩토링 과정에서 포맷팅/타입 캐스팅 정리와 함께 테스트 구조 변경이 동반되었습니다.
  • 이 구간에는 단위 테스트 제거 커밋이 포함되어 있으므로 후속 테스트 보강이 필요합니다.

Upgrade Notes​

  • 배포 구성에서 QDRANT_BASE_URL을 사용하도록 반드시 전환하십시오.
  • feedback/visual 연동 시 analysis_id 및 확장 메타 필드를 처리하도록 클라이언트를 갱신하십시오.
  • API bootstrap 구조 변경에 따라 앱 초기화/DI 의존 경로를 재확인하십시오.

Changelog (non-chore, 132 commits)​

펼쳐보기
  • 7c56352 fix(providers): probe model catalog concurrently
  • de528a5 change the schema of the detection_results
  • 77e07eb fix sort_dictionary function
  • 9e0ef08 fix sort_dictionary function in validator
  • 0fd63bd fix bug; add cls var in sort_dictionary in validator function
  • 65254ce fix bug; update exceptions
  • 242752c add comments
  • 1c5ed86 rm print func
  • 87a969f change the func name (sort_dictionary to sort_list)
  • 1b9f369 Add grouping node
  • 0773ded Add grouping schema
  • 4cf20c1 add fewshot examples for multi-scenario grouping function
  • 068d600 add situation explaination to collapsed person fewshot example
  • f2ecf1a refact: apply LLM registry's llm call pattern for each nodes
  • f0aa8c4 Add: build-system to .toml
  • 0cc3c57 remove: deprecated visual-agent code
  • b7b777b Refactor: move /app/api to /src/eva_agent/api and resolve import path
  • 3b48a63 remove: deprecated chat-agent related code
  • 70b548b Refact: move /src/rag to /src/eva_agent/core/rag to follow src layout
  • 8b2d111 Refact: move langfuse related to /src/eva_agent/o11y/langfuse
  • 9f00230 Remove: unused app/provider (replaced by src/providers)
  • b88aeb5 Refact: move src/providers to src/eva_agent/core/providers to follow src layout
  • 48a58f9 remove: init from src(src is not module)
  • 8f3c0ce refact: move /app/core to corresponing name (graph / config) under eva_agent module's core
  • f55deef Refact: move app/node & app/schemas under src/eva_agent/nodes/ src/eva_agent/schemas
  • 89e39d2 Refact: move app/graph under src/eva_agent/graph
  • 5bd9e2d remove: main.py's path config (decouple import path dependency)
  • 274bdbf remove: deprecated app's module init.py
  • 50e1dc3 Refact: move src/agents/models.py to src/eva_agent/core/providers/models.py
  • 548883e Refact: move src/vision/schemas.py to schemas/common.py & feedback.py
  • 22c7f12 Remove: deprecated vision directory
  • 1afa147 Update: build stage (copy src code first for uv build)
  • c52b990 Update: exclude READMD.md from docker ignore (toml's readme section added)
  • af91b46 fix: type
  • 7ebafa6 add logs and prompt line for translation node
  • a733a2e change log level(info->debug)
  • 698f8ab change lang var flexible
  • 444b039 change lang var non-flexible
  • 8956f80 update translation prompt
  • bccae6f update translation logic
  • 83406ed Update: default kv-cache-dtype for vllm to auto not fp8
  • aadc86e Update: image tag for docker-image to 2.3-a3.1
  • d70fefb Update: bump patch version (hotfix for translation logic)
  • 7843db1 fix data type of area_num to int
  • d436177 update translation config
  • dfb944e update the config(max_tokens) of enrich-agent
  • 7550ca3 update the config(max_tokens) of enrich-agent(detection step)
  • 2f002a2 Refact: visual agent API typing
  • a756eda add optional to enrich schema
  • 55b4425 update visual agent(detection,exception) config
  • 0d3aabd feat(docker): make venv copy deterministic and scope compile step to app code
  • 2dd23aa update: image tag version bump (patch)
  • b7d7451 update: proejct package version bump to 2.3.2
  • e7fa623 refact: add "model_type" key in registry and yaml
  • 9824398 docs: create Exaone4.0 yaml files in chat agent
  • d9dccd7 update: fall-back to prompt and metadata part for configs
  • 1f69838 update: add new seperated vllm endpoint for vlm/llm respectively to dockker-compose.yml
  • 4de7e72 update: .env.eva-agent.sample to reflect env(runtime) split
  • a53d754 fix: raise timeout 5s(default) to 10s for langfuse client
  • c5c6793 update: add timeout(30s) to each provider's default llm invoke parameter
  • 814a8db remove: deprecated qdrant related env vars
  • 6d4025b Remove: QDRANT_HOST, QDRANT_PORT and replace them by QDRANT_BASE_URL
  • 4d4b72c Refact: stricter output validation for enrich agent output
  • 13631cc remove: host & port from vector store factory method (AsyncVectorStoreEngine)
  • 5dfefb8 refactor(api): split enrich agent into package + router module
  • f546af2 refactor(api): wire visual agent router via package export in main
  • 800eccf refactor(api): convert chat_agent v1 endpoint into package
  • 85530d9 refactor(api): convert feedback v1 endpoint into package
  • 9b90658 refactor(api): extract FastAPI app + lifecycle out of main
  • 0dc6bef refactor(api): centralize router/graph registries
  • 7001c89 Refactor GraphExecutor wiring to FastAPI DI (app.state + Depends)
  • 0555e5a Refactor: extract visual-agent RAG bootstrap into lifecycle service
  • 09f3842 Add graph bootstrap registry loader (register_graphs) and update lifecycle/docs
  • c5ecaef add scenario_case in ScenarioList Schema
  • e8af38b add scenario_case in function classyfiy steps
  • 9323b65 change detection scenario to case in function get_output
  • 7a8948b consider the situation when the case is None
  • 143e914 feat(rag): broaden Qdrant metadata filtering
  • 2be4c71 refactor(rag): widen metadata_filter signature to accept MetadataFilterSpec (keep dict)
  • 9968272 Apply similarity score threshold in Qdrant store (preserve retrieved points)
  • d9e9e9e add analysis id into analysisItem schema
  • c5d857a add analysis id into get_output function
  • c5aa82b feat(feedback): add analysis-scoped identifiers to visual feedback payload
  • ffdc927 feat(visual-agent): auto-upsert vectors for alert=True analysis items
  • 3aee412 fix(visual-agent): preserve analysis_id and use UUID type end-to-end
  • 5e434ed feat(feedback): upsert feedback by analysis_id and carry image_id in metadata
  • 3446d62 first commit
  • 6d3e4f5 fix: make camera_context allow None (validation fails)
  • 346f803 add: qwen3-vl-8b model logit_bias for KO/EN
  • f38c7b7 Add: logit_bias registry class
  • c60aaeb add language settings and multi-processing nodes
  • 8c3385b add language logic
  • 20b81de add logit bias to img description node
  • e351885 update translation agent and rm useless function
  • 19d69be update enrich agent(logic bias
  • 851eef5 update alert response
  • aca6df2 change print->logger.debug and rm useless debugs
  • ef505cc rm scenario list and detection results
  • d12f235 rm current step
  • a57581a rm non-used field in the visual agent's state
  • 73573a1 rm useless lines
  • 2bf101c rm logs
  • 111ca63 rm unnessesary code
  • 7e4f01f add description for the functions and rm unnessesary function in translator
  • 6393597 add docstring
  • 3753d22 add node config
  • 253ed34 change the location of the image description
  • 6293746 add description edge to basic graph
  • a1627d6 clean visual agent's state
  • 0fad732 allow numeric words for translator pre-check logic
  • 8f5a997 rm useless edge
  • fc2b633 re-name two-step graph's node
  • f36d0b5 update the description of the alert message schema
  • acda558 refact: language correction
  • cfa43f4 rm non-used configs
  • f152b1f rm logs
  • 475f552 modify lang setting for visual agent
  • 46e651a modify lang setting for enrich agent
  • 41f37a8 modify lang setting for visual agent(change upper to lower letter
  • 05a25a6 change the folder level of alert_message and img_description node
  • c3af090 change the graph nome for alert_message and image_description nodes
  • 61ee3a4 change llm_runnable for alert_message and image_description nodes
  • d694a77 change llm_runners for enrich agent
  • ab9adc8 fix dictionary unbound prob
  • 2435467 add logit for exaone
  • 13675fc fix(providers): ignore config options to prevent cached default leakage
  • a43d256 Docs: update REAMD.md to reflect latest version (v2.4.0)
  • 878c3ef docs: remove unnecessary sentences
  • eef0f0b add language force lines to the config filse
  • 0327e30 add language to the human message
  • e66d470 add try/except to the enrich classifier
  • 7ad7397 modify visual agent's prompt

운영 영향 chore (선별)​

  • 870b36c Dockerfile uv 버전 pin
  • 1a54b1c unit test 제거(후속 보강 필요)

v2.3+a3.0 (Dec 26, 2025)​

Highlights​

  • LangGraph 기반 아키텍처로 대규모 리팩토링: 새로운 app/ 레이어(API/Core/Graph/Node/Provider/Schema) 도입, GraphRegistry/GraphExecutor 추가, 버전 해석 기능이 포함된 YAML ConfigLoader 구현.
  • Visual Agent v1 전면 개편: basic_graph에서 1단계 및 2단계 서브 그래프를 병렬로 실행하여 결과를 통합하며, 선택적으로 번역 및 이미지 설명 생성을 단일 엔드투엔드 파이프라인으로 실행하도록 개선.
  • 강력해진 Feedback ↔ RAG 루프: /api/v1/agents/feedback/record 추가, 벡터 저장소 헬퍼/의존성 주입(DI) 추출, Visual 쿼리 후 벡터 검색을 수행하여 과거 피드백을 기반으로 알림을 교정하는 기능 추가.
  • 설정 시스템 재설계: config/{agent}/{graph}/{node}/{model}/{version}.yaml 구조로 표준화하고, Qwen3-VL (FP8) 설정을 추가했으며 호환성을 위해 기존 별칭(qwen2.5-vl-32b-awq) 유지.
  • 패키징 및 배포 기본값 업데이트: docker-compose의 기본 모델을 Qwen3-VL-8B-Instruct-FP8으로 변경하고 vLLM 성능 플래그 추가; eva-agent 이미지 태그를 2.3-a3.0으로 업데이트.

Breaking Changes​

  • API 스키마 및 페이로드 변경 (중요)

  • Visual 쿼리가 기존의 단일 vision.schemas.VisualQueryRequest/Response 흐름에서 app.schemas.visual_agent.VisualAgentRequest/Response로 이동 (scenario_list 기반, 통합 meta 모델 사용).

  • 피드백 기록 요청 스키마가 통합 meta를 중심으로 정렬되었으며, 엔드포인트가 /api/v1/agents/feedback/record로 노출됨.

  • 통합 meta 스키마가 app/schemas/common.py에서 Pydantic 모델로 강제 적용됨에 따라 클라이언트의 meta 페이로드 형식이 엄격하게 검증됨.

  • 설정 경로 및 파일 레이아웃 변경 (중요)

  • config/vlm/**, config/enrich_scenario/**, config/llm/prompts/conversational_agent_system_prompt.md와 같은 기존 설정 트리가 제거되거나 교체됨; 서버는 새로운 ConfigLoader 경로 규칙을 따름.

  • 환경 변수 정리

  • 더 이상 사용되지 않는 프로바이더/환경 변수(LLM_PROVIDER, LLM_MODEL, OLLAMA_BASE_URL 등)가 .env.eva-agent.sample에서 제거됨; 배포 시 업데이트된 샘플에 맞춰야 함.

  • 내부 모듈 경로 변경

  • src/messages/** 및 src/vision/detection_scenario/**와 같은 기존 코드가 제거되고 새로운 app 레이어로 교체됨; 내부 임포트 경로가 크게 변경됨.

  • 인프라 엔드포인트 제거

  • 기존의 /infra/models 엔드포인트가 제거됨 (main.py 리팩토링).

Features​

  • API 레이어

  • 라우터 모듈화 및 문서화: app/api/v1/{visual,chat,enrich,feedback} 및 app/api/dependency.py를 통한 RAG 엔진 및 벡터 저장소 설정 매핑 의존성 주입.

  • 422 검증 예외 처리기 추가 및 health/healthz 엔드포인트 제공.

  • Visual Agent

  • 다중 시나리오 요청: scenario_list 입력 및 analysis_list를 통한 시나리오별 결과 반환.

  • 벡터 검색 기반 알림 교정: 피드백 기반 퓨샷(few-shot) 데이터를 검색하여 알림을 조정; Langfuse 스팬(span)에 임베딩/검색/교정 단계를 기록.

  • 번역 파이프라인: 알림이 발생하면 이미지 설명 생성과 병렬로 TranslatorGraph를 통해 후보군만 번역 수행.

  • Enrich Agent

  • Enrich 그래프를 비동기 노드로 리팩토링하고, 출력 스키마/필드를 강화하며 영역(area) 및 메타데이터를 더 일관되게 반영.

  • (실험적) 다중 시나리오 보강: 분류기/분해기 기반의 케이스 분리 기능 추가.

  • 프로바이더 및 모델 카탈로그

  • (내부) 프로바이더별 모델 목록 개선 및 카탈로그 유틸리티 통합.

  • 관측 가능성 (Observability)

  • Visual-Agent/Feedback/Chat-Agent를 위한 강력한 Langfuse 트레이싱: 계층적 스팬, 트레이스 메타데이터 업데이트, 시나리오 컨텍스트 전파.

  • 콘텐츠 인식 이미지 마스킹: base64/데이터 URL뿐만 아니라 알려진 이미지 바이트 시그니처로 디코딩되는 페이로드까지 스크러빙 처리.

  • 문서화

  • README_DEV.md 추가 및 App/Core/Graph/Node 각 레이어별 가이드 제공.

Fixes​

  • Visual Agent 안정성 및 정확성

  • 2단계 인퍼런스 예외 상황, 정렬, 출력 스키마 문제 수정; 시나리오 순서 안정화.

  • None 영역 처리 및 언어 관련 문제 수정 (예: 영역 문자열에 영어 강제 적용).

  • 번역 로직(중복 생성/업데이트 버그) 및 출력 형식 수정.

  • Chat Agent UX 및 일관성

  • 지원되지 않는 요청 흐름 개선 및 시스템 답변에 작업 유형이 유출되는 문제 방지.

  • 감지 간격 단위/메시지 명확화, 오탐지 컷오프 범위 조정, 타겟 추출 및 검증 수정.

  • RAG/Qdrant

  • Qdrant URL/환경 변수 처리 및 관련 유틸리티(예: 베이스 URL 지원) 개선.

Config & Deployment​

  • Docker Compose

  • vLLM 기본 모델을 Qwen3-VL (FP8)로 교체하고 KV 캐시 데이터 타입, 청크 단위 프리필(prefill), 프리픽스 캐싱 등 플래그 추가.

  • eva-agent 이미지 버전을 eva-agent:2.3-a3.0으로 업데이트.

  • Config

  • 새로운 경로 규칙에 따라 Visual/Chat/Enrich/Translation Agent를 위한 대규모 버전별 YAML 설정 추가.

Tests & Quality​

  • Pre-commit 포맷팅 및 스타일 수정 적용 (black/isort, 공백 제거 등).

Upgrade Notes​

  • API 클라이언트

  • Visual 쿼리/피드백/보강/채팅 페이로드가 이제 통합 meta 모델을 기반으로 함; app/schemas/*.py를 기준으로 클라이언트를 업데이트해야 함.

  • Visual 쿼리는 이제 analysis_list를 통해 시나리오별 결과를 반환함; 기존의 단일 시나리오 응답 파싱 로직 업데이트 필요.

  • Config

  • 기존 config/vlm/** 및 config/enrich_scenario/** 설정을 새로운 규칙인 config/{agent}/{graph}/{node}/{model}/{version}.yaml로 마이그레이션 필요.

  • 환경 변수 및 Docker

  • 환경 변수를 .env.eva-agent.sample에 맞추고(지원 중단 변수 제거), docker-compose 기본 모델/옵션 변경에 따른 vLLM/Agent 설정 재검토 필요.

  • 로컬 실행(python main.py) 시 기본 포트는 8888임; 기존 포트나 헬스체크 설정을 확인해야 함.

v2.2+a2.0 (Oct 2, 2025)​

Highlights​

  • Visual, 시나리오 보강, 피드백 흐름 전반에 걸쳐 타입이 지정된 엔벨로프(envelope)와 Langfuse v3 관측 가능성을 적용한 Vision API v2 엔드투엔드 연결.
  • 기존 Ollama 지원과 더불어 새로운 OpenAI 프로바이더 및 팩토리 통합.
  • RAG 레이어 리팩토링: AsyncEmbeddingEngine 및 AsyncVectorStoreEngine 도입; 기존 AsyncSearchEngine 제거; ensure_space() 및 네임드 벡터(named-vectors) 흐름 추가.
  • Conversation Agent를 클래스 기반 작업으로 전면 리팩토링하여 의도/카테고리 라우팅 및 UX 중심의 제안 기능 개선.
  • 감지 시나리오 보강 파이프라인 통합 및 "enrich_scenario"로 명칭 변경; 사전 등록 흐름 지원을 위해 camera_id 처리 완화.
  • 일관되고 재현 가능한 환경을 위해 VLM (Qwen2.5-VL:32B v2.2.0) 및 RAG Visual Agent (v2.2.0)를 위한 새로운 버전별 설정 추가.

Breaking Changes​

  • Vision API 스키마

  • VisualQueryRequest에 vlm_model_name 필수 포함.

  • 퓨샷 템플릿이 이제 VLMScenarioAnalysis에서 파생됨; 필드 접근 방식 업데이트, feedback_content가 feedback_message로 변경됨.

  • ScenarioEnricher 결과가 래핑됨; VisualAgent는 타입이 지정된 엔벨로프(LanguageModelAgentResponse[T], ChainBuiltResult)를 반환함.

  • Feedback API v2: 요청 명칭 변경 및 확장 — camera_id 추가, feedback이 feedback_binary로 변경, 선택적 feedback_message 추가. main.py의 연결 구조 업데이트.

  • RAG/벡터 저장소

  • AsyncVectorStoreEngine 추가 및 AsyncSearchEngine 은퇴; 임베딩 프로토콜 분리 및 이름 변경.

  • 네임드 벡터 매핑 필수; 카메라별 공간을 위해 ensure_space() 호출 필요.

  • Conversation

  • IntentClassifier가 더 이상 RAG 컨텍스트를 가져오지 않음; 프롬프트 구성기 업데이트.

Features​

  • 관측 가능성 (Observability)

  • Langfuse v3 클라이언트 통합; 요청별 트레이스 ID; ainvoke 후 기록되는 프롬프트 미리보기; 이미지 스크러빙 기능.

  • 프로바이더

  • 테스트가 포함된 OpenAI 프로바이더 구현; 프로바이더 및 모델 이름을 추출하는 유틸리티 추가.

  • Conversation 작업

  • 신규 작업: 알림 간격 설정 및 피드백 유사도 임계값 설정 추가.

  • 작업 응답에서 다음 행동 제안: 예) 모니터링 시작, 임계값 조정 등.

  • Vision 및 보강

  • 시나리오 보강 메시지 및 스키마를 vision/detection_scenario 아래로 통합; 새로운 보강 설정 추가.

  • Visual Agent 메시지 빌더 분리; 퓨샷 템플릿 누락에 대한 가드 로직 추가.

  • Configuration

  • VLM qwen2.5vl:32b v2.1.2 및 v2.2.0 추가; RAG 설정 visual_agent v2.2.0 추가; imagePullSecrets 및 환경 패키지 CLI를 포함한 Helm 개선.

Fixes​

  • Conversation 라우팅 및 UX

  • AI 메시지에 대해서만 카테고리 감지 수행; 퀵 버튼 텍스트 정제; 밝기 전략 제거.

  • 타겟 설정 시 영어 타겟 강제 적용; 프롬프트 및 검증 세부 조정.

  • 알림 간격 기본값/단위 명확화; 최소값 및 변환 로직 테스트 포함.

  • Vision/보강 정확성

  • 감지 시나리오 언어를 쿼리와 일치시킴.

  • 렌더링된 프롬프트를 스팬 메타데이터에 보존하고 트레이스 업데이트 오류 수정.

  • 빌드 및 툴링

  • black 언어 버전 정리; pre-commit/스타일 수정.

v2.1+a1.2 (Sep 10, 2025)​

이 버전은 RAG 시스템 강화, 관측 가능성 및 트레이싱 개선, 개발 및 배포 경험 간소화에 중점을 둔 중요한 진전입니다.

Key Features​

  • 네임드 벡터 RAG 및 검색: RAG 시스템이 네임드 벡터를 지원하도록 업그레이드되었습니다. 이를 통해 이미지, 텍스트, 감지 시나리오 등 다양한 모달리티에 가중치를 둔 정교한 멀티모달 검색이 가능해져 더 정확한 결과를 제공합니다.

  • 피드백 인지 알림 교정: 사용자 피드백을 기반으로 알림을 지능적으로 교정하여 스스로 개선되는 피드백 루프를 구축했습니다.

  • LangFuse용 동적 Agent ID: 카메라 정보를 기반으로 동적 agent_id를 사용하여 트레이싱을 수행합니다. 이를 통해 다중 카메라 환경에서 요청 추적 및 디버깅이 훨씬 쉬워졌습니다.

  • 개발 및 배포 강화:

  • Docker 최적화: 빌드 속도 개선 및 로컬 개발을 위한 docker-compose 설정 개선.

  • 로컬 개발 스크립트: 핫 리로딩이 포함된 로컬 실행용 run_agent.sh 추가.

  • Ollama 모델 웜업: 컨테이너 시작 시 모델을 미리 로드하여 첫 요청 지연 시간 단축.

  • EKS 배포: Amazon EKS 배포를 위한 설정 작업 완료.

  • GENERAL_CONVERSATION 작업 제거: 지원되는 작업 목록에서 일반 대화 작업을 삭제했습니다.

v2.1+a1.1 (Aug 29, 2025)​

Summary​

RAG 임베딩 시스템과 Langfuse 트레이싱 통합 전반에 걸친 내부 시스템 최적화 및 정제를 통해 성능, 유지보수성, 일관성을 향상시켰습니다.

Key Changes​

  • RAG 임베딩 시스템 강화: 이미지 임베딩 효율성 개선을 위해 비동기 임베딩 프로바이더 레지스트리 리팩토링.
  • Langfuse 트레이싱 통합 개선: 이미지 데이터 처리 로직을 외부화하여 모듈성을 높이고 오버헤드 감소.
  • 환경 변수 로딩 표준화: 프로젝트 전반에서 예측 가능한 환경 설정을 위해 로딩 방식 표준화.

v2.1.0 (Aug 26, 2025)​

Added​

  • SET_TARGET 작업 로컬라이제이션: 타겟 설정 응답에 대한 다국어 지원.
  • 타겟 관리 작업: 타겟의 추가, 삭제, 설정을 위한 종합 관리 기능 도입.
  • 중앙 집중식 Langfuse 트레이싱: 디버깅을 위한 중앙 트레이싱 시스템 통합.
  • 대화 이력 활용: 문맥 인지를 위해 대화 이력을 Agent 프롬프트에 포함.
  • 동적 LLM 프로바이더: 다양한 LLM 백엔드 간 쉬운 전환 및 관리 메커니즘 추가.
  • 신규 대화 작업: ANSWER_SYSTEM_QUESTION (시스템 질문 답변), HANDLE_UNSUPPORTED_REQUEST (지원되지 않는 요청 처리) 추가.
  • VLM 프롬프트 설정: v2.1.0 등 다양한 VLM 프롬프트 버전 추가 및 관리.

v2.0.0 (Aug 8, 2025)​

대화형 및 Visual AI Agent인 EVA Agent의 첫 번째 공식 릴리즈입니다.

Added​

  • Conversational Agent: 의도 분류 및 동적 프롬프트 구성 기능이 포함된 대화형 Agent 구현.
  • Visual Agent: 구성 가능한 VLM 백엔드를 활용한 이미지 분석용 Agent 도입.
  • RAG 파이프라인: 지식 베이스의 컨텍스트를 활용하여 사용자 쿼리를 보강하는 파이프라인 구축.
  • 벡터 저장소: FAISS 및 Qdrant 통합 지원.
  • FastAPI 애플리케이션: RESTful API를 통해 기능을 서빙하는 견고한 애플리케이션 개발.
  • Docker 기반 배포: Ollama, Qdrant 등 의존성을 포함한 멀티 서비스 환경 구축.