Show HN: Lookspan – AI代理的本地優先可觀測性工具(npx lookspan)
Lookspan 是一個本地優先的 AI 代理可觀測性儀表板,支持 MCP、LangGraph、CrewAI 和 OpenTelemetry。所有數據存儲在本地 SQLite 中,無需雲服務。提供實時追蹤、成本跟蹤、警報、回放評估和數據集實驗等功能。通過一行命令即可啓動。
Lookspan 是一個專為 AI 代理打造的本地優先可觀測性工具。它允許開發者通過一個輕量級的儀表板監控 AI 代理的每次調用,所有數據都存儲在本地 SQLite 數據庫中,無需依賴任何雲服務。這對於那些注重數據隱私和希望在完全離線環境中工作的團隊來説尤其有價值。
該項目的核心是一個簡單但強大的架構:AI 代理通過 HTTP 或 MCP 協議將追蹤數據發送到本地服務器,服務器將這些數據存儲在 SQLite 中,並通過實時 Streaming 端點推送到儀表板。Lookspan 支持多種框架,包括 MCP、LangGraph、CrewAI 和 OpenTelemetry,使其能夠輕鬆集成到現有的 AI 工作流中。
Lookspan 的主要功能包括:
- 實時追蹤:通過 SSE 端點實時查看所有代理的活動。
- 成本跟蹤:自動計算每次 LLM 調用的成本,支持自定義定價。
- 警報系統:當代理失敗或超過成本/令牌/持續時間閾值時發出通知。
- 回放與評估:可以重新運行任何追蹤的提示,並比較不同模型的輸出和成本。
- 數據集與實驗:構建測試集,批量運行模型並自動評估結果。
安裝和啓動非常簡單,只需一行命令:
npx lookspan然後打開 http://127.0.0.1:3100 即可看到儀表板。通過 cURL 或其他 HTTP 客户端發送追蹤數據即可實時查看。
對於開發者,Lookspan 提供了多種 SDK 支持。在 TypeScript 中,可以使用 @lookspan/openai 或 @lookspan/anthropic 等適配器,一行代碼即可開始追蹤。對於 Python 用户,提供了 lookspan、lookspan-langgraph 和 lookspan-crewai 包。Lookspan 還支持原生 OpenTelemetry 協議,因此任何現有的 OpenTelemetry 採集器都可以直接發送數據。
安全性方面,Lookspan 默認綁定到 127.0.0.1,並支持可選的令牌認證。服務器端會自動對憑據字段(如 authorization、api_key、token 等)進行編輯,確保敏感信息不會被持久化到數據庫中。
與其他可觀測性平台相比,Lookspan 專注於零設置體驗和本地數據優先。它不需要 Docker、PostgreSQL 或 ClickHouse,所有數據都存儲在 SQLite 中,非常適合個人開發者或小型團隊。對於需要完整平台功能的用户,Langfuse 或 Phoenix 可能是更好的選擇。但 Lookspan 在 TypeScript/MCP 生態系統中的無縫集成是它獨特的優勢。
總之,Lookspan 為 AI 代理的調試和監控提供了一種輕量級、本地優先的解決方案,特別適合那些希望在開發過程中快速獲取代理行為反饋的開發者。