mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-15 00:21:58 +00:00
ThearchyHelios
2714890d0d
README.zh-CN.md / README.md 只留：这是什么、为什么用它、主要功能（按领域一行一条，链到文档）、快速开始、部署、文档索引、 开发与测试、许可（原文不动）。原来的每一节按读者和任务分到 17 篇主题文档：ask-data、workflows、evidence、 data-sources（新增：接入数据库、只读保证、上传表格、跨库合并、遮罩列）、data-catalog、tools（新增：工具、审批档位、 能力登记、端点、网络规则——它们管所有工作流，不只应用）、apps、evaluation-and-ledger、schedules（含通知）、deployment、 configuration、postgresql-and-scaling、identity-and-security、architecture、development、upgrade-notes（按时间倒序， 每波先写要做的事）、faq。删掉的只有模块名（api/copilot_gen.py、chat/drive.py、data/schema_view.py）、重复的话和 「以前…现在…」的叙述；操作步骤、命令、配置名、限制、权限边界都有归宿。中文是原文，英文按新的中文写；英文里界面文字 只写英文名，开头注明界面目前只有简体中文，中文占位符换成英文占位符，中文数字的例子改成不依赖中文的说法。 数据剖析可以同时剖析 2–3 张表（baf23998）收进 data-catalog。 新增 scripts/check-docs.py：英文文档（README.md、docs/en/**）不许有中日韩字符和全角符号（代码块也算）， README、docs/**、deploy/README.md 的相对链接和锚点都要通，docs/zh-CN 与 docs/en 文件一一对应、标题层级相同。 中文提示里指向 README 章节的地方改指新文档：cluster/guard.py、cluster/version.py、db/base.py 两处报错， data/schema_view.py 文档串，.env.example 三处，scripts/prod.sh、scripts/test-postgres.sh，terms.ts 两处、 DataSourcesTab.tsx、check-manage.mjs 注释，deploy/README.md 三处链接。deploy/agentlab.env 未动。 验收：check-docs 0 问题（英文文档 18 个 0 处中文，相对链接 369 条 0 断链，18 对标题层级一致）；相关后端测试 117 通过、7 跳过；tsc -b、check-copy 通过。
80 lines
5.9 KiB
Markdown
80 lines
5.9 KiB
Markdown
[English](../en/ask-data.md) | 简体中文
|
|
|
|
# 问数据与助手
|
|
|
|
这篇讲「问数据」页和助手：提问之后发生什么、答案里的数字怎么核对，以及助手怎么看表、怎么自查。助手是界面上的「助手」，用自然语言生成和修改工作流的模型。给用问数据的人和搭建者看。
|
|
|
|
## 怎么问数据
|
|
|
|
1. 打开「问数据」页，用自然语言提问。
|
|
2. 系统自行接入数据源、生成一张工作流、执行，然后给出结论。
|
|
3. 答案里有数字时，经报告撰写节点输出，逐段点得开出处（见[证据与出具](evidence.md)）。
|
|
|
|
对话会保存，可以用链接分享。
|
|
|
|
没接真实模型时，内置的 Mock 也能跑完整条链路，但它不写引用标记，报告里的数字全标成「无证据」。要看到可点的出处，在「设置 → 模型接入」接一个真实模型（见[配置](configuration.md#模型接入)）。
|
|
|
|
## 一轮里发生什么
|
|
|
|
一轮包括：助手建图、发起运行、复核、按复核重来、保存结果。这些都在服务端的后台任务里跑，页面只负责看。
|
|
|
|
- 掉线、刷新、关掉再打开，都按序号接着看。停止走接口 `/api/chat/turns`。
|
|
- 服务重启时，还在建图的那一轮标成中断，可以点「重试本轮」；已经发起运行的那一轮接着等运行结束，照常复核收尾。
|
|
- 服务重启后接手一轮时，按账号现在的角色重新核对；账号停用或没了权限的，照实标成中断。
|
|
- 同一段对话同时只跑一轮。停在审批上等人的那一轮不算。
|
|
- 助手只给了思考、一个操作都没给时，自动重来一次。
|
|
- 每一轮的花费包括助手建图、挑表和复核的模型调用。
|
|
|
|
## 产出复核
|
|
|
|
运行结束后，规则先扫一遍事件流，发现异常才调用模型复核。复核可以重组答案，但**不得引入原答案里没有的数字**。
|
|
|
|
- 使用者（user 角色）的问数据也会被复核。
|
|
- 子工作流里一步失败时，自动复核只报一条。
|
|
- 问数据里的「继续运行」只给搭建者以上。
|
|
|
|
## 答案里的口径
|
|
|
|
口径是一个指标怎么取数、怎么算的约定，固定在口径卡里，带名字和版本。答案封存后，系统在后台把答案里的每个数和已发布的口径比对、标上口径，每一轮底下有一行摘要。整题等价于一份受管口径时，系统自动按口径发起一次正式运行。详见[回归评测与口径账本](evaluation-and-ledger.md#口径账本)。
|
|
|
|
## 从答案到工作流和应用
|
|
|
|
- 「在画布里打开」：把这一轮的图放进画布。建出的工作流记下来自哪一轮。
|
|
- 「做成应用」：先把这次运行提取成工作流（只保留实际执行的步骤），在画布上发布，再从发布成功的提示进来（见[应用](apps.md#生成一个应用)）。
|
|
- 问数据发起的运行带着所在对话和轮次（`origin_ref`）。
|
|
|
|
## 谁能用
|
|
|
|
问数据默认给搭建者和管理员。管理员可以在「设置 → 身份」给使用者开启。使用者只能发起探索运行，能用的节点和工具有白名单，见[身份、权限与安全](identity-and-security.md#使用者的问数据)。对话按建立人隔离。
|
|
|
|
## 记录保留多久
|
|
|
|
- 每一轮的事件日志（`agentlab.db` 的 `chat_turn_events` 表：助手的操作、阶段、运行、复核、终局）只为进行中的轮次服务，供页面先回放再接实时。
|
|
- 结束（成功、失败、取消、中断）超过 14 天的轮次，由调度循环每小时清一次，整轮删除。
|
|
- 重开已结束的一轮，读的是对话里保存的那一行（答案、图、复核、用量、尝试次数），不受清理影响。
|
|
- 助手等模型时的心跳只在实时流上发，不落库。
|
|
|
|
## 助手
|
|
|
|
助手根据一句话生成或改写整张图，并自动排版。画布、问数据、`/generate` 接口、发布前修复、升级证据、应用润色都用同一套生成过程：起草 → 查看 → 接着写 → 自查修正。
|
|
|
|
- 改图时只给出改动操作，不重写整张图。
|
|
- 交付前按运行时同一套规则自查。查出会运行失败的问题，先交回去改；改不好就不自动运行。
|
|
- 建图时主动把应当记住的事实写进长期记忆。
|
|
|
|
### 按需查看
|
|
|
|
助手的系统提示里，每个数据源只有一行概览（表数、几张有目录、有没有遮罩）；画布和问数据另列能力登记里的能力，问数据只列只读的。要看表结构、能力参数或工作流版本时，助手自己「查看」，服务端一次给齐字段、目录和连接条件。闲聊、改提示词只调一次模型。
|
|
|
|
- 查看时，助手输出一行 `{"op":"look","need":…,"targets":[{"kind":"table","source":…,"name":…}]}`。服务端读到就停止这次输出，查看完把结果作为下一条消息交回；助手接着写，已经落地的操作不重复。
|
|
- 能看三类对象：表；能力（名字、参数、返回字段、读写、要不要确认，不给地址和凭据）；工作流版本（只列已发布且未退役的）。
|
|
- 点名的直接取。只给需求时：候选不超过 12 张就全给；否则按需求挑（关思考，20 秒时限），沿关联补上两跳以内的中间表，一次最多 16 张、12,000 字。
|
|
- 挑不出、或者挑出来是空的，照实说，并把表的清单交回去让助手点名。
|
|
- 每轮最多查看 3 次，自查修正另给 1 次。
|
|
- 系统代为查看：发布前修复、升级证据按要修的 SQL 点名查看用到的表；应用润色先查看应用固定的工作流版本。
|
|
- 每次查看发一条 look 事件（看了哪些、怎么来的、没找到的、目录版本、用时），存进这一轮的 `meta.looks`。下一轮写「上一轮查看过：…」，追问时直接点名看。
|
|
|
|
### 先问再做
|
|
|
|
必须先问清才能动手时，助手输出 `{"op":"ask","question":…}`，这一轮就此结束。已经落地的改动照常交付，但不自动运行。
|