agentlens (Amitpaz1)

🔍 AgentLens

Open-source observability & audit trail for AI agents

📖 Documentation · Quick Start · Dashboard · ☁️ Cloud

______________________________________________________________________

📑 目录

• 快速开始
• 建筑
• 集成指南
• 主要特点
• 仪表盘
• AgentLens云
• 包裹
• API概述
• 命令行界面
• 发展
• 贡献
• AgentKit 生态 系统
• 许可证

______________________________________________________________________

AgentLens是一个 人工智能代理飞行记录仪.它捕获每个LLM调用、工具调用、批准决定和错误，然后通过可查询的API和实时web仪表板进行呈现。

四种整合方式——选择适合你的堆栈：

🚀 快速开始

Docker（推荐）

git clone https://github.com/agentkitai/agentlens
cd agentlens
cp .env.example .env
docker compose up
# Open http://localhost:3000

对于生产（启用身份验证、Stripe、TLS）：

docker compose -f docker-compose.yml -f docker-compose.prod.yml up

没有Docker

npx @agentlensai/server
# Opens on http://localhost:3400 with SQLite — zero config

创建API密钥

curl -X POST http://localhost:3400/api/keys \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

保存 als_... 响应中的键——它只显示一次。然后前往 集成指南 为你的代理人提供工具。

📖 完整设置指南→

🏗️ 建筑

