这个项目能做什么

Laminar 是专为 AI 智能体构建的开源可观测性平台。它由 Laminar AI(Y Combinator S24)开发,既可通过托管云服务使用,也可自托管。 README 中描述的核心能力: - 追踪:一个 OpenTelemetry 原生的追踪 SDK,只需一行代码即可自动插桩 Vercel AI SDK、Browser Use、Stagehand、LangChain、OpenAI、Anthropic 和 Gemini 等框架与提供商。提供 TypeScript(npm @lmnr-ai/lmnr)和 Python(PyPI lmnr)客户端库。 - 信号:用户用自然语言描述智能体行为(例如智能体陷入循环),Laminar 会评估智能体运行,并在该行为发生时发送 Slack 通知。 - 评估:一个可扩展的 SDK 和 CLI,用于在本地或 CI/CD 流水线中运行评估,并提供用于可视化和比较结果的 UI。 - MCP 和 CLI 访问:编码智能体可以使用 SQL 查询追踪、span、指标和事件,并基于追踪数据调查或调试问题。 - 仪表盘:一个用于追踪、指标和事件的仪表盘构建器,支持自定义 SQL 查询。 - 数据标注和数据集:一个自定义数据渲染 UI,用于标注和创建评估中使用的数据集。 性能与架构说明:该平台使用 Rust 编写,声称对摄取和存储的追踪数据实现 20 倍压缩,包含一个用于实时查看追踪的自定义实时引擎、对 span 数据的全文搜索,以及用于追踪数据的 gRPC 导出器。 自托管:最快的本地设置方式是克隆仓库并运行 `docker compose up -d`,它会启动一个轻量但功能完整的栈,可通过 http://localhost:5667 访问。还提供了一个面向生产环境的 compose 文件(docker-compose-full.yml)。README 记录了升级现有安装的方法,包括重新创建 ClickHouse 容器并截断已禁用的系统日志表以回收磁盘空间。 配置:可选的 LLM 提供商设置支持 Gemini、OpenAI(或 OpenAI 兼容网关,如 LiteLLM、OpenRouter、vLLM)、AWS Bedrock 和 Azure AI Foundry,并支持可选的模型大小覆盖和静态标头。可通过 POSTGRES_SCHEMA 配置自定义 Postgres schema,用于共享数据库部署。自托管部署会收集匿名使用遥测数据,可通过 LAMINAR_TELEMETRY_DISABLED=true 禁用。 快速入门示例同时提供了 TypeScript(Laminar.initialize 加 observe 包装器)和 Python(Laminar.initialize 加 @observe 装饰器)版本,用于追踪 LLM 调用以及函数输入/输出。