"""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'})