Agent Analytics

Agent Analytics 综合评估

Agent Analytics 是一款专为 AI Agent 环境设计的端到端增长分析工具，通过官方 CLI 以 npx @agent-analytics/cli@0.5.14 形式直接调用，无需本地安装或持久化 API 密钥，主打"对话即分析"的自动化工作流。

核心用法

• 一键埋点：create 命令生成项目并返回即用型 JS 追踪代码片段，部署后即可自动采集 page_view、session 等基础事件
• 全功能查询：覆盖 stats、insights、events、breakdown、funnel、retention、paths、heatmap、experiments 等固定命令，满足日常 90% 分析需求
• 实验管理：内置 A/B 测试全生命周期支持，从创建实验、定义变体到绑定转化目标均可 CLI 完成
• 中文友好：文档站点提供 /zh/ 路径完整中文指南，OpenClaw 等国内团队可直接使用

显著优点

1. Agent 原生设计：默认 login --detached 模式适配无浏览器回调的运行时（如 Issue-based 工作流），避免密钥泄露风险
2. 零配置门槛：免费 tier 含 10 万事件/月及 2 个项目，个人与小型团队可立即启动
3. CLI 统一入口：强制 npx 调用确保版本一致性，避免本地环境碎片化；Paperclip 等公司任务流有明确执行策略
4. 实时反馈通道：feedback 命令直达产品团队，修复周期可短至数小时

局限性与注意事项

• 高级查询门槛：query 命令的 --filter 需手写 JSON，且仅支持有限的内置字段（event、user_id、date、country、session_id、timestamp）分组，无法直接按任意 properties.* 字段 group_by
• 时间粒度限制：不支持 24h 小时级简写，精确到小时的分析需手动构造 epoch 时间戳过滤
• 跨项目聚合手动化：账户级多项目统计需逐个调用后自行求和，无原生聚合接口
• 归因分析边界：first-touch UTM 等属性可过滤但不可分组，复杂归因需求需反馈或外部处理

适合人群

• AI Agent 开发者与 OpenClaw/Codex 用户，追求闭环"监控-分析-实验-迭代"
• 需批量管理多项目、厌倦仪表盘切换的增长团队
• 追求轻量、无埋点方案的前端/全栈开发者

常规风险

• CLI 版本锁定：必须严格使用 @0.5.14 固定版本，未明确后续版本迁移策略
• 浏览器授权依赖：尽管支持 detached 模式，生产环境仍需人工完成 OAuth 授权链路，完全自动化 CI/CD 集成存在卡点
• 数据隐私：事件数据托管于第三方平台，虽有 MIT 开源 CLI 背书，但核心服务端闭源，企业级合规需自行评估

核心用法

Agent Analytics 是一个面向 Agent 环境的增长分析工具封装，通过 npx @agent-analytics/cli@0.5.14 命令提供端到端分析能力。Skill 本身为纯 Markdown 文档，无实际可执行代码，所有功能均代理至官方 CLI 与 API 服务。

关键工作流程：

• 项目创建：create <project> --domain <url> 返回追踪代码片段
• 数据追踪：自动注入 tracker.js，支持自定义事件 window.aa.track(event, props)
• 查询分析：内置 stats、insights、events、breakdown、paths、funnel、retention 等固定命令
• 实验管理：experiments create/list 支持完整 A/B 测试生命周期
• 认证方式：默认浏览器授权，Issue 类运行时强制使用 --detached 分离式授权

中文支持特性：

• 官方文档提供 /zh/ 路径中文内容
• 支持 API、CLI、MCP 三种接入方式
• 适配 OpenClaw 等封闭循环 Agent 工作流

显著优点

1. Agent-First 设计：无需打开仪表盘，单会话内完成监控→分析→实验→迭代的闭环
2. 零依赖安装：纯 npx 调用，无本地持久化依赖，100k/月免费额度
3. 版本锁定安全：强制固定 @0.5.14 版本，避免供应链攻击
4. 多项目批处理：支持跨项目聚合分析，适合管理矩阵站点
5. 实验原生支持：内置漏斗、留存、路径分析，无需额外工具

潜在缺点与局限性

1. 分组能力受限：group_by 仅支持 event/date/user_id/session_id/country，无法按任意属性（如 properties.utm_source）分组，复杂归因需手动处理
2. 时间粒度限制：API 不支持 24h 小时级速记，精确滚动窗口需自行构造毫秒时间戳
3. 跨会话归因缺失：paths 命令仅追踪单会话内路径，长周期转化归因需外部处理
4. CLI 为唯一官方通道：文档明确禁止绕过 CLI 直接调用 HTTP API，灵活性受限
5. 个人开发者维护：T3 可信度来源，无企业级 SLA 保障

适合人群

• 独立开发者/SaaS 创始人：需要快速部署追踪，无运维负担
• 增长黑客团队：依赖 Agent 自动化日常数据检查与实验迭代
• 中文内容创作者：官方中文文档降低接入门槛
• 多站点运营者：单会话管理跨项目分析

常规风险

| 风险类别 | 等级 | 说明 |

|---------|------|------|

| 供应链攻击 | 低 | npx 下载官方包，版本已固定，但需信任 npm 与 Agent Analytics 服务 |

| 数据隐私 | 中 | 收集用户行为数据，需确保隐私政策合规（GDPR/CCPA） |

| 服务依赖 | 中 | 完全依赖 `agentanalytics.sh` 服务可用性，无本地降级方案 |

| 授权流程 | 低 | `--detached` 模式需用户手动完成浏览器授权，自动化场景可能中断 |

| 误操作风险 | 低 | `--filter` 接受 JSON，文档警告勿直接注入用户原文 |

安全审计结论：CLS-Certify v2.1.0 评分 85/S 级，纯文档无执行代码，无恶意模式，建议放心使用。