数脉:数据库与问数

问数与授权

业务人员怎样在 Nexus 助手里问数,助手能调用哪些操作,授权能细到什么程度。

在 Nexus 助手里问数

业务人员在 Nexus 助手里提问,不需要进控制台。Nexus 助手需要已经按接入智能体连接,Key 上要有数脉的授权。

先看看有什么

Nexus 助手侧栏的「Nexus 管理」页里,有这把 Key 获授权的模块标签。数脉标签的「资源拓扑」按数据源、业务分组、表展开:点表可以看字段(仅聚合的字段标「仅汇总」)、已确认的关系和业务说明,点「预览样例数据」最多读 5 行,按这把 Key 的行范围返回,只在点击时读取。这些行只用来说明数据形态,不代表全量,也不是统计结果。页面还列出常用查询和 24 小时内交付的结果文件。

提问

在 Nexus 助手里新建会话,用自然语言写明数据源、期间、状态、分组方式、排序和输出要求。例如:

查询某某订单库,全时间范围内按客户城市统计已支付订单数和销售额(元),按销售额降序排列,并给出合计。若需要确认查询计划,请先展示计划。

这只是示意的问法。提问越具体,需要追问的就越少。需要补充口径时,助手会追问;同一个问题不会静默发往所有数据库,选了多个数据源时,会为每个数据源整理独立的问题。

确认查询计划

助手先给出查询计划,此时还没有执行。计划里写明数据来源、用到的表和关联、统计口径(哪些状态计入)、指标、时间范围、排序、合计和返回的列。检查这些内容:

  • 数据来源和关联是否对,订单状态、金额单位和期间是否符合你的意思。
  • 有差异就在对话里直接说明,助手会给出调整后的计划,再次确认。
  • 口径一致后回复确认,例如「确认执行」,才会提交只读查询。

计划还绑定着结构和业务说明的版本,确认前版本变化会阻止执行,要重新讨论新方案。多个数据源时,每个数据源的计划可以单独调整,一次最多选 5 个数据源,每个数据源的方案最多指定 20 张表。

多个数据源的结果有四种处理方式:分别展示;按已确认的口径并列对比;恰好两个数据源各自查询后,按明确的结果列键做关联;以及分别查询后由 Nexus 在应用内组合、汇总,并可计算比率、差值、环比和同比。关联和组合都在查询返回的结果上做,不执行跨库 SQL。

核对结果

确认后,每个数据源创建一个只读任务。任务可能异步完成,回执不等于查询已完成,要看最终状态。出现「需要补充」时,助手把具体问题交给你,你补充后会形成新计划,再确认一次;系统不会自动重试。某个数据源失败时,成功的部分只能标为部分结果,不会当作完整结论。

结果出来后,核对这些内容:

  • 返回的字段、总行数、是否被截断,以及执行时间。
  • 合计、排序、期间和过滤条件,是否与确认的计划一致。
  • 结果依据:用到的表、字段、关联,以及警告。使用了指标的查询还会说明是否按口径字段计算;配置了期间状态时,写明各期间是否已关账。

助手本身只拿到结果引用、总行数、列、口径和最多 5 行脱敏样例,完整的行留在服务端。助手不能用这 5 行样例推算合计。预览行数和合计位置有差异时,以完整结果为准,不要把没有显示的行当作缺失的数据。需要完整结果时,让助手导出文件。结果被截断时,要缩小范围或先在各数据源里聚合。

导出文件

在原会话里告诉助手要导出的范围、格式(CSV 或 Excel)和文件名。助手调用平台的结果交付,生成文件,并给出下载入口:

  • 文件最大 2 MiB,保存 24 小时,过期要重新生成。CSV 带 UTF-8 BOM,并防公式注入。
  • 只能交给 Agent 所属的人员。这个 Agent 要归属到人员,下载时此人要经客户的身份系统登录;没有配置统一身份时,文件生成成功也不能下载。
  • 文件里是完整结果。个人信息仍按字段级别脱敏。

对话完成并确认的结果,可以让助手保存为常用查询,以后直接复用。下次提问时,助手会先用 asset.match 在资产目录里找可复用的口径,找到唯一匹配的常用查询时,准备好后仍要你确认才运行。

AI 助手能做什么

下面是数脉向 Agent 开放的操作,操作名和授权以模块清单为准。授权名对应「授权管理」里的动作:「查看结构」和「执行查询」。所有操作对客户数据都是只读的。

