# [[V-component (Evaluation Interface)|V-component (Evaluation Interface)]]

## 📌 Brief Summary
V-component(Evaluation Interface)는 에이전트 하네스의 '눈'에 해당하는 구성 요소로, 에이전트의 출력물이나 도구 실행 결과를 객관적으로 평가하고 피드백을 생성하는 책임을 진다. 작업이 성공적으로 완료되었는지, 결과물이 제약 사항을 준수했는지, 혹은 오류가 발생했는지를 판단하여 실행 루프(E-component)에 다음 행동을 결정할 근거를 제공한다.

## 📖 Core Content
*   **결과 검증 (Output Verification)**: 모델이 생성한 코드, 문서, 데이터 형식이 사전에 정의된 스펙(Schema, Linter, Test Case)에 부합하는지 자동 검사한다.
*   **자기 비판 (Self-Correction Feedback)**: 검증 실패 시 단순히 "에러 발생"이라고 알리는 대신, 무엇이 틀렸고 어떻게 고쳐야 하는지에 대한 구체적인 피드백 프롬프트를 생성하여 에이전트에게 전달한다.
*   **벤치마킹 및 채점 (Scoring)**: 작업의 품질을 정량화된 점수로 환산하여, 여러 번의 시도 중 가장 우수한 결과물을 선택하거나 에이전트의 성능 추이를 모니터링한다.
*   **환각 탐지 (Hallucination Detection)**: 에이전트의 답변이 실제 근거(Evidence Memory)와 일치하는지, 혹은 논리적 모순이 없는지 검토한다.
*   **인간 피드백 통합 (HITL Evaluation)**: 자동화된 평가가 어려운 경우 인간 사용자의 승인이나 점수를 입력받아 평가 프로세스에 반영한다.

## ⚖️ Trade-offs & Caveats
*   **평가자 모델의 한계**: 평가를 위해 또 다른 LLM을 사용할 경우, 평가자 자체가 환각을 일으키거나 편향된 판단을 내릴 리스크가 있다.
*   **검증 오버헤드**: 모든 단계에서 엄격한 검증을 수행하면 전체 작업 시간이 길어지고 비용이 증가한다.
*   **평가 기준의 모호성**: 주관적인 디자인이나 문구 작성 등의 작업에 대해서는 객관적인 평가 지표를 설정하기 어렵다.

## 🔗 Knowledge Connections

### Related Concepts
*   [[Agent Harness|Agent Harness]]
    *   연결 이유: V-component는 하네스의 품질 보증 계층이다.
*   [[Self-verification|Self-verification]]
    *   연결 이유: V-component가 수행하는 핵심 활동 중 하나이다.
*   Agent Evaluation Benchmarks
    *   연결 이유: V-component가 사용하는 표준화된 평가 기준과 도구 모음이다.

### Deeper Research Questions
*   '평가자의 평가자(Meta-evaluator)'를 두어 평가 시스템 자체의 신뢰성을 지속적으로 모니터링하는 아키텍처는 어떻게 설계해야 하는가?
*   실패한 작업의 원인을 분석하여 V-component가 자동으로 '성공 가이드라인'을 생성하고 다음 루프에 반영하게 만드는 방법은 무엇인가?
*   정적 분석(Linter)과 동적 추론(LLM)을 결합하여 최소한의 비용으로 최대의 검증 효과를 내는 '하이브리드 평가 전략'은 무엇인가?

### Practical Application Contexts
*   **Implementation:** 코딩 에이전트에서 작성된 코드를 테스트 코드를 통해 실행해보고, 실패 시 스택 트레이스를 V-component에 입력하여 수정 전략을 세우게 한다.
*   **System Design:** 프로덕션 환경에서 에이전트의 답변을 실시간으로 채점하여, 일정 점수 미만의 답변은 사용자에게 보여주지 않고 즉시 재시도(Retry)하도록 설계한다.

---
*Last updated: 2026-05-01*
