Files
AgentLab/backend/app/api/health.py
T
ThearchyHelios 587bf7e27c 第三波前两批:六个「看着成功其实没干活」的平台漏洞堵上,记录页能回放,管理页与画布收尾
起因是一次探索运行:Copilot 改节点时把工具绑定整份抹掉,agent 没有工具只能写「假设调用」,
校验节点的自动修复编出 total_count=0 让 schema 通过,协作成员把工具调用标记当文字输出了四轮,
轮数用完后节点把原话当成功结果交出去——运行标成已完成,数据库一次都没查。

平台可信度(先写失败测试)
- Copilot 修改节点改为合并:没写的字段保留,null 才删除;协作成员按名字合并。前后端同一套规则,
  工具集合变小时自查报警、改图回执列出变化
- 新校验规则:提示词点名了某个工具而节点没有绑定它,判错误,Copilot 自查会交回去修
- 校验修复只许改格式:冒出原文没有的值就判修复无效;修复这次模型调用计入用量
- 识别模型把工具调用写成文字的情况(DSML、<tool_call> 等标记):纠正一次,仍然如此就判失败并说明原因
- 协作团队用完轮数不再按成功交付:默认失败,可选降档,点出一次都没派到的成员
- 审批恢复后,同一节点里已经执行过的工具调用复用结果,不再重复执行

后端
- 查询时限交给数据库执行(Oracle call_timeout、PG statement_timeout、MySQL max_execution_time、
  SQLite progress handler),可按数据源配置;超时报错与实际耗时一致
- 等审批的运行可以真正取消;会话列表带最后一轮状态;测连接结果持久化;探查结构可只看不存;
  自定义工具可草稿试跑、写坏的参数定义保存时拒绝;MCP 服务改动后作废旧工具缓存;
  检索命中带贡献分解;重建索引在后台跑并报进度;报错统一收进 core/errors

前端
- 公共层:管理页共用件、失败说明(lib/explain)、健康状态进公共库;目录按表各自加载并有超时,
  一张表卡住不再拖垮整站;上传显示真实字节进度;离线横幅只播报不变的句子
- 画布:卡片只说游标所在的那一次执行;等审批时可放弃运行;团队收尾判定与未完成说清楚;
  回放用量取那一刻的值
- 编排页:Copilot 合并语义与工具变化回执;「用完轮数时」选项;正式运行期间锁住所有改图入口
- 回答流 / 问数据:新失败类型说人话并给下一步;画布与右栏互相定位;数据源范围、回收站、重新核对
- 记录页:「航迹」页签复用画布时间轴,可拖动回放、列出关键时刻;列表行带执行 / 等人 / 失败缩略条
- 外壳:统一的离开前确认(data router),导航、⌘K、快捷键、后退都会先问

验证(沙箱):tsc 干净,pytest 838 passed(两遍),14 个检查脚本中 13 个全绿;
check-ui 余 1 项旧断言(按旧日期格式找运行行),3c 更新。
2026-09-27 10:16:32 +08:00

70 lines
2.6 KiB
Python

"""最近一次测连接的结果:数据源、模型接入、MCP 服务共用的一套记法。
以前这份结果只在浏览器的 localStorage 里,换台电脑就全回到「未测试」。现在记在
对象上(数据源、MCP 是 last_check 列,模型接入是 extra.last_check),列表接口
平铺成 last_checked_at / last_check_ok / last_latency_ms / last_error 四个字段。
表单里「先测再保存」的那一次也要算数:测的是草稿,保存时后端按连接配置的指纹
认出「刚测过的就是这一份」,把结果带到新对象上。指纹只在进程里记一小会儿,
用的是哈希,不留明文密码。
"""
from __future__ import annotations
import hashlib
import json
import time
from typing import Any
from app.db.base import utcnow
#: 草稿测完多久之内保存还算数。测完去倒杯水回来再点保存,也该认得出来
_DRAFT_TTL = 15 * 60
_DRAFT_MAX = 64
_drafts: dict[str, tuple[float, dict[str, Any]]] = {}
def record(ok: bool, latency_ms: int | None, error: str | None = None) -> dict[str, Any]:
return {
"at": utcnow().isoformat(),
"ok": bool(ok),
"latency_ms": None if latency_ms is None else int(latency_ms),
"error": None if ok else (error or "连不上"),
}
def fields(last: dict[str, Any] | None) -> dict[str, Any]:
"""对象上记的那份 → 列表接口的四个字段。没测过全是 None。"""
last = last if isinstance(last, dict) else {}
ok = last.get("ok")
return {
"last_checked_at": last.get("at"),
"last_check_ok": ok if isinstance(ok, bool) else None,
"last_latency_ms": last.get("latency_ms"),
"last_error": last.get("error"),
}
def fingerprint(*parts: Any) -> str:
"""连接配置的指纹。同一份配置得出同一个值;只拿来比对,不可逆。"""
blob = json.dumps(parts, sort_keys=True, ensure_ascii=False, default=str)
return hashlib.sha256(blob.encode()).hexdigest()
def remember_draft(key: str | None, last: dict[str, Any]) -> None:
if not key:
return
now = time.monotonic()
for stale in [k for k, (at, _) in _drafts.items() if now - at > _DRAFT_TTL]:
_drafts.pop(stale, None)
if len(_drafts) >= _DRAFT_MAX:
_drafts.pop(min(_drafts, key=lambda k: _drafts[k][0]), None)
_drafts[key] = (now, last)
def draft_result(key: str | None) -> dict[str, Any] | None:
"""这份配置最近在表单里测过的结果,没有或太久了返回 None。"""
hit = _drafts.get(key or "")
if not hit or time.monotonic() - hit[0] > _DRAFT_TTL:
return None
return dict(hit[1])