I Can SEE EVERYTHING: Claude Code Hooks for Multi Agent Observability
- 다중 에이전트 시스템의 문제점: 여러 AI 에이전트를 확장할 때 추적해야 할 정보가 너무 많아지는 문제가 발생하며, 이를 해결하기 위해 관측 가능성(Observability)이 필수적입니다. 📈
- Claude Code Hooks 기반 솔루션: Claude Code Hooks를 사용하여 에이전트 이벤트를 최소한의 클라이언트-서버 아키텍처로 전송함으로써 모든 에이전트 활동을 실시간으로 모니터링할 수 있습니다. 🔗
- 아키텍처 구성: 에이전트의 훅(Hooks)이 Bun 서버로 이벤트를 보내면, 서버는 데이터를 SQLite와 유사한 DB에 저장하고 동시에 웹소켓을 통해 클라이언트로 실시간 스트리밍합니다. 🏗️
- 포괄적인 이벤트 추적: 서브태스크, 계획, 빌드, 웹 스크래핑, 웹 검색, 딥 리서치, 도구 호출, 알림 등 모든 유형의 에이전트 이벤트를 추적하고 기록합니다. 🕵️♀️
- 실시간 모니터링 및 알림: 여러 장치에서 실행되는 다수의 에이전트 이벤트를 실시간으로 스트리밍하며, 에이전트의 입력 요청 시 알림을 제공하여 즉각적인 개입을 가능하게 합니다. 🔔
- 강력한 필터링 및 시각화: 애플리케이션, 세션 ID, 이벤트 유형별로 필터링할 수 있으며, 실시간 활동 펄스(activity pulse)와 색상 코딩을 통해 에이전트의 작업을 한눈에 파악할 수 있습니다. 📊
- 이벤트 요약 기능: 각 이벤트가 훅을 통해 전송되기 전에 작고 빠른 모델(예: Haiku)을 사용하여 요약 프롬프트를 실행, 중요한 정보를 빠르게 파악할 수 있도록 돕습니다. 📝
- 단방향 데이터 스트림: 에이전트에서 서버, 그리고 클라이언트로 이어지는 단방향 데이터 흐름 아키텍처를 채택하여 시스템의 단순성과 효율성을 높였습니다. ➡️
- 디버깅 및 제어: 에이전트의 전체 채팅 기록을 포함한 상세한 이벤트 페이로드를 제공하여 문제 발생 시 디버깅을 용이하게 하고, 에이전트의 동작을 결정론적으로 제어할 수 있습니다. 🐞
- 확장 가능한 에이전트 엔지니어링: 다수의 에이전트를 효율적으로 관리하고 확장하며, 에이전트 기반 워크플로우를 구축하는 데 필수적인 기반을 제공하여 에이전트 엔지니어링 역량을 강화합니다. 🚀