Article body
正文
企业把 Agentic BI 接入业务系统,通常需要在同一门户中查看经营看板、追问数据,并把分析结果接入自有流程。完整页面、局部交互与后台调用各有不同的集成需求,项目还要衔接宿主身份和分析资源,才能让业务人员在原有工作入口中使用这些能力。
衡石为这些需求提供页面嵌入、JS SDK 和 API 等交付路径:iframe 可复用完整分析页面,JS SDK 可接入对话与结果渲染能力,API 适合服务端调用和流程编排。集成团队可以围绕已有的数据集、指标、看板和权限体系选择接入层次,再按实际入口配置登录、资源访问和页面交互,组织适合自身业务的 Agentic BI 体验。
衡石科技成立于2016年,立足 Data+AI 数据智能时代,开创性定义新一代 Agentic BI。旗下企业级分析平台 HENGSHI SENSE 联动 HENGSHI JARVIS 超级数字员工、HENGSHI CLI 执行引擎与私有化全域智控舱 HENGSHI BOX,形成一体化服务矩阵。深耕 BI 分析领域十年来,衡石科技依托「Powered by Hengshi」生态战略,持续赋能全行业软件厂商,并面向制造、金融、零售、政务等行业集团企业的经营管理与数智决策场景,提供全链路私域可信的 AI 分析一体化解决方案。
一、先选运行方式,再选接入方式
衡石的 Data Agent 集成区分 Agent 和 Workflow 两种运行方式。Agent 模式支持持续推进问答并逐步反馈执行过程;在浏览器嵌入场景,前端运行时参与其中。Workflow 模式由后端工作流服务推进问答。企业需要后端接入 Agent 模式时,也可以评估 Node.js 版 Agent 服务。
iframe、JS SDK 和 API 是接入形式。API 接入可以承接不同运行方式,SDK 也不只是显示已经生成的文本。把这两个维度分开,才能明确会话、执行过程、页面展示和故障排查分别由谁负责。
| 方案维度 | 需要先回答的问题 | 对交付的影响 |
|---|---|---|
| 运行方式 | 分析任务由前端 Agent 运行时、Node.js Agent 服务,还是后端 Workflow 推进? | 决定执行过程、状态反馈与服务部署责任 |
| 接入方式 | 复用完整页面、聊天与结果组件,还是只接后端能力? | 决定界面与交互的开发范围 |
| 身份与数据 | 谁调用、属于哪个租户、可以访问哪些资源? | 决定认证、授权和结果验收条件 |
二、iframe:复用完整分析体验,并与宿主系统联动
1. 从完整页面到单个分析对象
iframe 适合复用衡石已经完成的分析页面。项目可以嵌入完整 ChatBI 页面,也可以按实际需要嵌入应用、仪表盘或图表。用户继续使用衡石提供的问答和看图交互,集成方集中建设业务页面与访问入口。
客户产品同样可以采用 iframe。衡石的仪表盘嵌入支持页头、翻页器、滚动、背景、标题颜色和图表间距等配置,企业也可以结合主题及 OEM 方案统一体验。适配程度取决于目标页面、受支持参数与定制范围,项目团队应拿实际设计逐项核对。
2. 把业务上下文带入分析页面
客户详情页切换了客户,分析区域也应同步更新。衡石提供 URL 参数和页面消息交互能力,宿主可以按文档传递参数、更新嵌入地址或触发仪表盘刷新;还可以监听应用、目录、点击对象及 URL 变化等事件,将分析过程衔接到业务操作。
这里需要区分业务筛选和数据授权。日期、门店或商品参数用来确定当前分析任务;数据权限由认证后的用户及平台授权约束。隐藏筛选器或在 URL 里传一个客户编号,都不能代替数据权限配置。
三、JS SDK:保留自有页面,复用聊天与结果能力
衡石 Copilot JS SDK 支持两类常见形态:完整聊天窗,以及放在业务页面局部区域的问答结果卡片。前者适合侧栏助手,后者适合订单详情、经营驾驶舱等已有固定布局的页面。
集成方可以控制挂载容器、显示与隐藏、窗口位置、尺寸、语言,以及受支持的样式与文案。衡石提供问答及图表结果的前端能力。若使用 Agent 模式,SDK 还承担相应的前端运行过程;若使用 Workflow 模式,则由后端推进任务、SDK 承担相应交互与展示。
SDK 的价值:在自有业务页面中复用完整的分析交互,减少重复实现聊天、过程反馈和图表结果展示的工作。集成方仍需理解 SDK 支持的配置与运行方式。
SDK 配置可指定问答使用的数据包、数据集或主题域等范围。该配置帮助任务定位资源,实际访问仍需满足登录身份与资源授权。切换客户、租户或账号时,宿主系统应重新确认身份、数据范围和会话归属,避免将上一个业务上下文带入新的页面。
项目还应维护 SDK 与服务端版本的兼容关系,并验证静态资源域名、接口地址和跨域配置。SDK 不会自动把衡石结果转为集成方自研图表库的协议;需要完全自绘时,开发团队应另行评估结果解析、交互和持续适配成本。
四、API:将数据服务和智能分析接进自有流程
1. 分清数据服务 API 与 Data Agent 接入
衡石的数据服务可以将连接、数据集或图表结果发布为接口,支持聚合数据、明细数据、自定义查询和注册 API,并提供发布、授权、限流与监控等管理能力。这适合业务页面直接消费既有分析结果。
Data Agent API 接入面向问答与分析执行。企业已有 AI 网关、多 Agent 编排或后端业务流程时,可以将衡石接成一项数据分析能力。项目需要明确采用的运行方式,以及请求、状态、结果展示和异常处理的责任。两类 API 可以按任务配合使用,但调用一个数据接口不等于已经接入完整的 Agentic BI 体验。
2. 将调用身份落实到授权配置
集成方应在可信服务端管理 API 客户端凭据,按配置获取调用所需的 Access Token,并核对实际执行身份、授权对象和数据范围。后台服务凭据和页面登录态需要分别管理,不能因为业务用户已登录宿主系统,就认为一个后台管理员令牌代表了该用户。
API 的总成本取决于项目承担多少工作。直接消费聚合结果可能很轻;自建多轮聊天、图表、筛选联动和错误恢复则涉及更多开发。选型时应列出需要复用的能力,再估算实际工作量。
五、组合交付:父页面助手与嵌入仪表盘协同工作
衡石支持在父页面放置 Copilot JS SDK,同时通过 iframe 嵌入仪表盘,由父页面 Copilot 承接仪表盘中的智能助理入口。用户可以在同一业务页面查看图表、唤起解读,并通过已代理的业务动作与对象继续分析。
这类组合适合已经有门户框架的企业。父页面保留导航和业务操作,iframe 提供仪表盘,父页面助手集中承接问答。集成时需设置准确的父页面 origin、准备相应登录态,并核验用户对仪表盘及图表的权限。Agent 操作 iframe 内部内容时,通过暴露的业务能力完成相应读取或修改。
| 项目需要 | 可优先评估的路径 | 集成方承担的重点 |
|---|---|---|
| 上线完整的数据问答入口 | ChatBI 页面 iframe | 认证、容器尺寸、入口与数据范围 |
| 在已有页面加入侧栏助手或结果卡片 | Copilot JS SDK | 页面布局、会话衔接与 SDK 配置 |
| 在门户中统一看板和智能助理 | 父页面 SDK + iframe 仪表盘 | 跨页面通信、上下文交接与权限验收 |
| 向自研界面提供既有分析结果 | 数据服务 API | 结果消费、界面和交互实现 |
| 接入自有后端分析流程 | Data Agent API 接入方案 | 运行服务、编排、状态与异常处理 |
六、方案示例:在连锁运营门户中交付分析能力
以下为虚拟方案示例。一家连锁企业希望区域经理在运营门户中查看月度销售,并继续分析退货变化。页面保留企业自己的导航和门店管理入口,经营看板采用衡石 iframe,父页面通过 Copilot JS SDK 提供分析助手。
- 数据团队准备模型。整理订单、退款和门店数据,确认指标与统计周期,制作基础看板。
- 集成团队准备身份。对接 SSO 或 JWT,将区域经理映射为明确的衡石用户,再配置其区域数据权限。
- 在门户中衔接任务。把当前门店和日期作为分析上下文,在用户切换页面时同步更新;查看图表后,可以继续发起相关问答。
- 将验证后的成果继续交付。需要固定展示的数据采用相应看板或数据服务;需要持续追问的场景保留聊天交互。
验收时,团队应检查账号切换、区域切换、连续追问、退出重登和页面重新加载。使用相同指标定义与同一数据范围核对看板和问答结果;出现差异时,按时间条件、刷新状态、执行身份和计算定义定位原因。
七、衡石的嵌入优势,体现在可复用的分析交付链路
衡石将数据建模、应用创作、智能问答和对外服务放在相互衔接的平台中,企业可以按项目需要复用完整页面、聊天组件或后端能力。交付团队由此能够将更多精力投入业务流程、数据定义与身份授权,同时保留自有产品的页面框架和客户关系。清楚划分运行、界面和授权责任,是持续维护 Agentic BI 集成的基础。