核心用法
q-erp 是面向企业管理者设计的ERP经营查询技能，一期覆盖12个核心分析场景，通过自然语言对话即可调取千易ERP真实经营数据。
三大查询模式：
- 自由经营问答（
erp.analytics.ask）：最灵活的分析入口，支持"今天生意怎么样""为什么利润下滑""近7天哪个商品卖得最好"等开放式问题，系统自动识别意图类型（经营概览/排行/趋势/利润诊断/风险扫描）并生成诊断建议 - 固定快报/榜单：老板快报、今日经营动态、商品销售情况、增长潜力、平台/站点/店铺/店铺组/负责人销售战绩等9个标准化场景
- 多日趋势分析：支持逐日销售走势查询，自动对比环比周期
典型工作流：
1. 晨会通过"老板快报"获取一句话结论+核心指标+归因线索+排查动作
2. 异常时段用"为什么掉了"触发诊断，定位拖累平台/店铺/商品
3. 追问"店铺呢/商品呢/走势呢"实现多维度下钻，无需重复输入完整条件
显著优点
- 数据权威性：直连企业真实ERP数据库，非模拟数据，所有查询必须经
q-claw工具调用，禁止编造 - 智能意图识别：自动归一用户口语化表达（如"Shopee为什么掉了"→诊断意图，"这几天怎么样"→趋势意图）
- 诊断闭环：不仅呈现数据，更提供"谁在拉动/谁拖后腿/给点建议"的归因分析与行动建议
- 多轮连贯：支持上下文承接口语化追问，系统自动补全时间、维度、过滤条件
- 安全合规：严格的数据有效性校验，核心标识缺失时降级处理而非展示空值
潜在局限
- 只读查询：一期不支持任何写入操作（创建单据、审批、回写等）
- 时间参数限制：固定scene暂未开放结构化时间参数契约，历史时间查询需走自由问答场景
- 数据覆盖依赖：利润、成本、退款等深度分析依赖后端数据接入进度，存在数据缺口场景
- 授权门槛：首次使用或授权过期时需完成OAuth授权流程
适合人群
- 企业主/CEO：通过老板快报快速掌握每日经营全貌，识别异常风险
- 运营负责人：平台/店铺/商品多级下钻分析，定位增长机会与拖累因素
- 品类/商品经理：热销排行、增长潜力分析，辅助选品与库存决策
常规风险
| 风险类型 | 说明 |
|---------|------|
| 授权状态 | `AUTH_REQUIRED`或`AUTH_EXPIRED`时需重新授权，未授权无法获取任何数据 |
| 数据时效 | 经营动态基于ERP同步进度，存在分钟级延迟 |
| 利润估算 | 毛利/净利为后端估算口径，非精确财务利润，重大决策需核对财务系统 |
| 场景可用性 | 部分分析场景可能因企业数据配置未开通，需切换其他已接入能力 |
使用建议：优先通过"老板快报"建立每日数据习惯，异常时再用自然语言追问下钻，避免一上来就询问过于复杂的多维度交叉分析。