用途:为网站或应用添加分析追踪,并让 AI 智能体跨多个项目查询流量、转化与参与度,运行 A/B 实验并优化。
主要能力:自动跟踪 page_view 事件(路径、来源、浏览器、操作系统、设备、屏幕尺寸、UTM 参数);自定义事件(如 cta_click、signup、login、feature_used、checkout、error);CLI 提供 stats、insights、breakdown、pages、sessions-dist、heatmap、events、sessions、properties、funnel、retention 等分析命令;实验生命周期由 API 驱动,支持声明式 data-aa-experiment / data-aa-variant-{key} 属性或 programmatic window.aa?.experiment(),结果返回贝叶斯 probability_best、lift 与建议。
使用方式:先获取 API key(在 agentanalytics.sh 注册生成,或自托管开源版);执行 npx @agent-analytics/cli login --token aak_YOUR_API_KEY;再 npx @agent-analytics/cli create my-site --domain https://mysite.com 获得项目 write token,将其作为 data-token 放入追踪脚本并置于 </body> 前。用 npx @agent-analytics/cli events my-site 验证事件。实验中创建命令示例:npx @agent-analytics/cli experiments create my-site --name signup_cta --variants control,new_cta --goal signup。
适用场景:想快速了解项目是否活跃增长、查看热门页面与流量来源、分析漏斗与留存、在低峰时段部署、比较不同 CTA 转化效果。
限制:无 GUI 仪表盘(智能体即仪表盘,可用 live TUI);无用户管理与计费;不存储 PII,不记录 IP;每个变体约需 100 次曝光后实验结果才显著;官方文档、自托管等更多细节暂未提供。