使用 Litefuse 为 VoltAgent 提供可观测性
本指南介绍如何将 Litefuse 与 VoltAgent 集成以实现可观测性与追踪。按照下面的步骤操作，你就可以在 Litefuse 仪表盘中监控和调试你的 VoltAgent Agent。
什么是 VoltAgent？ VoltAgent 是一个开源的 TypeScript 框架，它就是这样一个必备工具包。VoltAgent 通过提供模块化构建块、标准化模式和抽象层，简化了 AI Agent 应用的开发。无论你是在构建聊天机器人、虚拟助手、自动化工作流，还是复杂的多 Agent 系统，VoltAgent 都帮你处理底层复杂性，让你专注于定义 Agent 的能力与逻辑。
集成
创建 VoltAgent 项目
如果你还没有 VoltAgent 项目，可以使用 VoltAgent CLI 创建一个：
npm create voltagent-app@latest进入项目目录：
cd my-voltagent-app你可以在这里获取完整的 VoltAgent 安装说明。
配置 Litefuse 项目
在 Litefuse 中创建一个项目，并从项目设置页面获取 API Key。
添加环境变量
创建或更新你的 .env.development 文件，添加以下变量：
# 你的 LLM API key
OPENAI_API_KEY=your-api-key
# Langfuse 凭证
LANGFUSE_SECRET_KEY=sk-lf-...
LANGFUSE_PUBLIC_KEY=pk-lf-...
LANGFUSE_BASE_URL=https://litefuse.cloud # 可选，默认为 https://litefuse.cloud安装 @voltagent/langfuse-exporter 包
将 @voltagent/langfuse-exporter 包添加到你的项目：
npm install @voltagent/langfuse-exporter配置 Litefuse Exporter
修改你的应用主文件（例如初始化 VoltAgent 的 index.ts），引入 LangfuseExporter 并在 VoltAgent 的选项中进行配置：
import { VoltAgent, Agent } from "@voltagent/core";
import { VercelAIProvider } from "@voltagent/vercel-ai";
import { openai } from "@ai-sdk/openai";
import { LangfuseExporter } from "@voltagent/langfuse-exporter";
const langfuseExporter = new LangfuseExporter({
publicKey: process.env.LANGFUSE_PUBLIC_KEY,
secretKey: process.env.LANGFUSE_SECRET_KEY,
baseUrl: process.env.LANGFUSE_BASE_URL,
});
const agent = new Agent({
name: "my-voltagent-app",
description: "A helpful assistant that answers questions without using tools",
llm: new VercelAIProvider(),
model: openai("gpt-4o-mini"),
});
new VoltAgent({
agents: {
agent,
},
telemetryExporter: langfuseExporter,
});请确保你的 Agent 定义（new Agent({...})）和 VoltAgent 实例化（new VoltAgent({...})）与你的项目结构一致。关键改动是新增了 LangfuseExporter 和 telemetryExporter 选项。
运行你的 VoltAgent 应用
像往常一样启动 VoltAgent 开发服务器或运行你的应用：
npm run dev执行 dev 命令时，tsx 会编译并运行你的代码。你应该会在终端中看到 VoltAgent 服务器的启动信息：
══════════════════════════════════════════════════
VOLTAGENT SERVER STARTED SUCCESSFULLY
══════════════════════════════════════════════════
✓ HTTP Server: http://localhost:3141
Developer Console: https://console.voltagent.dev
══════════════════════════════════════════════════
[VoltAgent] All packages are up to date你的 Agent 现在已经运行起来了！要与它交互：
- 打开 Console： 点击终端中输出的
https://console.voltagent.dev链接（或复制到浏览器中打开）。 - 找到你的 Agent： 在 VoltAgent Console 页面，你应该能看到你的 Agent（例如 “my-agent”）。
- 打开 Agent 详情： 点击你的 Agent 名称。
- 开始聊天： 在 Agent 详情页面，点击右下角的聊天图标打开聊天窗口。
- 发送消息： 输入诸如 “Hello” 之类的消息并回车。
在 Litefuse 中查看 trace
打开你的 Litefuse 仪表盘，你会看到 Agent 交互产生的 trace。你可以在其中分析 prompt、补全内容以及 AI 交互的其他细节。
下面是一条 trace 的示例：
