mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-19 09:02:02 +00:00
可点击证据第二期:取数链路打通、问数据的答案逐段可点;发布前自动修复
一、可点击证据第二期
取数链路
- 智能体、工具节点、代码节点、知识检索取数时都记进证据台账;报告目录按台账编出 Q1… / K1…
- 报告可以引用快照里的一格([[v:Q1.r0.gmv]]),也可以由系统从快照生成整张表([[table:Q1 cols=… rows=0-4]]),
表里每一格都是可点的片段;取值一律以快照为准,取回快照时复验哈希
- 口径卡表达式新增 cell(x, row, column),lineage 精确到单元格
- 智能体开 cite_fields(配合 output_schema)后,循环结束做一次结构化抽取,每个字段标出取自哪次查询的哪一格,
再到快照里核对:一致记 verified;不一致以快照为准并告警;查不到的记为空值,永远不兜底成 0
- 代码节点新增 evidence_role(source / compute)和 code_sha;沙箱算出来的数不能被报告直接引用,要进口径卡
- 查询快照记下列类型,文本列按文本渲染(年份 "2026" 不再显示成「2,026」)
- 升级前发起的运行(停在审批上的)一律走旧逻辑:新的 task 只追加在循环之后,恢复时不会错号
证据接口与面板
- 片段链接上查询步骤:SQL、被引用的行加前后各 2 行、高亮到格;数据源可设 mask_columns 遮罩列,
遮罩在查询时记进快照,数据源事后改名或删除也照样遮罩(在有身份体系之前,遮罩只减少暴露,不是安全边界)
- 输入来源写明核对结果(与快照一致 / 模型报的值和快照不一致 / 没查到记为空);口径卡缺输入时也给出完整的链
- 受管出具要在契约里声明 cells 才能引用单元格;受管与否记在所钉版本上,改画布不再让受管版本的正式运行降级
- 口径卡可以用 caliber_from 钉住另一个已发布工作流里的口径卡,上游有新版本时按 upgrade_policy 处置,
和子工作流同一套规则;子工作流节点也补上了升版处置的配置项
Copilot、校验与报错
- 问数据的答案里有数字时,搭 input → 智能体 → 报告 → 出口,报告直接引用查过的单元格
- 写 SQL 前核对数据源的表结构,SQL 里出现表结构里没有的列会被打回
- 不再搭「智能体文字 → 转换节点解析 JSON」这种图;转换节点的 JSON 报错分清是上游模型写坏了、
模板里裸插了模型文字(给出 | json 的改法),还是模板本身写错了
- 工具节点遇到「查询失败」「SQL 被拒绝」判为失败;发起运行前检查绑定的工具是否存在,不存在时直接拒绝并给出入口
二、发布前自动修复
- 问题带上机器编号(code)和修复 id;新增只读接口 POST /api/workflows/{id}/publish-check 和 /autofix
- 修复分三类:答案唯一、不降低要求的一键修复;要人拿主意的给选项(不替人选);结构性问题交给 Copilot
- 一律先预览,不自动保存、不自动发布;删节点、删契约、放宽审批、关掉 strict、改级别等降低要求的改动一律拒绝,
Copilot 的方案也要过这一关;应用后重跑检查,错误必须变少且不能冒出新的
- 发布弹窗打开就先检查;问题面板新增「发布前检查」,平时就能看到、就地修掉
- 门禁修正:契约有 report_from 时不再要求 narrative(模板⑨可以发成受管);全图默认审批为「全部放行」时同样拦下
- 修掉画布保存会抹掉全图默认(defaults)的老问题:以前任何一次保存都会把它清空,审批 always 因此被悄悄放宽
验证(沙箱):tsc 干净,生产构建通过,pytest 2268 passed(两遍),check-all 17 项检查、3915 项全过
(新增 check-publish);关键行为做了变异验证、全部抓到。
This commit is contained in:
+150
-7
@@ -304,6 +304,64 @@ export interface ValidationIssue {
|
||||
message: string
|
||||
/** 出问题的是节点配置里的哪一项:'prompt'、'tools'、'cases[1].condition'。老后端不给 */
|
||||
field?: string | null
|
||||
/** 机读编号(governed.agent_approval_never 这类),发布前检查按它认修复。老后端不给 */
|
||||
code?: string | null
|
||||
/** 这条问题对应的修复 id:publish-check 的 fixes 里同 id 的那一项。没有修复时为空 */
|
||||
fix?: string | null
|
||||
}
|
||||
|
||||
/** 发布等级:发布弹窗、问题面板的发布前检查共用 */
|
||||
export type PublishLevel = 'published' | 'governed'
|
||||
|
||||
/**
|
||||
* 发布前检查给的一项修复(POST /workflows/{id}/publish-check 的 fixes)。
|
||||
* auto:答案唯一、不降低要求,预览后一键修;choice:要人拿主意,options 里挑(multiple 可多选);
|
||||
* assist:结构性的,交给 Copilot 试着改,产出同样只是预览
|
||||
*/
|
||||
export interface PublishFix {
|
||||
id: string
|
||||
code: string
|
||||
kind: 'auto' | 'choice' | 'assist'
|
||||
node_id?: string | null
|
||||
label: string
|
||||
preview?: { field?: string | null; before?: unknown; after?: unknown } | null
|
||||
options?: { value: unknown; label: string; hint?: string | null }[]
|
||||
multiple?: boolean
|
||||
/** 建议值:界面上标「建议」,仍然要人选 */
|
||||
default?: unknown
|
||||
}
|
||||
|
||||
export interface PublishCheck {
|
||||
level: PublishLevel
|
||||
ok: boolean
|
||||
issues: ValidationIssue[]
|
||||
fixes: PublishFix[]
|
||||
}
|
||||
|
||||
/** 自动修复预览里给人看的一项改动:「节点 · 字段:原值 → 新值」 */
|
||||
export interface AutofixChange {
|
||||
fix_id: string
|
||||
node_id?: string | null
|
||||
node_title?: string | null
|
||||
field?: string | null
|
||||
before?: unknown
|
||||
after?: unknown
|
||||
label?: string | null
|
||||
}
|
||||
|
||||
/** POST /workflows/{id}/autofix:只给预览,不改库、不发布 */
|
||||
export interface AutofixResult {
|
||||
/** 修复后的整张图;人确认后前端走保存接口存成草稿 */
|
||||
graph: GraphSpec | null
|
||||
changes: AutofixChange[]
|
||||
applied: string[]
|
||||
rejected: { fix_id: string; reason: string }[]
|
||||
/** 修复后仍然存在的问题(带 code 和 fix) */
|
||||
remaining: ValidationIssue[]
|
||||
/** 交给 Copilot 的那一段:它认为要人拿主意的放进 questions,不硬改 */
|
||||
assist: { ok: boolean; summary?: string; questions?: string[] } | null
|
||||
/** 修复后是否已经没有 error */
|
||||
ok: boolean
|
||||
}
|
||||
|
||||
/** 单个节点在一次运行中的实时状态,驱动画布上的高亮。 */
|
||||
@@ -675,23 +733,79 @@ export interface EvidenceGraph {
|
||||
edges?: { from: string; to: string; rel: string }[]
|
||||
}
|
||||
|
||||
/**
|
||||
* 查询快照里的位置:单元格 {row, column};agent 的数组字段按行映射时是 {rows: [首, 尾], column | columns}
|
||||
* (columns 是「字段 → 列」)。行号从 0 数
|
||||
*/
|
||||
export interface EvidenceLocator {
|
||||
row?: number
|
||||
column?: string
|
||||
rows?: [number, number] | number[]
|
||||
columns?: Record<string, string>
|
||||
}
|
||||
|
||||
/** 指标的一个输入:值从哪来 */
|
||||
export interface EvidenceInput {
|
||||
path?: string
|
||||
value?: unknown
|
||||
node_id?: string
|
||||
/**
|
||||
* 一期:input / transform / agent / code / tool / llm …(产出节点的类型);
|
||||
* 二期能追到查询快照那一格的两种:agent_field(agent 开了 cite_fields 的字段)、tool_cell(cell() 取数)
|
||||
*/
|
||||
via?: string
|
||||
field?: string
|
||||
/** 只有 code 节点有:source 取数 / compute 计算(缺省) */
|
||||
role?: string
|
||||
/** ok / missing */
|
||||
/**
|
||||
* 一期 ok / missing;agent_field、tool_cell 是核对状态:verified 与快照一致、mismatch 对不上、
|
||||
* unresolved 核对不了、missing 模型照实说没查到(from 为 null)
|
||||
*/
|
||||
status?: string
|
||||
/** agent 字段的出处,agent 节点内的编号(Q1.r0.gmv)。和报告目录的全局编号不是一回事,靠 artifact 对应 */
|
||||
ref?: string | null
|
||||
/** 查询快照的工件 id:跳到哪一个查询步骤按它认 */
|
||||
artifact?: string
|
||||
locator?: EvidenceLocator
|
||||
eid?: string
|
||||
/** agent_field mismatch:模型报的值(value 是快照里的) */
|
||||
model_value?: unknown
|
||||
/** tool_cell mismatch:快照里的值(value 是算的时候用的) */
|
||||
snapshot_value?: unknown
|
||||
/** unresolved 的原因(人话) */
|
||||
reason?: string
|
||||
/** 输入对到的查询在报告目录里的编号(Q3):接口按工件补的全局编号 */
|
||||
query?: string | null
|
||||
/** 输入落在哪一格,全局编号(Q3.r5.amount) */
|
||||
cell?: string
|
||||
}
|
||||
|
||||
/** 口径卡钉在另一个已发布工作流某个版本里的口径卡上 */
|
||||
export interface EvidenceCaliberSource {
|
||||
workflow_id?: string
|
||||
workflow_version?: number | string
|
||||
node_id?: string
|
||||
/** 接口顺手给的工作流名;没给时前端按工作流目录找 */
|
||||
workflow_name?: string
|
||||
}
|
||||
|
||||
/** 口径卡上游有新版本时声明的处置(和子工作流的升版处置同一套) */
|
||||
export interface EvidenceCaliberUpgrade {
|
||||
node_id?: string
|
||||
workflow_id?: string
|
||||
pinned?: number
|
||||
latest?: number
|
||||
/** recompute / dual / incomparable */
|
||||
policy?: string
|
||||
policy_label?: string
|
||||
}
|
||||
|
||||
/**
|
||||
* 片段证据链的一步。本期有三种:metric(指标)、input(指标的一个输入,也可能挂在
|
||||
* metric.inputs 里)、run_input(报告直接引用的运行输入)
|
||||
* 片段证据链的一步:metric(指标)、input(指标的一个输入,也可能挂在 metric.inputs 里)、
|
||||
* run_input(报告直接引用的运行输入)、query(查询快照:被引用的行加前后各 2 行)。
|
||||
* input 步骤同时带着 EvidenceInput 的字段(via、status、model_value、ref、locator、artifact)
|
||||
*/
|
||||
export interface EvidenceStep {
|
||||
export interface EvidenceStep extends Omit<EvidenceInput, 'status'> {
|
||||
step: string
|
||||
metric?: string
|
||||
decimals?: number | null
|
||||
@@ -720,9 +834,36 @@ export interface EvidenceStep {
|
||||
recompute_ok?: boolean | null
|
||||
status?: string
|
||||
inputs?: EvidenceInput[]
|
||||
path?: string
|
||||
field?: string
|
||||
via?: string
|
||||
/** 口径卡钉在哪个工作流的哪一版(metric;方案第 5 节的写法,接口实际给在 source 上) */
|
||||
caliber_from?: EvidenceCaliberSource | null
|
||||
/** 上游有新版本时的处置(metric);没有升版是 null */
|
||||
caliber_upgrade?: EvidenceCaliberUpgrade | null
|
||||
// ---- query:查询快照的一个窗口 ----
|
||||
tool?: string
|
||||
/** query:数据源名;metric:口径卡钉住的来源 {workflow_id, workflow_version, node_id, workflow_name} */
|
||||
source?: string | EvidenceCaliberSource | null
|
||||
sql?: string
|
||||
columns?: string[]
|
||||
/** 只有被引用的行加前后各 2 行;遮罩列的值已经换成「已遮罩」 */
|
||||
rows?: unknown[][]
|
||||
/** rows[0] 在快照里是第几行(从 0 数) */
|
||||
row_offset?: number
|
||||
/** rows 里每一行在快照里是第几行:被引用的行隔得远时窗口不连续,按它认 */
|
||||
row_index?: number[]
|
||||
/** 快照一共几行 */
|
||||
total_rows?: number | null
|
||||
/** 查询撞了行数上限,库里还有更多 */
|
||||
truncated?: boolean | null
|
||||
/** 被引用的行太多,窗口只给了前面一截 */
|
||||
window_truncated?: boolean
|
||||
/** 被引用的行(快照里的行号)和列;cells 是精确到格的 [行, 列],有它就只高亮这几格 */
|
||||
highlight?: { rows?: number[]; cols?: string[]; cells?: [number, string][] }
|
||||
/** 这一步里被遮罩的列 */
|
||||
masked?: string[]
|
||||
/** 这一步为什么没有行(快照不在封存范围里、哈希对不上、取不回来) */
|
||||
note?: string
|
||||
/** 数据源改名或删掉了、按查询当时记下的遮罩处理时的那句说明。行照样有 */
|
||||
mask_note?: string
|
||||
}
|
||||
|
||||
/** GET /runs/{id}/evidence/segments/{sid}:点开一个片段 */
|
||||
@@ -737,4 +878,6 @@ export interface EvidenceSegmentDetail {
|
||||
/** 落在这个片段(或这一句、没有片段的)上的违规 */
|
||||
violations?: EvidenceViolation[]
|
||||
seal?: EvidenceSeal
|
||||
/** 查询步骤里被遮罩的列(数据源 options.mask_columns)。遮罩只减少暴露,不是安全边界 */
|
||||
redacted?: { columns?: string[] }
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user