数据分析台账（analysis_reports）
Agent 在频道里得出的分析结论,可以作为一等记录持久化到平台:专用 analysis_reports 表,按「产线 × 配方 × 时间窗」组织,带关键结论、指标、数据来源与操作者归因。前端 /analysis 页面提供多维检索与实时刷新;外部分析服务(IDD)经 diag_run 以后台任务接入,产出统一落同一本台账。
Agent 原生工具
| 工具 | 作用 | 关键参数 |
|---|---|---|
analysis_save | 保存分析结论(留痕) | title/summary 必填;conclusions(数组)、report(完整正文)、metrics(对象)、recipe_id、window_from/to、data_sources;产线解析=显式 line_id → 频道绑线兜底 |
analysis_query | 检索台账 | report_id 精确取全文;否则按 line_id/recipe_id/category/q/from/to 列表 |
写入门控与产线数据读取一致:能读到哪条产线,才能给哪条产线留痕。台账对 Agent 只增不改(append-only);每笔写入经 recordOps 审计(analysis.save),前端经 WS 实时前插。
人类侧(/analysis 页面)
- 多维检索:产线下拉 / 分类 / 时间预设(1h·24h·7d·30d)/ 关键词(标题+摘要+结论)。
- 行展开:完整报告正文 + metrics + 数据来源 + 归因(操作者/频道)。
- 修订:有
operate产线授权的用户可编辑(PATCH),编辑者归因(updated_by*)随行刷新;Agent 侧永远看到的是最新版。 - 删除:仅 admin(清污数据),同样入审计。
权限隔离(与全站一致)
台账按产线级授权过滤(visibleLineIds):无授权的用户,列表为空、详情 403/404、HITL 快照与运维审计同样不可见——数据不离开服务端。只读(readonly)授权可查不可改;operate 授权可修订。参见产线级权限。
IDD 外部分析集成(diag-bridge)
diag_run 发起后台分析任务,提交即返 task_id,Channel 无需等待:
diag_run({ line, analysis_intent: "stability-report", question: "…运行稳定性报告…" })
→ { task_id }
diag_status({ run_id: task_id }) // 按 taskId 查进度/取结果
→ 状态 running(含阶段)→ completed + 报告文件路径analysis_intent 决定 IDD 侧执行的 skill 协议(全意图目录,IDD harness 执行,与平台解耦):
| 意图 | 用途 |
|---|---|
deep-diagnosis(缺省) | 九阶段深度根因诊断(最重) |
stability-report | 产线稳定报告:评分+等级+运行建议(零根因) |
quick-screen | 快速筛查:越限/漂移/冻结异常清单+HTML 看板(最快) |
doe-analysis | DOE 试验分析:因子效应/显著性/最优工况 |
experience-mining | 调参经验挖掘:结构化经验条目,供知识库沉淀 |
optimizer-campaign | 优化战役:寻优迭代+推荐工况(最重) |
每种意图有按情景生成的缺省分析问题(业务语义由桥注入,IDD harness 执行);任务完成后平台把结果自动回执到发起频道(含评分/结论/总结/报告绝对路径),Agent 用 analysis_save 把结论(附 run_id 溯源)落账。
RAG 侧对称:kb_agent 支持异步任务——mode:"async" 立即返回 task_id,知识库后台完成入库/经验沉淀,kb_agent_status 按 taskId 查询;检索问答用 mode:"sync" 立即返回带引用的答案。
保留策略
retention.analysis_days(默认 365 天)控制台账保留期,纳入统一保留策略清理。
分析结果库(Results Library)
IDD 侧的分析结果库(索引/详情/元数据编辑)已由 diag-bridge 插件接入。默认关闭——结果可见面等于「诊断 API Token 属主的可见面」,平台内不按产线隔离,需管理员显式开启。
| Agent 工具 | 用途 |
|---|---|
diag_results | 检索结果索引(q/intent/category_id/tag/scene/harness/min_score/sort/limit/offset;缺省 brief=true 省 token,brief=false 带 key_numbers) |
diag_result_get | 按 result_id 取详情(摘要 + 关键数字溯源 + 工件/HTML 的绝对 URL;include_md 可选,按上限截断) |
diag_result_annotate | 编辑元数据(description/tags/title,description=null 可清除;仅 lead + 插件开关;IDD 侧属主校验) |
设置(插件 → diag-bridge → 分析结果库):results_enabled(总开关,默认关)、results_allow_annotate(编辑开关,默认关)、results_allow_worker(worker 可读,默认关=仅 lead)、results_default_limit(缺省 20)、results_md_max_chars(报告截断上限,缺省 4000)。/plugins 页内置「分析结果库」面板:搜索/过滤 → 详情 → 描述与标签编辑(同源路由 GET /api/plugins/diag-bridge/results、/results/detail?id=、PATCH /results/edit?id=)。
Agent 典型用法:先 diag_results(q="薄膜厚度") 找到 result_id,再 diag_result_get 读结论与关键数字,必要时 diag_result_annotate 补一句「这条结果代表什么、何时复用」。
分析台账记「结论」,EDA 工坊看「数据」——交互式探索(图表 / 管道 / SPC / golden)见数据管理台与 EDA 工坊。