
Apgar는 새 버전의 AI 에이전트가 이전 버전보다 나빠졌는지 추적 데이터로 살펴보는 도구다. LLM 평가자나 데이터셋 없이 오류, 재시도와 반복, 도구 호출 수, 답변 길이, 비용, 지연 시간의 변화를 확인한다.
Apgar에 따르면 기존에 수집하는 추적 데이터를 OpenTelemetry 또는 Langfuse로 보내고 배포마다 릴리스 속성을 지정하면 된다. Apgar는 전체 트래픽을 대상으로 각 릴리스의 첫 몇 시간을 살펴본 뒤, 어떤 지표가 변했으며 변화가 어디에 집중됐는지 Slack 메시지나 웹훅으로 알린다. 프롬프트나 완성된 답변 텍스트는 저장하지 않는다고 설명한다.
빠른 시작과 작동 방식을 확인할 수 있다. 자체 호스팅은 Docker Compose 또는 Helm 차트를 사용하는 Kubernetes를 지원한다. Docker Compose를 쓰려면 Docker와 Compose v2가 필요하다.
mkdir apgar && cd apgar
curl -fsSLO https://github.com/oimo-ai/apgar/releases/latest/download/docker-compose.yml
cat > .env <<EOF
APGAR_SECRET_KEY=$(openssl rand -hex 32)
APGAR_ADMIN_TOKEN=$(openssl rand -hex 16)
CLICKHOUSE_PASSWORD=$(openssl rand -hex 16)
APGAR_PUBLIC_URL=http://localhost:8080
EOF
docker compose up -d --wait
설치한 뒤 http://localhost:8080에 접속해 .env의 APGAR_ADMIN_TOKEN 값으로 로그인한다. 에이전트가 아직 없으면 Agents 페이지에서 데모 데이터를 살펴볼 수 있다. 설치 안내와 자체 호스팅 문서에서 자세한 방법을 확인할 수 있다.
저장소에는 코딩 에이전트를 이용한 연동 안내도 있다. 업그레이드 전에는 릴리스 노트를 읽고 ClickHouse를 백업해야 한다고 안내한다. 라이선스는 Apache-2.0이다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요