🔍도구
Whisker - Pipecat을 위한 저수준 디버거
멀티모달 AI 프레임워크 Pipecat의 모든 워커와 프레임 흐름을 한눈에 볼 수 있는 디버깅 도구
↗ 원본 링크#디버거#Pipecat#음성AI#멀티에이전트
Whisker란?
Whisker는 음성 및 멀티모달 대화형 AI 프레임워크인 Pipecat을 위한 저수준 디버깅 도구입니다.
Pipecat은 여러 워커가 서로 작업을 주고받으며 메시지를 교환하는 멀티 에이전트 시스템입니다. Whisker를 사용하면 전체 시스템을 하나의 화면에서 모니터링할 수 있습니다.
주요 기능
▸🧑🤝🧑 **워커 브라우징**: 실행 중인 모든 워커와 서브워커 확인
▸🗺️ **파이프라인 검사**: 선택한 워커의 파이프라인 구조 시각화
▸🧰 **작업 흐름 추적**: 워커 간 이동하는 모든 작업 모니터링
▸🚌 **버스 메시지 추적**: Pipecat 버스의 메시지 흐름 확인
▸📌 **프로세서 검사**: 특정 프로세서의 프레임 상세 분석
▸🔍 **프레임 필터링**: 이름과 방향으로 프레임 필터링
▸🧵 **경로 추적**: 파이프라인을 통한 프레임의 이동 경로 추적
▸💾 **세션 저장**: 이전 디버깅 세션 저장 및 로드
설치 방법
필요 사항
▸Python 3.11 이상
▸Pipecat 설치
▸Node.js 20 이상 (UI용)
▸ngrok (호스팅된 UI 연결용)
Python 패키지 설치
bash
uv pip install pipecat-ai-whisker사용 방법
Whisker는 두 부분으로 구성됩니다:
▸
WhiskerServer: UI와 WebSocket 연결을 관리하고 Pipecat 버스를 모니터링
▸
WhiskerObserver: 각 워커에서 프레임 이벤트를 서버로 전달
python
pipeline = Pipeline(...)
worker = PipelineWorker(pipeline, ...)
# Whisker 서버 생성
whisker = WhiskerServer()
# 워커에 옵저버 추가
worker.add_observer(whisker.create_observer(worker))
runner = PipelineRunner(...)디버깅하려는 모든 파이프라인 워커에 옵저버를 추가하면, Whisker UI에서 전체 시스템의 동작을 실시간으로 확인할 수 있습니다.
왜 Whisker인가?
Pipecat과 같은 복잡한 멀티 에이전트 시스템에서는 각 구성 요소가 어떻게 동작하는지 파악하기 어렵습니다. Whisker는 배터리 포함 추적 로깅처럼 모든 것을 시각화하여 디버깅을 훨씬 쉽게 만들어줍니다.