AgentLens 是面向 AI 智能体的开源可观测性与审计追踪平台，定位为 AI 智能体的“飞行记录仪”。它捕获每一次 LLM 调用、工具调用、审批决策和错误，并通过可查询 API 和实时 Web 仪表盘呈现。
核心特色：防篡改设计
与其他可观测性工具不同，AgentLens 的每个事件都通过 SHA-256 哈希链与前一条记录相连，类似 git 提交和区块链的链接方式。审计日志仅可追加且可加密验证——事后修改、删除或重排任何一条记录都会导致验证失败，并精确指出破坏链的事件。该设计专为满足欧盟 AI 法案第 12 条的记录保存义务以及新兴的 IETF Agent Audit Trail 工作而构建。审计人员可通过 GET /api/audit/verify/export 获取已签名、可验证的 JSON 快照。
主要能力
- 防篡改审计追踪：按会话维护 SHA-256 哈希链的仅追加事件存储。
- LLM 调用追踪：完整的提示词/补全可见性、token 用量、成本聚合、延迟测量和隐私脱敏。
- 实时仪表盘：会话时间线、事件浏览器、LLM 分析、成本追踪和告警。
- 成本追踪：按会话、按智能体、按模型追踪 token 用量与预估成本，并对成本激增告警。
- 告警：可配置规则，覆盖错误率、成本阈值、延迟异常和停滞。
- 健康评分：5 维度健康评分与趋势追踪。
- 成本优化：复杂度感知的模型推荐引擎，给出预计节省。
- 会话回放：逐步回放任意历史会话并完整重建上下文。
- A/B 基准测试：使用 Welch t 检验和卡方分析对智能体变体进行统计比较。
- 护栏：自动化安全规则，支持干跑模式以便安全测试。
- 框架插件：LangChain、CrewAI、AutoGen、Semantic Kernel，自动检测、故障安全、非阻塞。
- 租户隔离：多租户支持，按租户数据范围与 API 密钥绑定。
- 自托管：默认使用 SQLite，无外部依赖，MIT 许可。
使用方式
提供五种集成方式，可按技术栈选择：
- 一条命令启动服务器与仪表盘（SQLite，零配置，需 Docker）。
- 不使用 Docker 直接运行。
- 完整栈（Postgres + Redis、认证、TLS），从源码运行。
- OpenTelemetry：若智能体已按 OTel GenAI 语义约定埋点（通过 OpenLLMetry、OpenInference 或官方 OTel 插桩），只需将 OTLP 导出器指向 AgentLens，无需 AgentLens SDK。每个 OTel trace 映射为一个会话（或使用 gen_ai.conversation.id），事件同样被哈希链保护。OTel 仅上报 token 而很少上报成本，AgentLens 会根据模型每百万 token 定价（按模型 id 模糊匹配）重建 costUsd。生产环境可设置 OTLP_AUTH_TOKEN 要求 bearer token。
- Python 自动埋点：一行代码即可自动捕获 9 个提供商（OpenAI、Anthropic、LiteLLM、AWS Bedrock、Google Vertex AI、Google Gemini、Mistral AI、Cohere、Ollama）的每次 LLM 调用，保证确定性、故障安全、非阻塞，并支持 init(redact=True) 隐私脱敏。
此外提供 MCP 集成：面向 Claude Desktop、Cursor 或任何 MCP 客户端，在配置中添加即可。AgentLens 内置 22 个 MCP 工具，覆盖核心可观测性、智能与分析、运维。还提供编程式 SDK（TypeScript / Node.js，npm）。
本地快速试用可使用 AUTH_DISABLED=true（加固镜像仍要求 JWT_SECRET）。任何共享环境应去掉 AUTH_DISABLED、设置真实 JWT_SECRET 并创建 API 密钥（als_... 前缀，仅显示一次）。
仪表盘功能
实时 Web 仪表盘包含：概览（会话、事件、错误、活跃智能体等实时指标，24 小时事件时间线图，最近会话与错误流）、会话列表（可按智能体名、状态、开始时间、时长、事件数、错误数、总成本排序）、会话详情（完整事件时间线与哈希链验证，可按事件类型过滤、查看成本明细）、事件浏览器（跨所有会话的可搜索可过滤视图）、LLM 分析（总调用数、成本、延迟、token 用量与模型对比）、会话时间线中的 LLM 调用配对、提示词详情（聊天气泡式查看器与元数据面板）、健康概览、成本优化建议、会话回放、基准测试、护栏管理。
适用场景
需要为 AI 智能体建立可审计、可验证运行记录的团队，尤其是受欧盟 AI 法案第 12 条记录保存义务约束的场景；需要对 LLM 调用进行成本、延迟、token 监控与优化的开发者；需要多租户隔离与自托管部署的组织。
限制与要求
- 自托管默认使用 SQLite；完整栈需要 Postgres + Redis。
- 源码构建要求 Node.js ≥ 20.0.0、pnpm ≥ 10.0.0。
- 快速演示需要 Docker。
- 云托管（AgentLens Cloud）为托管 SaaS，提供托管 Postgres（多租户行级安全）、组织/RBAC/审计日志等团队功能，仪表盘位于 app.agentlens.ai；具体收费与价格资料暂未提供。
- 与 AgentGate、FormBridge、Lore、AgentEval 等 AgentKit 生态集成。
