| name | agentsight |
| description | 通过命令行或 Dashboard（前端） 查询 AgentSight 平台的 token 消耗数据、token 节省（优化）数据、审计事件和会话中断事件。当用户询问 token 用量、花费、消耗趋势、token 节省、优化效果、LLM 调用、进程行为审计，或询问会话中断、Agent 异常、LLM 错误等中断事件时使用此技能。 |
Dashboard（前端）
AgentSight 提供 Web Dashboard（前端） 用于可视化查看 token 消耗和会话历史。
访问方式：
- 远程访问：
http://<server-ip>:7396（需确保安全组已开放该端口）
- 本地访问：
http://127.0.0.1:7396
功能：
- Token 消耗趋势图（按天/小时）
- 会话历史浏览
- LLM 调用详情查看
- 支持按时间范围、进程过滤
启动服务：
sudo systemctl start agentsight
sudo systemctl status agentsight
Token 查询
常用命令
| 命令 | 说明 |
|---|
/usr/local/bin/agentsight token --period today | 今天消耗 |
/usr/local/bin/agentsight token --period yesterday | 昨天消耗 |
/usr/local/bin/agentsight token --hours 3 | 最近 3 小时 |
/usr/local/bin/agentsight token --period today --compare | 今天 vs 昨天对比 |
返回示例
今天共消耗 125,000 tokens，比昨天（98,000）增长 27%。
输入: 125,000 | 输出: 85,000
审计查询
常用命令
| 命令 | 说明 |
|---|
/usr/local/bin/agentsight audit | 最近 24 小时事件 |
/usr/local/bin/agentsight audit --last 48 | 最近 48 小时 |
/usr/local/bin/agentsight audit --pid 12345 | 指定进程 |
/usr/local/bin/agentsight audit --type llm | 仅 LLM 调用 |
/usr/local/bin/agentsight audit --type process | 仅进程行为 |
/usr/local/bin/agentsight audit --summary | 汇总统计 |
/usr/local/bin/agentsight audit --summary --last 72 | 最近 72 小时汇总 |
/usr/local/bin/agentsight audit --json | JSON 格式 |
返回示例
汇总输出：
=== Audit Summary (last 24 hours) ===
LLM calls: 42
Process actions: 128
Providers:
OpenAI: 35 calls
Anthropic: 7 calls
Top commands:
python agent.py: 25 times
node server.js: 17 times
事件列表（JSON）：
{"event_type":"llm_call","pid":1234,"comm":"python",
"extra":{"provider":"OpenAI","model":"gpt-4o","input_tokens":1500,"output_tokens":800}}
事件类型
| 类型 | 字段 |
|---|
llm_call | provider, model, input_tokens, output_tokens, request_path, response_status, is_sse |
process_action | filename, args, exit_code |
会话中断查询
数据库：/var/log/sysak/.agentsight/interruption_events.db
中断类型：llm_error、sse_truncated、context_overflow、agent_crash、token_limit
严重级别：critical > high > medium > low
使用 /usr/local/bin/agentsight interruption --help 查看所有子命令和参数。
Token 节省查询
GET /api/token-savings — 参数：start_ns、end_ns、agent_name；数据源：genai_events.db + ~/.tokenless/stats.db
GET /api/agent-names — 获取可选的 agent_name 值列表
注意事项
- 数据存储：
/var/log/sysak/.agentsight/agentsight.db（SQLite）
- 默认保留：7 天
- 时间戳：纳秒级 Unix 时间戳
- 权限：需要 root 运行 eBPF
