🔍 AgentLens
Open-source observability & audit trail for AI agents
📖 Documentation · Quick Start · Dashboard · ☁️ Cloud
📑 目录
- 快速开始
- 建筑
- 集成指南
- 主要特点
- 仪表盘
- AgentLens云
- 包裹
- API概述
- 命令行界面
- 发展
- 贡献
- AgentKit 生态 系统
- 许可证
AgentLens是一个 人工智能代理飞行记录仪.它捕获每个LLM调用、工具调用、批准决定和错误,然后通过可查询的API和实时web仪表板进行呈现。
四种整合方式——选择适合你的堆栈:
整合 · 语言 · 努力 · 捕捉
🤖 OpenClaw插件 · 龙虾 · 复制并启用 · 每个Anthropic调用——提示、令牌、成本、工具——零代码
🐍 Python自动检测 python 1条线 · 每个OpenAI/Anthropic/LangChain调用——确定性
🔌 MCP 服务器 · 任何(MCP) · 配置块 · 来自Claude Desktop/Cursor的工具调用、会话、事件
📦 软件开发工具包 · Python、TypeScript · 代码 · 完全控制——记录事件、查询分析、构建集成
🚀 快速开始
Docker(推荐)```bash
git clone https://github.com/agentkitai/agentlens
cd agentlens
cp .env.example .env
docker compose up
Open http://localhost:3000
对于生产(启用身份验证、Stripe、TLS):```bash
docker compose -f docker-compose.yml -f docker-compose.prod.yml up
没有Docker```bash
npx @agentlensai/server
Opens on http://localhost:3400 with SQLite — zero config
### 创建API密钥```bash
curl -X POST http://localhost:3400/api/keys \
-H "Content-Type: application/json" \
-d '{"name": "my-agent"}'
保存 als_... 响应中的键——它只显示一次。然后前往 集成指南 为你的代理人提供工具。
📖 完整设置指南→
🏗️ 建筑```mermaid
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调用-提示、完成、令牌使用、成本、延迟和工具调用。```bash
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):```bash
pip install agentlensai[all-providers]
``````python
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客户端,请添加到您的配置中:```json
{
"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```bash
pip install agentlensai
``````python
from agentlensai import AgentLensClient
client = AgentLensClient("http://localhost:3400", api_key="als_your_key")
sessions = client.get_sessions()
analytics = client.get_llm_analytics()
**TypeScript:**```bash
npm install @agentlensai/sdk
``````typescript
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、语义内核——自动检测、故障安全、非阻塞。
- 🔗 AgentKit 生态 系统 --与集成 代理门, 模板桥, 传说,以及 代理.
- 🔒 租户隔离 -多对端支持,每个对端数据范围和API密钥绑定。
- 🏠 自托管 --默认情况下为SQLite,没有外部依赖关系。麻省理工学院许可。
📸 仪表盘
AgentLens附带了一个实时web仪表板,用于监控您的代理。
📸 Dashboard Screenshots (click to expand)
概述——概览指标
概述页面显示 实时指标 --会话、事件、错误和活动代理——带有24小时事件时间线图、带有状态徽章的最近会话和最近错误提要。
会话-跟踪每个代理运行
每个代理会话都有可排序的列:代理名称、状态、开始时间、持续时间、事件计数、错误计数和总成本。
会话详细信息——时间线和哈希链
带有防篡改哈希链验证的完整事件时间线。按事件类型筛选,查看成本明细。
事件资源管理器--搜索和筛选所有内容
所有会话中每个事件的可搜索、可过滤视图。
🧠 LLM分析——提示和成本跟踪
通过模型比较,所有代理的LLM调用总数、成本、延迟和令牌使用情况。
🧠 会话时间线——LLM呼叫配对
LLM在会话时间线中调用模型、令牌、成本和延迟。
💬 提示细节--聊天气泡查看器
带有元数据面板的聊天气泡式查看器中的完整提示和完成。
❤️🩹 健康概述——代理可靠性
每个代理的5维健康评分具有趋势跟踪功能。
💡 成本优化——模型建议
分析LLM调用模式,并推荐具有置信水平的更便宜的模型替代方案。
📼 会话回放--逐步调试调试器
通过完整的上下文重建,逐一处理过去的会话事件。
⚖️ 基准——试剂A/B测试
通过统计显著性检验创建和管理A/B实验。
🛡️ 护栏——自动安全规则
使用触发历史和活动提要创建和管理自动化安全规则。
☁️ AgentLens云
不想自己主持? AgentLens云 是一个完全托管的SaaS——相同的SDK,零基础设施:```python
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)
|包|描述|PyPI|
|---|---|---|
| `agentlensai` |9个LLM提供者的Python SDK+自动检测| |
### Types/Node.js(npm)
|包|描述|npm|
|---|---|---|
| `@agentlensai/server` |Hono API服务器+仪表板服务| |
| `@agentlensai/mcp` |用于代理检测的MCP服务器| |
| `@agentlensai/sdk` |程序化TypeScript客户端| |
| `@agentlensai/core` |共享类型、模式、哈希链实用程序| |
| `@agentlensai/cli` |命令行界面| |
| `@agentlensai/dashboard` |React web仪表板(与服务器捆绑)|私有|
## 🔌 API概述
|端点|描述|
|---|---|
| `POST /api/events` |摄入事件(批次)|
| `GET /api/events` |使用筛选器查询事件|
| `GET /api/sessions` |列出会话|
| `GET /api/sessions/:id/timeline` |带有哈希链验证的会话时间线|
| `GET /api/analytics` |随着时间的推移,数据呈现出明显的变化|
API完整参考→
## ⌨️ CLI```bash
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 对于所有选项。
🛠️ 发展```bash
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护栏 | 反应性政策护栏 |
📄 许可证
麻省理工学院 © 阿米特·帕兹