graph TB
    subgraph Agents["Your AI Agents"]
        PY["Python App
(OpenAI, Anthropic, LangChain)"]
        MCP_C["MCP Client
(Claude Desktop, Cursor)"]
        TS["TypeScript App"]
        OC["OpenClaw Plugin"]
    end

    PY -->|"agentlensai.init()
auto-instrumentation"| SERVER
    MCP_C -->|MCP Protocol| MCP_S["@agentlensai/mcp"]
    MCP_S -->|HTTP| SERVER
    TS -->|"@agentlensai/sdk"| SERVER
    OC -->|HTTP| SERVER

    subgraph Server["@agentlensai/server"]
        direction TB
        INGEST[Ingest Engine]
        QUERY[Query Engine]
        ALERT[Alert Engine]
        LLM_A[LLM Analytics]
        HEALTH[Health Scoring]
        COST[Cost Optimizer]
        REPLAY[Session Replay]
        BENCH[Benchmark Engine]
        GUARD[Guardrails]
    end

    SERVER --> DB[(SQLite / Postgres)]
    SERVER --> DASH["Dashboard
(React SPA)"]

    EXT["AgentGate / FormBridge"] -->|Webhook| SERVER

🔧 集成指南

🤖 OpenClaw插件

如果你在跑步 龙虾，AgentLens插件自动捕获每个Anthropic API调用-提示、完成、令牌使用、成本、延迟和工具调用。

cp -r packages/relay-plugin /usr/lib/node_modules/openclaw/extensions/agentlens-relay
openclaw config patch '{"plugins":{"entries":{"agentlens-relay":{"enabled":true}}}}'
openclaw gateway restart

集 AGENTLENS_URL 如果您的AgentLens实例未打开 localhost:3000。请参阅 插件README 了解详情。

🐍 Python自动检测

一条线——每个LLM呼叫都会自动捕获 9供应商 （OpenAI、Anthropic、LiteLLM、AWS Bedrock、Google Vertex AI、Google Gemini、Mistral AI、Cohere、Ollama）：

pip install agentlensai[all-providers]

import agentlensai

agentlensai.init(
    url="http://localhost:3400",
    api_key="als_your_key",
    agent_id="my-agent",
)
# Every LLM call is now captured automatically

关键保证： ✅ 确定性·✅ 故障保护·✅ 无阻塞·✅ 隐私权(init(redact=True))

📖 Python SDK完整文档→

🔌 MCP集成

对于Claude Desktop、Cursor或任何MCP客户端，请添加到您的配置中：

{
  "mcpServers": {
    "agentlens": {
      "command": "npx",
      "args": ["@agentlensai/mcp"],
      "env": {
        "AGENTLENS_API_URL": "http://localhost:3400",
        "AGENTLENS_API_KEY": "als_your_key_here"
      }
    }
  }
}

AgentLens船舶 12个MCP工具 --5个核心可观察性，3个情报和分析，4个操作。 完整的MCP工具参考→

📖 MCP设置指南→

📦 程序化SDK

python

pip install agentlensai

from agentlensai import AgentLensClient
client = AgentLensClient("http://localhost:3400", api_key="als_your_key")
sessions = client.get_sessions()
analytics = client.get_llm_analytics()

TypeScript：

npm install @agentlensai/sdk

import { AgentLensClient } from '@agentlensai/sdk';
const client = new AgentLensClient({ baseUrl: 'http://localhost:3400', apiKey: 'als_your_key' });
const sessions = await client.getSessions();

📖 SDK参考→

✨ 主要特点

• 🐍 Python自动检测 — agentlensai.init() 自动捕获9个提供商之间的每个LLM呼叫。确定性——不依赖LLM行为。
• 🔌 MCP本地 --作为MCP服务器发货。适用于Claude Desktop、Cursor和任何MCP客户端。
• 🧠 LLM呼叫跟踪 --完整的提示/完成可见性、令牌使用、成本聚合、延迟测量和隐私编校。
• 📊 实时仪表板 --会话时间表、事件浏览器、LLM分析、成本跟踪和警报。
• 🔒 篡改证据审计追踪 --每个会话仅附加SHA-256哈希链的事件存储。
• 💰 成本跟踪 --跟踪令牌使用情况和每个会话、每个代理、每个模型的估计成本。警惕成本飙升。
• 🚨 告警 --错误率、成本阈值、延迟异常和不活动的可配置规则。
• ❤️‍🩹 健康评分 --采用趋势跟踪的5维健康评分。
• 💡 成本优化 --具有复杂性感知的模型推荐引擎，预计可节省成本。
• 📼 会话重放 --通过完整的上下文重建来逐步完成过去的任何会话。
• ⚖️ A/B基准测试 --使用Welch t检验和卡方分析对代理变体进行统计比较。
• 🛡️ 护栏 --自动安全规则，采用干运行模式进行安全测试。
• 🔌 框架插件 --LangChain、CrewAI、AutoGen、语义内核——自动检测、故障安全、非阻塞。
• 🔒 租户隔离 -多对端支持，每个对端数据范围和API密钥绑定。
• 🏠 自托管 --默认情况下为SQLite，没有外部依赖关系。麻省理工学院许可。

📸 仪表盘

AgentLens附带了一个实时web仪表板，用于监控您的代理。

📸 Dashboard Screenshots (click to expand)

概述——概览指标

Dashboard Overview

概述页面显示 实时指标 --会话、事件、错误和活动代理——带有24小时事件时间线图、带有状态徽章的最近会话和最近错误提要。

会话-跟踪每个代理运行

Sessions List

每个代理会话都有可排序的列：代理名称、状态、开始时间、持续时间、事件计数、错误计数和总成本。

会话详细信息——时间线和哈希链

Session Detail

带有防篡改哈希链验证的完整事件时间线。按事件类型筛选，查看成本明细。

事件资源管理器--搜索和筛选所有内容

Events Explorer

所有会话中每个事件的可搜索、可过滤视图。

🧠 LLM分析——提示和成本跟踪

LLM Analytics

通过模型比较，所有代理的LLM调用总数、成本、延迟和令牌使用情况。

🧠 会话时间线——LLM呼叫配对

LLM Timeline

LLM在会话时间线中调用模型、令牌、成本和延迟。

💬 提示细节--聊天气泡查看器

LLM Call Detail

带有元数据面板的聊天气泡式查看器中的完整提示和完成。

❤️‍🩹 健康概述——代理可靠性

Health Overview

每个代理的5维健康评分具有趋势跟踪功能。

💡 成本优化——模型建议

Cost Optimization

分析LLM调用模式，并推荐具有置信水平的更便宜的模型替代方案。

📼 会话回放--逐步调试调试器

Session Replay

通过完整的上下文重建，逐一处理过去的会话事件。

⚖️ 基准——试剂A/B测试

Benchmarks

通过统计显著性检验创建和管理A/B实验。

🛡️ 护栏——自动安全规则

Guardrails

使用触发历史和活动提要创建和管理自动化安全规则。

☁️ AgentLens云

不想自己主持？ AgentLens云 是一个完全托管的SaaS——相同的SDK，零基础设施：

import agentlensai
agentlensai.init(cloud=True, api_key="als_cloud_your_key_here", agent_id="my-agent")

• 相同的SDK，一个参数更改 --开关 url= 到 cloud=True
• 托管Postgres --具有行级安全性的多租户
• 团队特色 --组织、RBAC、审计日志、使用计费
• 没有要运行的服务器 --仪表板位于 app.agentens.ai

📖 云设置指南 · 迁移指南 · 故障排除

📦 包裹

Python（PyPI）

Types/Node.js（npm）

🔌 API概述

API完整参考→

⌨️ CLI

npx @agentlensai/cli health                          # Overview of all agents
npx @agentlensai/cli health --agent my-agent          # Detailed health with dimensions
npx @agentlensai/cli optimize                          # Cost optimization recommendations

两个命令都支持 --format json 用于机器可读输出。看 agentlens health --help 对于所有选项。

🛠️ 发展

git clone https://github.com/agentkitai/agentlens.git
cd agentlens
pnpm install

pnpm typecheck && pnpm test && pnpm lint  # Run all checks
pnpm dev                                   # Start dev server

要求： Node.js≥20.0.0·pnpm≥10.0.0

🤝 贡献

我们欢迎捐款！看 贡献.md 用于设置说明、编码标准和PR过程。

🧰 AgentKit 生态 系统

|项目|描述|| |---------|-------------|-| | Agent Lens |AI代理的可观察性和审计跟踪|⬅️ 你来了| | 传说 |跨代理记忆和课程共享|| | 代理门 |人在环审批网关|| | 模板桥 |代理-人类混合模式形式|| | 代理 |测试与评估框架|| | agentkit网 |代理发现和委派|| | agentkit-cli |统一CLI编排器|| | agentkit护栏 |反应性政策护栏||

📄 许可证