Files
ai-platform/src/modules/jieya-ibp/lib/intent.ts
T
2026-10-18 15:27:02 +08:00

187 lines
7.6 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import type { MetricNode } from '../data/sqlite';
/**
* 离线意图理解:把用户的一句话拆成「意图 + 指标实体 + 假设参数」。
* 纯关键词规则(仅中文),无网络依赖,与 answers.ts 组成单轮问答的本地智能引擎。
*/
export type Intent =
| 'overview' // 经营概况
| 'query' // 指标查询
| 'compare' // 对比分析(产品线 / 区域)
| 'attribute' // 归因分析
| 'forecast' // 趋势预测
| 'whatif' // 假设模拟
| 'anomaly' // 异常检测
| 'escalate' // 升级处置
| 'advice' // 行动建议
| 'risk' // 风险矩阵
| 'fallback'; // 兜底引导
export interface ParsedAsk {
intent: Intent;
/** 抽取到的指标 code(查询/归因/预测/模拟的对象) */
metricCode?: string;
/** 假设模拟:目标值(绝对值)与增量(相对当期)二选一 */
absValue?: number;
deltaValue?: number;
/** 对比分析的范围 */
compareScope?: 'product' | 'region';
/** 原始问句(保留大小写用于展示) */
raw: string;
}
/* ── 意图关键词:命中优先级即数组顺序 ─────────────────────────────────── */
const INTENT_KEYS: [Intent, string[]][] = [
['whatif', ['如果', '假如', '假设', '要是', '提升到', '提高到', '降到', '变成', '变为',
'what if', 'whatif', 'simulate']],
['forecast', ['预测', '预计', '下月', '下个月', '下季度', '未来', '走势会', '会怎样', '会达到', '能支撑', '支撑', '能跑多远', '够不够',
'forecast']],
['escalate', ['升级', 'escalat', '上报']],
['anomaly', ['红色', '告警', '预警', '异常', '超标', '不达标', '哪些指标', '偏离']],
['attribute', ['为什么', '为何', '原因', '主因', '归因', '怎么回事', 'why']],
['advice', ['怎么处理', '怎么办', '建议', '措施', '方案', '对策', '怎么改', '怎么提升', '怎么压降',
'suggest', 'advice']],
['compare', ['对比', '比较', '哪个更', '哪个最', '排名', '产品线', '区域', '地域', '各家', '排行']],
['risk', ['风险', 'risk']],
['overview', ['概况', '总览', '整体', '大盘', '全局', '经营状况', '经营情况', '健康度',
'overview', 'summary']],
];
/* ── 指标别名:口语 / 简称 → code(与节点中文名互补,最长优先) ── */
const ALIASES: Record<string, string> = {
// 经营结果
'营收': 'R01', '收入': 'R01', '营业额': 'R01',
'增长': 'R02', '增速': 'R02', '同比': 'R02',
'净利润': 'R03', '利润': 'R03',
'现金流': 'R13', 'cf': 'R13',
'在手订单': 'R10', 'backlog': 'R10', '在手': 'R10',
'新增订单': 'R08', '新订单': 'R08', '订单': 'R08',
// 盈利质量
'毛利率': 'R04', '毛利': 'R04',
'净利率': 'R05', 'ebitda': 'R06', 'roe': 'Q01',
'负债率': 'Q03', '资产负债率': 'Q03',
'ccc': 'Q08', '现金转换': 'Q08', '现金周期': 'Q08',
// 运营效率
'存货': 'E01', '库存': 'E01', '库存周转': 'E01', '呆滞': 'E01',
'应收': 'E03', '账期': 'E03',
'人均': 'E05', '人效': 'E05',
'计划准确': 'DR-14', '安全库存': 'DR-15',
// 研发动能
'研发费用': 'G01', '研发投入': 'G01', '研发费率': 'G01',
'里程碑': 'G02', '按期率': 'G02',
'新品贡献': 'G03',
'上市周期': 'G04', '新品周期': 'G04',
'设计变更': 'G06', '变更件数': 'G06',
'复用率': 'G07', '通用件': 'G07',
'在研': 'G08', '专利': 'G05',
// 市场客户
'漏斗': 'M01', '转化率': 'M01',
'ltv': 'M02', 'cac': 'M02',
'留存': 'M04', '大客户留存': 'M04',
'线索': 'DR-12',
'响应时效': 'DR-13', '响应速度': 'DR-13',
// 生产供应
'oee': 'P01', '平衡率': 'P02',
'交付': 'R12', '交期': 'R12', '及时率': 'R12',
'双源': 'K01',
'可用率': 'DR-07',
'性能稼动': 'DR-08',
'良品率': 'DR-09', '品质': 'DR-09',
// 数智化
'渗透': 'D01', 'ai渗透': 'D01',
'成熟度': 'D02', 'ai成熟': 'D02',
'数据资产': 'D05', '在线率': 'D05',
'治理': 'DR-10', '主数据': 'DR-10',
'模型上线': 'DR-11',
// 风险
'敞口': 'RK01', '风险指数': 'RK01',
'合规事件': 'RK02',
// 驱动因子(归因高频对象)
'大客户订单': 'DR-01',
'渠道': 'DR-02', '覆盖': 'DR-02',
'单价': 'DR-03',
'高毛利占比': 'DR-04', '高毛利产品': 'DR-04',
'物料成本': 'DR-05', '关键物料': 'DR-05',
'汇率': 'DR-06',
// 八大维度
'财务': 'D-R',
'盈利质量': 'D-Q', '质量': 'D-Q',
'效率': 'D-E',
'研发': 'D-G', '动能': 'D-G',
'市场': 'D-M', '客户': 'D-M',
'生产': 'D-P', '供应': 'D-P',
'ai': 'D-D', '数字化': 'D-D', '数智': 'D-D', 'dx': 'D-D',
'风险韧性': 'D-K',
'总览': 'OV', '健康度': 'OV', '经营': 'OV',
};
/** 指标实体抽取:别名 + 节点中文名 + code 全匹配,最长别名优先(在手订单 > 订单) */
export function extractMetricCode(text: string, flat: MetricNode[]): string | undefined {
const entries: [string, string][] = [];
flat.forEach(n => {
entries.push([n.name_zh, n.code], [n.code.toLowerCase(), n.code]);
});
Object.entries(ALIASES).forEach(([alias, code]) => entries.push([alias, code]));
entries.sort((a, b) => b[0].length - a[0].length);
for (const [alias, code] of entries) {
if (alias.length >= 2 && text.includes(alias)) return code;
}
return undefined;
}
/** 假设模拟的数值解析:绝对值(提升到 40)与增量(提升 2pt / +2) */
function extractHypothesis(text: string): { absValue?: number; deltaValue?: number } {
const m = text.match(/([-+]?\d+(?:\.\d+)?)/);
if (!m) return {};
const num = parseFloat(m[1]);
if (Number.isNaN(num)) return {};
// 「提升到 / 降到 / 达到」→ 绝对值;「提升 2pt / 下降 2 / +2」→ 增量
const before = text.slice(0, m.index ?? 0);
const isAbs = /到|至|达到|为|变成/.test(before) && !/[-+]/.test(m[1]);
const isPt = /pt|点/i.test(text.slice(m.index ?? 0));
if (isAbs) return { absValue: num };
if (m[1].startsWith('-') || m[1].startsWith('+')) return { deltaValue: num };
if (isPt) return { deltaValue: num };
return { absValue: num };
}
/**
* 意图解析主入口。
* @param raw 用户原话
* @param ctx flat=全量节点;selectedCode=当前选中指标(实体缺失时的上下文兜底)
*/
export function parseIntent(
raw: string,
ctx: { flat: MetricNode[]; selectedCode?: string; },
): ParsedAsk {
const text = raw.toLowerCase();
// 意图:按优先级找第一个命中的关键词组
let intent: Intent = 'fallback';
for (const [it, keys] of INTENT_KEYS) {
if (keys.some(k => text.includes(k))) { intent = it; break; }
}
// 实体:抽取到的优先,其次沿用当前选中节点(上下文兜底)
const extracted = extractMetricCode(text, ctx.flat);
const metricCode = extracted ?? ctx.selectedCode;
// 问句里确实点到了指标但没命中任何意图词 → 视为查询;
// 纯闲聊(无抽取实体)保持 fallback,不因选中节点而误判
if (intent === 'fallback' && extracted) intent = 'query';
// 问“怎么样/多少”却没说对象 → 给经营概览;归因/预测无对象时由 answers 用默认指标
if (intent === 'query' && !metricCode) intent = 'overview';
const out: ParsedAsk = { intent, metricCode, raw };
if (intent === 'whatif') {
Object.assign(out, extractHypothesis(text));
}
if (intent === 'compare') {
out.compareScope = /区域|地域|大区|地区/.test(text) ? 'region' : 'product';
}
return out;
}