---
title: vision-analyze-trap
created: 2026-06-27
updated: 2026-06-27
type: concept
tags: [vision-analyze, pitfall, hermes-agent, troubleshooting]
sources: [raw/articles/seomu-202606-history.md]
confidence: high
---

# vision_analyze 호출 트랩

## 핵심 규칙 (소장님 2026-06-23 확정)

> **"스크린샷 보내면 무조건 비전에게 확인받아"**

→ `/screenshot` 호출 후 **즉시** 비전 확인. 생략 금지.

## 함정 (3가지 사고 사례)

### 1. "도구 목록에 없다" → fallback 답변 오답 (2026-06-23)

**사고**:
- 시스템 도구 목록에 `vision_analyze` 없어 보임
- "도구 없음" 단정 → **fallback 답변** (텍스트 추측)
- **실제**: Hermes venv의 `model_tools.handle_function_call()`로 직접 호출 가능

**교훈**: **시도 → 차단 확인 → fallback** 순서 엄수. 단정으로 fallback 답변 금지.

### 2. vision_analyze 404 에러 (2026-06-18~19 빈번)

**증상**:
```
No endpoints found for google/gemini-2.0-flash-lite-001
```

**처리**: 404여도 재시도 금지. 폴더 생성 + cp만으로 진행.

### 3. vision_analyze 결과 신뢰 안 됨

- "AI 생성 이미지" / "왜곡된 이미지" 같은 hallucination 빈번
- 4MB garbage 토큰 낭비 (碌碌者 패턴 반복 등)
- 인원수 카운팅 부정확

## 해결 패턴: handle_function_call 직접 호출

```python
# venv Python으로 직접 호출
~/.hermes/hermes-agent/venv/bin/python3 << 'PYEOF'
import sys
sys.path.insert(0, '/home/jaekyung/.hermes/hermes-agent')
from model_tools import handle_function_call

result = handle_function_call("vision_analyze", {
    "image_url": "/home/jaekyung/screen.png",   # 절대경로
    "question": "이 화면에 무엇이 보이는지 자세히 설명해줘."
})
print(result[:500])
PYEOF
```

**파라미터 정정** (검증됨):
- ❌ `image_path` (틀림)
- ✅ `image_url` (절대경로 또는 file:// URL)
- 필수: `question` (한글 OK)

**응답 형태**:
```json
{"_multimodal": true, "content": [
  {"type": "text", "text": "Image loaded into your context..."},
  {"type": "image_url", ...}
]}
```

→ 다음 LLM 턴에서 비전 모델이 직접 봄.

## 적용 대상

| 스킬 | 동일 규칙 |
|---|---|
| 검측 (`ins`) | vision_analyze 호출 금지 (트리거 도착 시 즉시 워크플로우만) |
| 자재검수 (`mins`) | 동일 |
| TBM (`tbm`) | 동일 |
| CADian | `/screenshot` 후 무조건 비전 확인 |

## 검증된 시나리오 (CADian 자동화)

1. `Start-Process Icad.exe` → CADian 부팅
2. `/cadian/info` → HWND/PID 확인
3. SendKeys (Alt+O) → 새파일
4. `/screenshot` → PNG 캡처
5. **vision_analyze** → "도면이 정상 표시되는가?"
6. 이상 감지 시 → 좌표 보정 (SetWindowPos 1번 모니터)
7. 다음 단계 진행

## 인원수 카운팅 시 주의

- 사진 여러 장에 인원수 다를 수 있음 (2/4/6/8)
- **자동 결정 금지** (가장 많은 값 사용 금지)
- **소장님이 명시한 인원수 우선** (예: `tbm 0615 a 9 3` → 9명 적용)

## 관련 페이지

- [[hermes-agent]]
- [[dual-monitor]]
- [[session-0-vs-1]]