如何使用Laminar开源平台监控AI智能体？2026年完整功能解析

Product Overview

Laminar 是一款专为 AI 智能体构建的开源可观测性平台。它为基于大语言模型的应用提供了从开发到生产的全面追踪、评估和监控能力。

---

Core Features

该平台为 AI 智能体工作流提供了完整的可观测性技术栈，涵盖追踪、评估、监控和数据管理。

---

Quick Start

Self-Hosting with Docker Compose

Laminar 的本地自托管非常简便。克隆仓库后，使用 Docker Compose 启动服务：

git clone https://github.com/lmnr-ai/lmnr
cd lmnr
docker compose up -d

这将启动一个轻量级但功能完整的服务栈。在浏览器中访问 http://localhost:5667 即可使用 UI。生产环境建议使用托管平台或运行 docker compose -f docker-compose-full.yml up -d。

Enabling AI Monitoring (Signals)

要在自托管模式下启用 AI 监控（Signals）功能，请在 .env 文件中设置 GOOGLE_GENERATIVE_AI_API_KEY 环境变量（后端和前端均需要此配置）：

# In .env at the repo root
GOOGLE_GENERATIVE_AI_API_KEY=your_key_here

---

SDK Integration Quickstart

TypeScript SDK

安装 SDK 及所有检测工具包：

npm add @lmnr-ai/lmnr

初始化 LLM 调用追踪：

import { Laminar } from '@lmnr-ai/lmnr';
Laminar.initialize({ projectApiKey: process.env.LMNR_PROJECT_API_KEY });

使用 observe 包装函数以追踪输入和输出：

import { OpenAI } from 'openai';
import { observe } from '@lmnr-ai/lmnr';

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const poemWriter = observe({name: 'poemWriter'}, async (topic) => {
  const response = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: `write a poem about ${topic}` }],
  });
  return response.choices[0].message.content;
});

Python SDK

安装 SDK 及所有检测工具：

pip install --upgrade 'lmnr[all]'

初始化并使用 @observe() 装饰器追踪函数：

import os
from openai import OpenAI
from lmnr import observe, Laminar

Laminar.initialize(project_api_key="<LMNR_PROJECT_API_KEY>")
client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

@observe()
def poem_writer(topic):
    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[{"role": "user", "content": f"write a poem about {topic}"}],
    )
    return response.choices[0].message.content

---

Technical Architecture

Laminar 基于高性能架构设计，利用现代技术应对大规模实时可观测性需求：

---

Summary

Laminar 提供了一套全面且开源的可观测性解决方案，专为 AI 智能体工作流设计。凭借原生 OpenTelemetry 支持、强大的追踪能力、内置评估工具以及高性能的 Rust 核心引擎，它能够满足现代基于大语言模型应用的独特监控需求。无论是通过 Docker 自托管，还是使用托管平台，Laminar 都提供了从开发到生产全流程理解、调试和优化 AI 智能体行为的完整工具集。

---

完整文档请访问 docs.laminar.sh。欢迎通过 Discord 参与社区讨论和获取支持。

常见问题（FAQ）

Laminar是什么？适用于哪些场景？

Laminar是开源LLM可观测性平台，专为AI智能体设计，提供全链路追踪、评估与监控，支持从开发到生产环境。

如何快速开始使用Laminar？

克隆GitHub仓库后运行docker compose up -d，访问http://localhost:5667。或通过npm/pip安装SDK，用@observe()装饰器一行代码自动追踪LLM调用。

Laminar支持哪些AI框架和语言？