接入 DSH 专用运行时和对话界面,保留模型原始回答,支持会话分页、连续追问与显式报告。 补齐组合筛选、各维度 Top100、分组查询到排名图的转换,图表故障静默省略并基于保存数据自动恢复。 优化报告风格、图表顺序和表格换行,更新接入说明及构建输入。 验证:独立目录前后端构建通过;118 项 Java、102 项前端、102 项图表、14 项 DSH 应用和 13 项组合筛选检查通过。 仅提交相关源码、锁定依赖与测试;不包含凭据、会话、业务数据或本地产物。
126 lines
10 KiB
Python
126 lines
10 KiB
Python
"""Shared capabilities for planning, querying, repair and evidence composition.
|
||
|
||
No KPI calculation or browser-success assertion belongs in this module.
|
||
"""
|
||
|
||
DEFAULT_QUALITY_ANALYSIS_POLICY = (
|
||
'【默认业务口径】未指定阶段的“不良/报废/废品TOP”按产品规格的黑片+亮片报废总重排序,附同规格正式综合合格率;'
|
||
'用户明确产业部或业务分组等排名维度时保留该维度;仅未明确排名对象时默认产品规格。'
|
||
'只有明确指定黑片/亮片/分别排名才拆阶段,只有明确指定缺陷/具体项目才转为来源缺陷排名。'
|
||
'合计报废总重不是把两套阶段Top拼接,也不是合并投入后重算率。'
|
||
'单期合计排名的root及ranking节点都必须stages=[]、fields=[rate,scrapWeight],dimensionStages对应维度=[];'
|
||
'root stages是输出口径,不能因数据来自黑片和亮片就写[black,bright]。'
|
||
'单个ranking节点即提供同一组Top产品的报废总重与综合率,不能额外用base metrics代替各规格合格率。'
|
||
'例如未限定阶段的产品不良TOP5:dimensions=[product]、stages=[]、fields=[rate,scrapWeight]、dimensionStages={"product":[]},'
|
||
'queryPlan=[{"nodeId":"rank","purpose":"ranking","dimension":"product","limit":5,"fields":["rate","scrapWeight"],'
|
||
'"stages":[],"selector":{"kind":"base"},"comparisonRequired":false,"visualType":"bar","visualPreference":"auto"}];'
|
||
'comparisonRequired=false、comparisonPeriod=null、trendRequired=false。追问TOP产品沿用期间、筛选和数量。'
|
||
'单期较差产品名单未问原因时,用静态合计ranking直接完成,数量按用户要求或当前展示策略;无需增加自主调查节点或额外比较期。'
|
||
'近期表现较差的产品以报废总重和综合率共同说明实际影响;未明确按最低率排名时,不能只选极小批量的零合格率。'
|
||
'按报废重量选出的Top只能支持所列对象之间的合格率比较;没有完整合格率排序证据,不能声称某项是整个授权总体的最低合格率。'
|
||
)
|
||
|
||
REPORT_STRUCTURE_INSTRUCTIONS = (
|
||
'【内容组织】根据本轮问题、实际证据和用户指定格式选择结构,不复用固定提纲或固定章节数。'
|
||
'用户明确要求的章节、标题、表格及无图要求优先;简单数值查询可只答一句,不强行生成报告。'
|
||
'只问单项指标时,首句先回答所问期间、对象和阶段的该指标;不自动追加未问阶段或其他指标的对比、解释和原因。'
|
||
'用户限定章节数量时,将简短概括放进第一章,不另设导语、摘要或总结章;按指定顺序使用Markdown章节标题。'
|
||
'趋势问题围绕时间变化和拐点,比较问题围绕可比口径和差异,排名问题围绕短表格和重点对象,'
|
||
'原件核对问题围绕核对结果、差异及尚缺证据,决策问题围绕有依据的选项与行动条件;'
|
||
'这些只是组织思路,不能逐项套成统一目录,不能为凑章节增加未问的内容。'
|
||
'一份报告只保留必要的标题和信息层次,不重复堆叠摘要、核心结论、总结和建议。'
|
||
'【阅读顺序】普通分析先用一到两句短句直接回答主要发现,再按本轮最重要的关系展开。'
|
||
'报告导读建议控制在约80—120字,只突出一到两个发现,不把全部阶段指标、重量和排名塞进开篇;用户另有限定时遵从用户。'
|
||
'报告先讲主要变化、差异与意义,月度逐项数据、重量及完整排名等明细表集中放在分析之后。平台会将可用图表放在报告前部。'
|
||
'标题应说明实际内容,不强制使用“核心发现”“摘要”等标签;简短回复不加大标题,正式报告才使用一个一级标题。'
|
||
'趋势分析优先呈现变化与拐点;对象比较先给差异再给对照表;排名先给有序短表再说明重点对象;'
|
||
'总体报告根据实际发现安排总体表现、主要差异或报废结构等必要章节,顺序随问题调整,不能把这些示例当作必填目录。'
|
||
'同一组数字集中呈现一次,正文只解释关键变化或差异,不复读整张表。导读已讲的结论,后文直接展开依据,不再用同义句总结。'
|
||
'已有图表展示的趋势,不另写图表说明式流水账;明细表每种数据只列一次,不为了排版重复总体、阶段或月度全表。'
|
||
'对话比较先给变化和必要的短对照表,若表格已足以回答,就不追加重复段落;追问直接回应新增问题,不重述上一轮整份报告。'
|
||
'一个段落只讲一个关系。仅在证据支持且用户需要时写行动建议;只保留影响本轮解读的具体范围或缺失,不固定增加口径、局限、建议和总结章。'
|
||
'含数值的句子应明确一个具体对象、阶段和指标;多个对象各写完整短句或各占一行表格,'
|
||
'不要用“均、各、分别”让多个对象共享一个数值或按长句位置猜测数值归属。表格每列只表示一种指标,投入与报废分列。'
|
||
'responseStyle=brief或用户要求简短时,只保留直接回答原问题的关系与必要短表,不扩展成整套通用调查报告。'
|
||
'简短报告只解释最关键的一到两个已核实关系,其他数值留在正式表格,不逐行复述全部调查结果。'
|
||
'用户要求一句重点结论时,应点明证据支持的实际主要发现,不能用“如下”或“见表”等引导句替代结论。'
|
||
)
|
||
|
||
CAPABILITY_INSTRUCTIONS = (
|
||
'【平台能力与职责】正式质量指标由quality_data服务端计算和核对,模型不得自行重算或补造。'
|
||
'正式黑片修正分母可能产生超过100%的合法黑片率和综合率;有效正式值照常引用,不截断、不仅因超过100%判异常。'
|
||
'平台根据已核实的quality_data结果及任务的visualPreference/visualType自动准备并展示图表。'
|
||
'模型负责理解任务、选择查询与事实、解释和组织文字,不需要输出图片、HTML、SVG或绘图代码,'
|
||
'不需要寻找绘图工具、探测图表服务或让用户另行生成图表。'
|
||
'不要调用原生display_chart:它读取原生SQL查询结果,与quality_data来源不兼容;本平台图表不经过该工具。'
|
||
'用户要求受支持的图表时,取得相应数据并保留绘图意图即可完成模型职责;'
|
||
'不能因文字JSON通道不直接包含图片就声称无法生成图表,不能把已安排的图表写成后续建议。'
|
||
'模型无法观察浏览器渲染是否成功,不得声称已看见图表或替前端宣布渲染成功。'
|
||
'同轮复合目标可通过queryPlan拆成最多8个有界节点;root目标、filters和期间继续作为权威用户意图,'
|
||
'selector只说明对象来源,不得把子对象筛选回写root filters。'
|
||
) + REPORT_STRUCTURE_INSTRUCTIONS
|
||
|
||
|
||
def capability_context(task=None):
|
||
task = task if isinstance(task, dict) else {}
|
||
plan = task.get('queryPlan') if isinstance(task.get('queryPlan'), list) else []
|
||
node_summaries = []
|
||
for node in plan[:8]:
|
||
if not isinstance(node, dict):
|
||
continue
|
||
node_summaries.append({key: node[key] for key in
|
||
('nodeId', 'purpose', 'fields', 'stages', 'visualType',
|
||
'visualPreference', 'comparisonRequired', 'dimension', 'limit', 'sort', 'optional', 'selector')
|
||
if key in node})
|
||
return {
|
||
'metrics': {'owner': 'quality_data_server', 'modelMayRecalculate': False},
|
||
'charts': {
|
||
'owner': 'platform', 'source': 'verified_quality_data',
|
||
'supportedTypes': ['bar', 'column', 'line', 'area', 'heatmap', 'donut', 'pareto', 'waterfall'],
|
||
'preference': task.get('visualPreference', 'auto'),
|
||
'requestedType': task.get('visualType'),
|
||
'drawingToolRequired': False, 'modelCanObserveBrowserRendering': False,
|
||
},
|
||
'queryPlan': {'maxNodes': 8, 'maxScopedReads': 40,
|
||
'nodeSummary': node_summaries,
|
||
'periodOwner': 'rootTask', 'scopeOwner': 'protocolServer',
|
||
'source': 'verified_node_scope_protocol'},
|
||
}
|
||
|
||
|
||
QUALITY_NATIVE_TOOLS = frozenset({'read', 'list', 'grep', 'search', 'mcp_call', 'mcp_connect'})
|
||
QUALITY_DSH_TOOLS = frozenset({'mcp__quality__quality_data'})
|
||
|
||
|
||
def apply_platform_tools(payload, *, native_agent=False, runtime_engine='NAO'):
|
||
"""Expose tools compatible with platform evidence and answer completion."""
|
||
tools = payload.get('tools')
|
||
if runtime_engine not in ('NAO', 'DSH'):
|
||
raise ValueError('分析引擎无效。')
|
||
allowed = (QUALITY_DSH_TOOLS if runtime_engine == 'DSH' else
|
||
QUALITY_NATIVE_TOOLS if native_agent else QUALITY_NATIVE_TOOLS | {'story'})
|
||
# Clarification/warehouse selection are upstream stop conditions with native
|
||
# UI replies that this platform cannot consume. SQL, renderers and writers
|
||
# also use a different data/artifact lifecycle. Unknown tools stay disabled.
|
||
tools = tools if isinstance(tools, list) else []
|
||
kept = [tool for tool in tools if isinstance(tool, dict) and tool.get('type') == 'function'
|
||
and isinstance(tool.get('function'), dict) and isinstance(tool['function'].get('name'), str)
|
||
and tool['function'].get('name') in allowed]
|
||
if kept: payload['tools'] = kept
|
||
else: payload.pop('tools', None)
|
||
choice = payload.get('tool_choice')
|
||
kept_names = {tool['function']['name'] for tool in kept}
|
||
choice_name = choice.get('function', {}).get('name') if isinstance(choice, dict) and isinstance(choice.get('function'), dict) else None
|
||
if ((isinstance(choice, dict) and choice_name not in kept_names)
|
||
or not kept and choice in ('auto', 'required')):
|
||
payload.pop('tool_choice', None)
|
||
if not kept: payload.pop('parallel_tool_calls', None)
|
||
return payload
|
||
|
||
|
||
def primary_query_required(task):
|
||
"""A source-defect TOP does not need unrelated parent KPI prefetching."""
|
||
return not (task.get('kind') == 'analysis' and set(task.get('dimensions', [])) == {'defect'}
|
||
and not task.get('comparisonRequired') and not task.get('comparisonPeriod')
|
||
and not set(task.get('fields', [])) - {'scrapWeight'})
|