Article body
正文
用户提出“做一张华东各省销售趋势图”，分析人员需要先确认销售额口径、省份范围和时间粒度，再决定调用哪些工具。已有指标能否复用？是否需要补充模型？结果只用于本次讨论，还是要保存成日常看板？这些选择会影响查询、维护和交付的成本。
衡石 Data Agent 将自然语言分析与企业已有的数据集、指标和可视化资产连接起来。 业务人员可以围绕问题持续分析，开发者也可以通过 HENGSHI CLI 与配套 Skills，把读取资源、查询、创作和授权组织成可复核的执行流程。
一图看懂：先确认资源，再选择路径
图中展示的是可用于任务规划的工作方法。Data Agent 的产品内助手与外部 Agent 调用 CLI 的方式各有适用入口；实际执行范围取决于已启用的能力、当前身份和资源权限。
同一个分析目标，可以选择不同的交付方式
| 路径 | 何时适用 | 需要关注的成本 |
|---|---|---|
| 复用已有指标与数据集 | 口径、维度和数据范围已满足需求；临时问数或继续下钻 | 查询执行、模型调用与结果核验 |
| 补充模型后创建分析资产 | 缺少关联关系、维度或业务口径；需要多人长期使用 | 建模校验、数据刷新、权限和后续维护 |
| 导出后进行专门处理 | 需要线下审阅、特殊文件格式或其他系统加工 | 导出权限、文件流转、人工处理与版本管理 |
这三种方式没有脱离场景的速度排名。数据规模、连接模式、查询引擎和筛选条件都会影响响应时间。保存看板可以复用图表、筛选器与布局；计算是否加速，还要结合数据处理方式和实际查询情况判断。
衡石为选路提供了哪些基础
1. 先建立可复用的业务口径。 企业可以在衡石中管理数据模型和指标，通过 HQL 表达业务计算逻辑。分析人员应先核对已有指标的定义、时间字段、聚合方式和可用维度，再决定是否新增对象。同一业务问题沿用经过确认的定义，有助于减少重复建模和口径分歧。
2. 将问数接到分析创作。 Data Agent 可结合当前页面及用户可访问的资源开展分析，并在支持的入口内完成查询、图表或看板创作。用户既可以继续追问异常区域，也可以将需要反复查看的结果整理成分析资产。每一步仍需核验指标、筛选条件和结果。
3. 用 CLI 与 Skills 组织可检查的执行步骤。 HENGSHI CLI 提供结构化的平台操作命令，配套 Skills 可指导 Agent 读取现状、理解参数并按步骤操作。Agent 负责规划和选择工具，CLI 执行具体命令，平台服务端校验权限与业务约束。对于支持预览的写操作，可以先检查 dry-run 结果，再执行变更。
先复用，再补齐。 已有资源满足需求时，优先使用；确实需要新增数据集、看板或权限时，说明创建目的、负责人及交付范围。这是一条可写入团队 Skills 的执行规则。
场景示例：华东销售趋势，从一次问数到每周经营会
虚拟方案示例： 某零售企业希望查看华东各省最近三个完整月份的销售走势。以下步骤用于说明工作方式，不代表实际客户项目或性能测试结果。
| 步骤 | 在衡石中的处理 | 应交付的依据 |
|---|---|---|
| 明确口径 | 核对“销售额”是否扣除退款，确认华东省份范围和月份字段 | 指标名称、定义和筛选范围 |
| 检索已有资产 | 检查当前用户可访问的数据集、指标与看板 | 可复用资源及其适用边界 |
| 完成分析 | 按月份、省份查询，检查缺失值、异常点及汇总结果 | 趋势图、数据范围和核验说明 |
| 决定保存方式 | 临时讨论可保留本次分析；每周经营会需要时再保存看板、配置访问并检查发布 | 资产位置、负责人和使用范围 |
若现有模型缺少渠道字段，团队应先补齐数据与关联，再开展渠道拆解；若问题只是“本月哪个省下降”，则可以在已有资源上继续分析。工具选择应随任务需要变化，避免为一次追问重复创建整套资产。
把成本与结果一起验收
一次任务的成本可以拆成模型调用、查询执行、资产维护和人工复核。团队可记录调用次数、执行时长、新增对象及核验用时，再比较不同路径。查询成本和扫描量还需结合数据库或查询引擎的执行信息评估。
- 查得明白： 使用了哪个指标、数据集、时间范围和筛选条件？
- 建得必要： 新增了哪些对象，是否已有可复用资源？
- 交付完整： 目标用户能否访问，修改后是否需要重新发布？
- 后续可接手： 谁维护口径、刷新与权限，哪些执行记录需要保存？
企业推进 Agentic BI 时，可以用衡石承接从统一指标、自然语言分析到资产创作与交付的工作。团队围绕同一套资源执行、核验和复用，才能在增加分析入口的同时控制维护负担。