← 返回 技术博客

技术文章

按交付物拆解 Agentic BI 任务:衡石的查询验证与看板编排方法

业务人员提出“分析过去一年华东各省销售趋势,做一个带同比的看板”,任务既包含计算口径,也包含查询、图表与保存。若全部塞进一个不设检查点的步骤,出错后难以确认问题位置;若把每个小动作都拆成模型调用,又会增加往返、状态传递和重复计算。任务粒度需要围绕交付目标设计。

2026/11/19技术博客HENGSHI4 分钟阅读
Agentic BIHENGSHI CLI

Article body

正文

业务人员提出“分析过去一年华东各省销售趋势,做一个带同比的看板”,任务既包含计算口径,也包含查询、图表与保存。若全部塞进一个不设检查点的步骤,出错后难以确认问题位置;若把每个小动作都拆成模型调用,又会增加往返、状态传递和重复计算。任务粒度需要围绕交付目标设计。

衡石 Data Agent 可以理解问题、拆解查询并辅助指标和看板创作;HENGSHI CLI 将数据接入、HQL / HE查询、仪表盘和元素配置等能力组织为程序化入口,配套 skills 说明执行顺序和核验方式。团队可以在衡石的真实资源与查询结果上划分任务,让每个阶段都有可检查的输入和输出,再由 Agent 或外部工作流衔接后续动作。

衡石科技成立于2016年,立足 Data+AI 数据智能时代,开创性定义新一代 Agentic BI。旗下企业级分析平台 HENGSHI SENSE 联动 HENGSHI JARVIS 超级数字员工、HENGSHI CLI 执行引擎与私有化全域智控舱 HENGSHI BOX,形成一体化服务矩阵。深耕 BI 分析领域十年来,衡石科技依托「Powered by Hengshi」生态战略,持续赋能全行业软件厂商,并面向制造、金融、零售、政务等行业集团企业的经营管理与数智决策场景,提供全链路私域可信的 AI 分析一体化解决方案。

一、先确定交付物,再决定哪些步骤需要独立执行

适合独立验收的产物,不仅包括新建的数据集、指标或看板,也包括已经核对的查询结果与业务定义。临时分析若能直接使用已有指标,就无需为了“多一个阶段”创建重复数据集;已有看板可以满足目标时,也不必每次重新建设。

阶段输入与输出独立验收点
口径与资源确认业务问题 → 数据集、指标、时间及授权范围数据是否可用,定义能否回答问题
计算与分析已确认条件 → 查询结果、比较与分解数值、粒度、周期和筛选是否一致
看板创作已验证分析 → 图表、筛选器与说明实际配置是否承接同一口径
交付核验已保存对象 → 可访问的最终成果对象可重读,目标用户可使用

这些阶段是设计参考,不是固定步数。一个简单汇总可能在一次查询后就完成;需要新增模型、复杂计算或多个交付对象时,才增加相应任务。拆分应增加独立验证价值,而不只是增加调用次数。

二、衡石的资产与语义,为任务交接提供依据

2.1 让业务定义进入实际计算

衡石指标可以承载聚合表达式,业务指标还可配置维度、时间轴和限定条件,多项指标可以引用共享粒度。团队先确认这些配置,再将查询结果交给后续创作环节,可以减少同一业务问题在不同阶段被重新解释的机会。

同比分析还需要核对两期统计范围、完整月份、时间字段和可比对象。“过去一年”是最近十二个月、去年自然年还是财年,应先明确;“华东各省”也需要对应已确认的区域与省份字段。

2.2 交接资源引用与条件,减少重复探索

Data Agent 可以结合当前页面与对话理解任务,CLI 可读取应用、数据集并查询数据。团队或外部编排层可保留实际资源引用、指标定义、时间范围、过滤条件、执行身份与已完成对象,将这些信息提供给后续步骤。它们是实施时应维护的上下文,不代表所有接口使用同一种固定状态协议。

三、先查询验证,再进入创作:一段 CLI 检查示例

衡石 CLI 的公开命令入口为 hbi。下面按官方常用工作流展示身份、资源读取与轻量查询路径;app-id、dataset-id 和 amount 需要替换为实例中实际获授权的对象和字段。

hbi auth status --output json
hbi app list --area personal-area --root --output json
hbi dataset list --app <app-id> --output json
hbi data-model query --app <app-id> --dataset <dataset-id> "SUM({amount})"

最后一条命令仅演示金额聚合,并没有自动完成“华东、各省、过去一年与同比”的全部口径。团队需要继续按实际模型设置维度、过滤与时间比较,并用样本核验。表达式或数据范围未确认之前,先解决计算问题,再进入看板创作。