操作做什么授权人确认或审批
sources.list列出这把 Key 有权使用的数据源,以及是否可只读问数。配置了数据版本查询时,带数据截至时间。查看结构不需要
topology.get读取授权的表目录。指定表后返回字段、已确认关系和已授权的业务说明,仅聚合字段标 aggregate_only。查看结构不需要
metric.list列出已确认的指标口径,只含这把 Key 能读全部相关表和字段的指标。不能修改。查看结构不需要
asset.search检索指标口径、确认样例、常用查询和业务主题。查看结构不需要
asset.get读取一个资产的完整说明。确认样例只供参考,不能执行。查看结构不需要
asset.match问数前用问题匹配可复用的资产,结果是可直接准备运行、需要澄清或没有匹配。查看结构不需要。准备运行常用查询后仍要用户确认
data.preview读取授权表的字段说明和最多 5 行样例,服务端强制行权限,不调用模型。执行查询不需要。读到个人信息或敏感字段时记入敏感访问审计
conversation.turn多轮问数:提交问题和数据源,由服务端规划,补充口径但不执行;用 action: "confirm" 确认后才执行。执行查询需要提问的人确认计划
conversation.get读取问数对话、追问、待确认的计划、各数据源的子任务,以及完成后的分析结果。执行查询不需要
question.submit兼容旧版的单次单源问数,提交一次,用 job.get 读结果。没有计划确认步骤,新问数建议用 conversation.turn。执行查询无计划确认步骤
job.get读取任务的进度和结果:结果引用、总行数、列、口径、血缘和最多 5 行脱敏样例。执行查询不需要
saved_query.list、saved_query.get列出和读取常用查询(自己的和他人共享的)。执行查询不需要
saved_query.save把用户已确认且成功执行的对话保存为常用查询,或修改自己的常用查询的名称、说明、共享和参数。执行查询仅在用户明确要求时调用
saved_query.delete删除自己保存的常用查询。执行查询仅在用户明确要求时调用
saved_query.run准备运行常用查询:按当前权限重新校验,返回等待确认的对话,此时尚未执行。执行查询需要用户确认,再用 conversation.turn 的 confirm 执行

metric.list 和 asset.* 系列要求 Agent 至少有一张表的「查看结构」授权;asset.match 的语义召回还要配置「选表与问数规划」模型。

数脉不使用 Nexus 审批页的「本人确认」「他人审批」档位,这里的确认是提问的人在对话里确认查询计划。要把完整结果交给本人下载,用的是 Nexus Core 的 result.deliver。Agent 没有读取日志、结果留存和敏感访问审计的操作,也不能维护指标、关系、对数基准和连接,这些只在控制台由管理员操作。

授权到多细

在「接入中心 › 授权管理」里,选一个授权对象(单位、岗位角色、人员或 Agent),添加授权,模块选数脉,再选资源类型。也可以在数脉面板标题栏的「更多 › 授权管理」直接跳过去。数脉有两类资源:

  • 数仓表:动作是「查看结构」「执行查询」。执行查询必须同时允许查看结构。
  • 业务文档:动作是「读取业务文档」,决定 Agent 能不能使用你上传的说明文档。

数据源本身不单独授权,列表里每张表的名称以「数据源名 · 」开头。一次可以选多个表,同一组能力逐个表添加。数据范围属于单个表,只在选了一个表时可以编辑。数脉的执行能力要求这个 Agent 在所授权的每一张表上都有「执行查询」,有一张表没有,就没有执行能力。

表上可以设置这些数据范围:

约束作用
可见字段默认「全部字段」,即当前已确认的全部字段。可以只选其中一部分,其余字段对这个 Agent 不可见,包括模型看到的结构和 SQL 授权目录。
只允许聚合选一些字段,只能做汇总,看不到明细。可再设「每组最少主体数」(2 到 1000)和「计数主体字段」(如工号):人数不足的分组不返回。这些字段只能放在 SUM、AVG、COUNT 里,不能做明细列、MIN、MAX、窗口函数、过滤、关联、分组或排序,也不能先在子查询里取出。
行条件某个字段等于以下任一值。字段须在「可见字段」中,且不能是只允许聚合的字段;同一字段只能有一条行条件,每条最多 50 个取值,最多 20 条。可以引用调用者变量,让同一条授权对不同的人展开成不同的范围,见按调用者动态限定范围。
固定条件(高级)一个 SQL WHERE 片段,服务端强制附加。
按关联表过滤(高级)经已确认关系,用关联表的行条件限定本表的行。只有 MySQL、TiDB、MariaDB、PostgreSQL、SQLite、openGauss 和 GaussDB 支持,其他产品配置了会被拒绝保存。
每次查询最多返回的行数1 到 500,没有设置时默认 100。
跨源组合的中间结果行数上限可选。让跨数据源组合的中间结果超过上面的行数上限,中间结果不会交给 Agent。只有 Agent 的每张表授权都设置时才生效,取最小值。

行条件、固定条件和关联表过滤在 SQL 的每一层(子查询、CTE、UNION ALL 的每个分支)都会注入,查询读到的始终是过滤后的行。大多数产品只支持字段取值和固定条件两种行权限,具体见产品的「连接说明」。表、字段、行条件对 Agent 的实际生效结果,可以在 Agent 详情页的「有效权限」里核对,并用这把 Key 在 Nexus 助手里实际验证一遍。

授权的合并规则、三档调用和审计,见授权、审批与审计。

进一步交流

带一件正在做的事来聊

告诉我们你想让智能体接哪一类系统。我们在演示环境里把这件事走一遍,再一起判断合不合适。