mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-20 09:11:58 +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:
@@ -4,7 +4,7 @@ import type { CopilotOp, FixKind, RunFinal } from '../run/decode'
|
||||
import { decodeRun } from '../run/decode'
|
||||
import { errorMessage, humanizeError, isNetworkError } from '../lib/errors'
|
||||
import { guardReview, hasEvidence } from '../lib/evidence'
|
||||
import { explainRunError } from '../lib/explain'
|
||||
import { explainRunError, explainStartError } from '../lib/explain'
|
||||
import { parseServerTime } from '../lib/format'
|
||||
import { useCatalog } from './catalog'
|
||||
import { useConversations } from './conversations'
|
||||
@@ -484,6 +484,27 @@ function runFailure(error: string | null | undefined, detail?: string | null): F
|
||||
|
||||
const lineOf = (f: Failure) => (f.reason ? `${f.title}:${f.reason}` : f.title)
|
||||
|
||||
/**
|
||||
* 发起运行那一下被拒(POST /runs 的 ApiError)的说明。绑定的工具在本机不存在(422 run_tool_missing)
|
||||
* 按 lib/explain 讲,带上直达入口(数据源工具去数据页,自定义 / MCP 工具去工具页),和画布上
|
||||
* 发起被拒(run/RunControl)同一套;这时还没有运行 id,流里的报错块不会再拿原话认一遍,
|
||||
* 所以入口得在这里就记进 failure。别的照旧按一句报错拆
|
||||
*/
|
||||
function startFailure(e: unknown): Failure {
|
||||
const x = explainStartError(e)
|
||||
if (!x) return failureOf(e)
|
||||
return {
|
||||
title: x.title,
|
||||
reason: x.reason,
|
||||
hint: x.action,
|
||||
detail: x.raw && x.raw !== x.title ? x.raw : undefined,
|
||||
continuable: false,
|
||||
...(x.fix ? { fix: x.fix } : {}),
|
||||
...(x.fixTo ? { fixTo: x.fixTo } : {}),
|
||||
...(e instanceof ApiError ? { source: e.message } : {}),
|
||||
}
|
||||
}
|
||||
|
||||
/** 运行记录被删了:没有断点可续,也补不回完整答案 */
|
||||
const GONE: Failure = {
|
||||
title: '上次没有跑完',
|
||||
@@ -1437,7 +1458,7 @@ async function launch(
|
||||
// 在这里不成立——这一页没有谁会替它重发
|
||||
const failure: Failure = isNetworkError(e)
|
||||
? { ...failureOf(e, { hint: '后端连上之后点「重跑这一轮」,搭好的工作流不用重来。' }), rerun: true }
|
||||
: failureOf(e)
|
||||
: startFailure(e)
|
||||
patch(() => ({
|
||||
phase: 'error', status: PHASE_TEXT.error, error: lineOf(failure), failure,
|
||||
cancel: null, endedAt: Date.now(),
|
||||
|
||||
@@ -57,8 +57,23 @@ export function toFlow(graph: GraphSpec): { nodes: FlowNode[]; edges: Edge[] } {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 图上节点和连线以外的部分(全图默认 defaults、viewport)。画布只管节点和连线,以前 toGraph
|
||||
* 只拼这两样,保存时 PATCH 整张图,defaults 被整个抹掉——其中审批默认 always 会悄悄放宽成
|
||||
* 全局设置。打开工作流时记下来,toGraph 原样带回去;和 savedSig 一样只属于当前这张图
|
||||
*/
|
||||
let graphExtras: Pick<GraphSpec, 'defaults' | 'viewport'> = {}
|
||||
|
||||
const extrasOf = (graph: GraphSpec | null | undefined): Pick<GraphSpec, 'defaults' | 'viewport'> => {
|
||||
const out: Pick<GraphSpec, 'defaults' | 'viewport'> = {}
|
||||
if (graph?.defaults && Object.keys(graph.defaults).length) out.defaults = structuredClone(graph.defaults)
|
||||
if (graph?.viewport && Object.keys(graph.viewport).length) out.viewport = structuredClone(graph.viewport)
|
||||
return out
|
||||
}
|
||||
|
||||
export function toGraph(nodes: FlowNode[], edges: Edge[]): GraphSpec {
|
||||
return {
|
||||
...structuredClone(graphExtras),
|
||||
nodes: nodes.map((n) => ({
|
||||
id: n.id,
|
||||
type: n.data.nodeType,
|
||||
@@ -560,6 +575,11 @@ interface StudioState {
|
||||
load: (workflow: Workflow | null) => void
|
||||
/** 整张换掉(自动排版)。画布锁着时不换、返回 false:调用方别再报「已换好」 */
|
||||
setGraph: (graph: GraphSpec) => boolean
|
||||
/**
|
||||
* 发布前修复的预览落到画布上:记一步撤销(label),节点的位置和选中照旧、不重新取景——
|
||||
* 改的只是几个配置项,镜头一跳人就找不到刚才在看的节点了。锁着时不落、返回 false
|
||||
*/
|
||||
applyFixes: (graph: GraphSpec, label: string) => boolean
|
||||
onNodesChange: (changes: NodeChange[]) => void
|
||||
onEdgesChange: (changes: EdgeChange[]) => void
|
||||
onConnect: (conn: Connection) => void
|
||||
@@ -1087,6 +1107,7 @@ export const useStudio = create<StudioState>((set, get) => ({
|
||||
get().cancelCopilot?.()
|
||||
dragOrigin = null
|
||||
glideSeq++
|
||||
graphExtras = extrasOf(workflow?.graph)
|
||||
savedSig = graphSig(nodes, edges)
|
||||
lastVarSignature = ''
|
||||
set({
|
||||
@@ -1120,6 +1141,8 @@ export const useStudio = create<StudioState>((set, get) => ({
|
||||
setGraph: (graph) => {
|
||||
if (locked(get)) return false
|
||||
const { nodes, edges } = toFlow(graph)
|
||||
// 整图替换(Copilot、导入)带了 defaults 才换;没带的不能当成「清空」
|
||||
if (graph.defaults !== undefined) graphExtras = { ...graphExtras, ...extrasOf({ ...graph, viewport: undefined }) }
|
||||
glideSeq++
|
||||
commit(set, get, '替换整个画布')
|
||||
set({ nodes, edges, selectedId: null, dirty: true, fitRequest: get().fitRequest + 1 })
|
||||
@@ -1127,6 +1150,33 @@ export const useStudio = create<StudioState>((set, get) => ({
|
||||
return true
|
||||
},
|
||||
|
||||
applyFixes: (graph, label) => {
|
||||
if (locked(get)) return false
|
||||
const next = toFlow(graph)
|
||||
// 发布前修复可能改的是全图默认(比如把 defaults.approval 从 never 改成 dangerous)。
|
||||
// 后端回来的整张图总带着 defaults,照它换;viewport 留着画布自己的
|
||||
if (graph.defaults !== undefined) {
|
||||
const { viewport } = graphExtras
|
||||
graphExtras = { ...extrasOf({ ...graph, viewport: undefined }), ...(viewport ? { viewport } : {}) }
|
||||
}
|
||||
const { nodes: cur, selectedId } = get()
|
||||
const byId = new Map(cur.map((n) => [n.id, n]))
|
||||
// 已有的节点只换名字和配置:位置、量好的尺寸、选中都留着,React Flow 不用重新量一遍
|
||||
const nodes = next.nodes.map((n) => {
|
||||
const old = byId.get(n.id)
|
||||
return old ? { ...old, data: { ...old.data, label: n.data.label, config: n.data.config } } : n
|
||||
})
|
||||
glideSeq++
|
||||
commit(set, get, label)
|
||||
set({
|
||||
nodes, edges: next.edges,
|
||||
selectedId: selectedId && nodes.some((n) => n.id === selectedId) ? selectedId : null,
|
||||
dirty: graphSig(nodes, next.edges) !== savedSig,
|
||||
})
|
||||
void get().validate()
|
||||
return true
|
||||
},
|
||||
|
||||
onNodesChange: (changes) => {
|
||||
if (locked(get)) {
|
||||
// 锁定期间只放行量尺寸和选中:前者是 React Flow 自己的,后者不改图
|
||||
|
||||
Reference in New Issue
Block a user