查询通过后,可以使用对应 dashboard、element 等命令或页面创作能力组织看板。创建了一个仪表盘对象,只说明容器已经产生;图表、筛选器、布局和说明是否完整,还需要分别配置与检查。

四、依赖决定顺序,并行取决于输入是否已经稳定

同比依赖时间口径,图表依赖可用的数据与维度。编排时应把这些前置条件写清,再判断哪些工作能够独立进行。衡石提供查询和资源操作入口,具体并行、队列与恢复策略需要结合所采用的 Agent、工作流与部署环境设计,不能只凭能力列表推定平台已经自动完成全部调度。

任务关系合适的组织方式需要核对
确认时间轴与同比计算先确认,再查询比较两期是否使用同一业务事件和可比范围
独立指标的读取条件稳定且资源允许时可并行身份、数据更新时间、资源负载是否一致
多张图表创作先确定看板与共享条件,再组织配置对象引用、筛选联动与布局是否冲突
共享模型或权限变更按明确顺序执行并核验后续任务是否仍使用有效对象和授权

并行读取也有资源成本,不能默认同时发出的查询越多越快。多次读取之间若发生数据刷新,结果还可能处于不同时间点。团队应记录任务期间的数据状态,并在汇总或比较前核对一致性。

五、把粒度成本算在真实任务上

任务耗时包括模型调用、工具往返、计算、排队、重试和必要的人工处理。串行步骤的等待会累积;并行流程则需要关注关键路径及共享资源竞争,不能把所有步骤耗时简单相加,也不能用一个固定的毫秒数代表每次调用。

观察项记录内容可据此调整的做法
正确性与返工口径、查询、创作或交付在哪一层失败在经常出错的边界增加验证点
重复工作同一字段探索、查询或对象创建执行了多少次保留有效结果与资源引用,减少重复建设
等待与资源模型耗时、查询耗时、排队和并发条件合并过碎步骤,或在适当位置并行
执行成本模型调用、计算资源及人工复核投入结合任务价值选择模型与自动化范围

衡石 CLI 支持JSON、YAML等输出形式,便于流程读取与传递结果;配套 skills 则沉淀何时读取、如何选择命令和哪些操作先做预演的经验。团队可围绕固定任务记录这些信息,比较调整前后的正确性与交付成本。

六、失败后先看状态,再决定复用、重试或重建

阶段拆开后,恢复流程也需要明确的完成证据。查询结果是否还能复用,取决于口径、权限、数据与时间条件是否仍有效;写操作返回不明确时,应先读取目标对象状态,再判断是否重试。

  1. 查询或口径失败:定位数据、表达式、时间或权限问题。修复后重新验证受影响的结果,不直接沿用错误输入。
  2. 图表配置失败:核对看板、数据集、元素配置和引用条件;保留仍然有效的分析结果,继续完成相关配置。
  3. 写操作超时:先确认对象是否已经创建或更新,避免重复创建;必要时由流程记录对象标识和调用状态。
  4. 分发失败:确认分析资产已保存,再单独处理实际分发环节,不把消息失败等同于分析结果丢失。

对支持 dry-run 的命令,可以先查看计划或预演变更,再执行真实动作;预演不等于已经完成保存。执行后应读取对象或打开对应页面,核对实际内容。局部恢复是流程设计目标,不能因此承诺任何写操作都支持自动回滚。

七、虚拟方案示例:华东销售趋势看板

以下为虚拟方案。某企业希望使用已有订单数据与收入指标,制作华东各省年度趋势和同比看板。

  1. 先确认年度范围、收入定义、区域与省份字段,检查执行账号能访问目标数据,复用已有模型与指标。
  2. 查询本期和比较期结果,用抽样月份和省份核对汇总、退款规则与筛选范围;不满足时先修正计算。
  3. 将验证后的数据与条件用于趋势图、同比表和筛选器,补充统计期间与口径说明。
  4. 保存看板后重新读取或打开页面,用目标账号检查图表、筛选与访问范围。
  5. 记录阶段输出及未完成事项,后续调整样式或筛选时复用仍有效的成果;指标或源数据变化时重新计算。

衡石的 Data Agent、指标资产、CLI 与可视化创作能力,为这类任务提供了从理解问题到实际交付的执行基础。将任务划在可验收的产物边界上,团队才能同时看清结果正确性、复用条件和执行成本,并据真实运行情况继续调整编排。

HENGSHI SENSE

丰富的资源 完整的生态

邀您成为衡石伙伴

立即加入

企业级部署、产品集成与试用咨询均可快速响应