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 代理的除錯和監控提供了一種輕量級、本地優先的解決方案,特別適合那些希望在開發過程中快速獲取代理行為反饋的開發者。