Observal은 에이전트 배포, 관찰 가능성 및 인사이트를 위한 통합 플랫폼입니다. CLI와 IDE 통합을 통해 에이전트를 설치하고 모든 세션을 추적하며, 레지스트리를 통해 에이전트를 탐색하고 관리할 수 있습니다.
Overview
Observal은 AI 에이전트를 개발, 배포 및 모니터링하기 위한 종합 플랫폼입니다. 에이전트를 하나의 패키지로 묶어 다양한 IDE에서 실행할 수 있게 하며, 모든 상호작용을 자동으로 캡처하여 분석합니다. 오픈 소스 커뮤니티 에디션과 엔터프라이즈 에디션을 제공합니다.
Background
기존에는 각 IDE마다 에이전트 설정이 달라 복잡성이 높았고, 에이전트 사용에 대한 관찰 가능성이 부족했습니다. Observal은 이러한 문제를 해결하기 위해 개발되었습니다.
How It Works
아키텍처
Observal은 10개의 Docker 컨테이너로 구성된 풀 스택 애플리케이션입니다. 주요 구성 요소는 다음과 같습니다:
- 프론트엔드: Next.js 16, React 19, Tailwind CSS 4, shadcn/ui
- 백엔드: Python 3.11+, FastAPI, Strawberry GraphQL
- 데이터베이스: PostgreSQL 16 (레지스트리), ClickHouse (원격 측정)
- 큐: Redis + arq
- CLI: Python, Typer, Rich
CLI 설치 및 IDE 연결
pipx install observal-cli
observal auth login
observal doctor --patch
이 명령어는 IDE를 등록하고 원격 측정 훅을 설치하여 세션을 자동으로 캡처합니다.
에이전트 개념
에이전트는 5가지 구성 요소를 하나의 YAML 패키지로 번들링합니다:
- MCP 서버: 도구와 리소스 제공
- 스킬: 특정 작업 수행 능력
- 훅: 이벤트 기반 동작
- 프롬프트: 사전 정의된 프롬프트 템플릿
- 샌드박스: 격리된 실행 환경
세션 추적
연결되면 Observal은 모든 사용자 프롬프트, 생각 블록, 보조 응답, 도구 호출(전체 입력 및 출력)을 캡처합니다. 데이터는 ClickHouse에 저장되어 쿼리 및 분석이 가능합니다.
레지스트리
레지스트리는 에이전트를 위한 패키지 관리자 역할을 합니다. 사용자는 에이전트를 탐색하고, IDE 호환성을 확인하며, 한 번의 명령어로 설치할 수 있습니다. 관리자는 제출물을 검토하고 승인/거절할 수 있습니다.
Key Ideas
- 에이전트 기반 패키징 — 5가지 구성 요소를 하나의 패키지로 묶어 IDE 간 호환성 제공
- 전체 세션 추적 — 샘플링 없이 모든 상호작용을 원시 형태로 캡처
- AI 기반 인사이트 — LiteLLM을 통해 다양한 LLM 제공자를 지원하는 인사이트 보고서
- 거버넌스 및 리뷰 — 관리자 리뷰 큐, 버전 차이 비교, 리더보드
Examples / Use Cases
- 보안 감사 에이전트:
observal pull security-auditor —ide pi - 세션 분석: 각 턴마다 사용자 입력, 도구 호출, 응답을 확인하고 문제 진단
- 조직 거버넌스: 엔터프라이즈 에디션에서 SAML SSO, SCIM 프로비저닝, 감사 로그 사용
Limitations / Considerations
- 엔터프라이즈 기능은 별도 라이선스 필요 (JWT 키로 활성화)
- 오픈 소스 에디션은 완전히 기능하지만 엔터프라이즈 기능(SSO, 감사 로그 등)은 제외