Intelligence
FluxMeter Intelligence（启发式）
可选的规则/启发式 API，建立在计量数据之上。计量、归因、预算控制与导出仍是主产品。
审阅日期:
方法
端点名称对照引擎 Intelligence 文档与站点 claims.yml。输出质量取决于输入完整性与配置；须由运营方验证。
1. Intelligence 是什么
一组读取 FluxMeter 用量/成本汇总的 HTTP API，用规则与启发式生成根因分解、单位经济视图、情景模拟与报表形导出。
2. 它不是什么
- 不是已训练的 ML 顾问平台
- 不是自主优化或保证正确的业务诊断
- 不是「告诉你下一步做什么」的处方式 AI 叙事
- 不是客户采用或 ROI 证据
3. 输入与对计量的依赖
成本侧来自原生摄入汇总。单位经济等端点需要收入：OpenMeter 叠加或 POST /intelligence/revenue。无收入时可能返回 unknown_revenue。
4. 当前端点
左右滑动查看全部列
| 端点 | 状态 | 依赖 | 说明 |
|---|---|---|---|
| GET /intelligence/root-cause | 已实现 | 依赖计量数据 | 支出变化分解（规则） |
| GET /intelligence/unit-economics | 已实现 | 可选收入叠加 | 需收入叠加 |
| POST /intelligence/simulate | 已实现 | 依赖计量数据 | what-if 情景 |
| GET /intelligence/profitability | 已实现 | 可选收入叠加 | 启发式利润视图 |
| GET /intelligence/forecast | 已实现 | 依赖计量数据 | 线性预测 |
| GET /intelligence/report | 已实现 | 依赖计量数据 | 导出型摘要 |
| GET /intelligence/summary | 已实现 | 可选收入叠加 | 规则摘要 |
| GET /intelligence/pricing-recommendations | 启发式 | 依赖计量数据 | 规则建议 — 须人工核实 |
| POST /intelligence/revenue/{id} | 已实现 | 可选收入叠加 | 手动收入写入 |
| POST /intelligence/import/openmeter | 可选依赖 | 可选收入叠加 | OpenMeter 收入叠加 |
| POST /intelligence/alerts/webhook | 已实现 | 依赖计量数据 | 告警 webhook |
| Langfuse / Helicone overlay | 计划中 | 计划中 | 积压 / 计划中 |
5. 示例输出（说明性）
形状示意 — 非实测客户证据。
{"delta_pct":40.0,"summary":"…","contributors":[…]} // heuristic 6. 启发式局限
分解与建议依赖规则与可用维度；成本分摊可能使用启发式。不保证财务正确性或优化收益。
7. 可选外部收入叠加
收入可来自 OpenMeter 导入或手动 POST。这不是与 OpenMeter 的伙伴背书，也不是替代开票系统。
8. 运营方验证责任
任何建议、预警或报表在用于定价或客户决策前，必须由运营方与财务流程验证。
9. 计划 vs 已实现
上表已区分已实现、启发式、可选依赖与计划中项。不要把计划中的叠加当成已交付能力。