MODEL INPUT AND OUTPUT条件调用
用户先与确定性分析工具交互，再可选触发模型解读。
TECHNICAL WALKTHROUGH / CHECKED
AI 协作分析技术执行说明
意图路由 → 指标工具 → 图表 → 可选模型解读
CURRENT IMPLEMENTATION
核心 API 用确定性指标工具返回 chart-ready JSON；直接 Demo 可在计算完成后调用 DeepSeek 解读，不让模型计算指标。
AI 边界
没有外部模型；自然语言问题只路由到本地指标函数。
人工权限
分析师定义指标口径并限制因果结论。
运行拓扑：用户如何抵达结果
页面负责收集与组装输入；合同、引擎和回执负责把边界变成可检查的执行链。
- 01
页面交互
问题快捷键 + 工具轨迹 + 图表，外观接近 Copilot，但不是持续会话 Chatbot。
当前执行 - 02
CollaborativeAnalysisInput
输入是自然语言指标问题和固定 metricVersion。
当前执行 - 03
分阶段引擎
输入扫描 → 意图路由 → 指标工具 → chart schema → 因果限制 → 可选 DeepSeek 解读
当前执行 - 04
Collaborative analysis result
核心输出是结构化 JSON 与 chart series；DeepSeek 额外返回纯文本流。
当前执行
EXECUTION ORDER
模型 User Prompt 由页面自动组合“原问题 + 已算数据 + 不得编造”。
模型、算法与工具逐项列账
模型名、规则引擎、检索器、评测器和控制层分开陈述；相似名称不等于真实调用。
intent router + governed metric tools
当前执行关键词把问题路由到漏斗、留存或增长函数并返回图表序列。
由页面 Demo 或 POST /api/labs/:slug 同步调用；无外部推理请求。
deepseek-chat
条件调用只解释已经计算出的 chart/assistant 数据并给一条建议。
直接 Demo 点击“DeepSeek 解读”后由服务端流式调用；生产密钥已配置。/api/labs 不调用。
AI / ML
Intent routing
关键词把问题映射到受控指标。
Data
Metric catalog
指标名称、版本和定义集中声明。
Agent / Harness
Deterministic analytics tool
选定工具执行固定计算而非文本猜测。
Observability
Structured tool call
tool、arguments 和 permission 可检查。
Data
Chart-ready schema
输出 series 可直接可视化。
Observability
Metric lineage
每个回答绑定 metricVersion 和数据来源。
Control
Prompt-injection scan
问题不能转换为命令执行。
Control
Causal-claim restriction
描述性结果明确禁止因果外推。
输入合同、分步执行与结构化输出
先算后说，模型只能解释可检查数据；模型失败时图表和指标仍完整。
INPUT
CollaborativeAnalysisInput
不上传数据表或截图；当前指标基于小型合成数据集。
questionmetricVersion
STAGED EXECUTION
输入扫描 → 意图路由 → 指标工具 → chart schema → 因果限制 → 可选 DeepSeek 解读
- 01
接收问题和可选指标版本。
CollaborativeAnalysisInput → trusted analysis envelope
- 02
识别转化、留存或收入意图并绑定指标目录。
question → intent + metric contract
- 03
执行允许的确定性分析工具。
metric contract → tool result
- 04
验证 tool、permission、指标版本和因果措辞。
tool result → gate + lineage
- 05
返回叙述、指标和 chart-ready series。
gate → analysis + chart
- 06
暴露 tool call、指标口径和血缘供人机共同复核。
analysis → trace + lineage
OUTPUT
Collaborative analysis result
一个问题、一次受控工具调用和一份可视化结果。
intenttoolCallanalysismetricschartlineagegate
Prompt 与 Schema 的四层装配
System、Few-shot、用户运行输入与输出格式分别标注；没有 Prompt 的项目不会假装存在 Prompt。
- 01
系统约束
可选综合层使用固定服务端指令：仅依据给定要点、不得补造法规或事实、不确定时明确说明；客户端不能看到密钥。
条件调用 - 02
少样本
没有 Few-shot；预设问题只是页面快捷输入，不进入 System Prompt。
合同不接受 - 03
运行时输入
页面自动注入原问题与 chart/assistant 数据；用户不编辑完整 Prompt。
条件调用 - 04
输出合同
CollaborativeAnalysis structured result 仍返回结构化 JSON；可选 DeepSeek 层只流式返回受证据约束的纯文本解释。
当前执行
多模态准入矩阵：每一项都有明确状态
图片、音频、视频和数字人不会用空字段含混带过；未接入就明确写出未接入。
文本
当前执行question 参与意图路由，可选生成文本受已算数据约束。
表格 / JSON
当前执行指标、tool call 和 chart series 是结构化输出。
图片
合同不接受严格 JSON 合同不接收图片；未知字段会被拒绝，不会保留空占位。
音频
合同不接受没有音频上传、ASR 或声学特征管道。
视频
合同不接受没有视频上传、解码、分镜或帧级推理入口。
数字人
合同不接受没有数字人资产、驱动参数或渲染合同。
人工输入 / 复核
当前执行分析师拥有指标定义并限制因果结论。
用户在页面上操作，样本用于验证边界
预设不是替用户做决定，也不是偷偷注入 Few-shot；它让同一合同在基线与压力条件下可复现。
交互表面
问题快捷键 + 工具轨迹 + 图表，外观接近 Copilot，但不是持续会话 Chatbot。
选择样本的目的
预设问题用于明确路由到漏斗、留存或增长工具；不作为模型 Few-shot。
分析提示注入
STRESS TEST把越权指令伪装成指标问题。
问题被安全扫描阻断
只解释已经计算出的 chart/assistant 数据并给一条建议。