Article body
正文
当数据分析需要进入 CRM、ERP、行业 SaaS 或运营门户，关键不在于把一个独立工具“塞进”页面，而在于让数据、指标、权限和业务界面形成可维护的交付边界。HENGSHI SENSE 以 BI PaaS 的开放能力，支持按层级嵌入分析功能；在合适的数据准备和权限配置基础上，Data Agent 可作为对话式分析入口，HENGSHI CLI 则为可审查的自动化操作提供命令入口。本文从能力、实施方式与边界三个方面说明，如何把衡石分析能力融入业务系统。
1 为什么业务系统需要嵌入分析能力
不少业务系统已经沉淀了交易、客户、库存或运营数据，却仍依赖人工导出、线下汇总和固定报表来回答日常问题。将分析能力放在业务系统的使用路径中，可以让用户围绕当前对象、当前角色和当前业务动作查看数据，而不是在多个系统之间来回切换。
但“嵌入”不是单纯的页面集成。一个可持续运行的分析场景，至少要明确数据从哪里来、指标如何定义、不同角色能看什么，以及分析结果如何被业务人员理解和使用。衡石提供的是数据分析与交付能力；行业业务规则、业务流程和最终决策仍由客户或合作伙伴负责设计与确认。
2 衡石可提供哪些开放能力
2.1 分层嵌入 HENGSHI SENSE
HENGSHI SENSE 是面向业务场景的 BI PaaS 开放能力平台。基于 iframe 等集成方式，合作伙伴可按需要嵌入平台整体、单个模块、模块内功能、单个应用或指定文件夹，而不必把所有分析界面一次性带入业务系统。对单应用场景，还可结合页面层级、侧边栏、标签页等显示控制，让嵌入范围更贴合宿主系统的页面结构。
这种分层方式适合不同交付目标：运营门户可嵌入一个面向查看者的应用；行业软件可嵌入数据集、指标分析或应用创作等功能；需要统一分析工作台的场景则可评估更完整的平台层级。具体嵌入方式、认证方案和可用参数应以所用产品版本及集成文档为准。
2.2 数据、指标与可视化交付
从数据连接、数据集加工，到指标管理、图表、仪表盘和应用交付，衡石提供了构建分析内容的产品能力。指标可作为业务分析的共同语言：原子指标承载计算定义，业务指标可在定义基础上配置分析维度、限定条件、时间轴等信息。将关键口径集中在指标管理中，有助于减少同一场景下重复定义和解释成本；但指标口径是否正确，仍需要业务与数据负责人共同确认。
2.3 Data Agent 与 HENGSHI CLI
Data Agent 提供对话式分析入口，可辅助完成即时数据分析、指标创建和仪表盘生成等任务。它并不替代业务判断：回答质量依赖数据集、字段与指标的准备，以及对行业术语、分析规则和提示词的清晰描述；对重要结论和对外输出，应由相关人员复核。AI 的输出具有不确定性，不应被设置为未经审核的业务决策或自动执行指令。
HENGSHI CLI 是面向人和 AI Agent 的统一命令入口，可覆盖数据连接与数据集接入、查询和预览、仪表盘与报表配置、权限操作及部分运维动作。它适合把重复性操作组织为可审查、可复用的命令工作流；涉及创建、授权、发布等变更时，可先用 --dry-run 预演，再按既定流程审核和执行。
3 嵌入前先确定权限与身份边界
嵌入式分析的核心不是“看得到页面”，而是“身份、权限和数据范围一致”。项目应先梳理宿主系统用户与衡石用户、用户组或用户属性之间的映射，再按应用和数据集的实际使用模式配置权限。衡石在相应权限模式下支持对数据集设置行权限与列权限，可用于控制不同用户可见的数据行和字段。
权限规则需要落在实际被查询和展示的数据集上。若下游数据集由上游数据集加工或关联而来，不能假设上游规则会自动传递；应针对最终使用的数据集进行验证。上线前还应以不同角色的账号或身份完成访问测试，检查嵌入参数、过滤条件和导出等路径是否符合预期。
4 一条可执行的实施路径
4.1 从业务场景而非功能清单开始
先选择一个边界清楚、价值明确的场景，例如门店经营看板、客户运营分析、供应链异常追踪或项目经营分析。明确用户是谁、需要回答什么问题、使用哪些数据、哪些结论需要人工确认。先做小范围验证，比在初期一次性承诺覆盖所有业务模块更稳妥。
4.2 建立数据与指标基础
确认数据连接、更新方式、数据集逻辑和关键字段含义；再与业务方对齐核心指标、维度、过滤条件和时间口径。Data Agent 场景还应补充数据集用途、同义词、行业术语和分析规则，降低语义歧义。数据变化、指标调整和权限变更需要有明确的责任人与变更流程。
4.3 选择嵌入层级并完成验收
根据场景选择嵌入层级，完成认证与用户身份联调，再进行权限、数据一致性、交互体验和异常处理测试。验收不应只看页面能否打开，还应检查不同角色是否仅能看到授权数据、关键指标是否与约定口径一致、嵌入页面在真实业务流程中是否易于使用。性能目标应结合数据源、数据量、查询模型、并发、网络和部署方式在 POC 中实测确认，而不是预设统一指标。
5 结语：让分析进入业务，而不是取代业务
衡石的开放能力适合帮助软件厂商、解决方案伙伴和企业团队把数据分析、指标管理、可视化应用和对话式分析融入既有业务系统。真正可持续的交付，来自清晰的场景选择、可靠的数据与指标基础、可验证的权限边界，以及对 AI 与自动化能力的审慎使用。接口范围、部署要求、可用功能和性能表现会随产品版本、配置和项目环境而变化，建议在正式交付前以当前版本文档和 POC 验证结果为准。