智能分析Agent 三方集成说明--数据智能体-火山引擎

文档中心

立即注册

导航

智能分析Agent 三方集成说明

最近更新时间：2025.10.09 17:35:36首次发布时间：2025.04.28 19:57:29

本文为您介绍的是智能分析 Agent 的三方集成说明，您将了解到如何通过 API 进行 Web 端和移动端接入智能体。

注意事项

在您使用本文所述的 API 前，还需完成接入 JWT-Token 和申请 Token 的前置操作，请先了解调用方式，详情可阅读调用方式。
当前支持的地域（region）有：
- 华北2（北京），RegionID 为 cn-beijing
- 华东2（上海），RegionID 为 cn-shanghai

三方集成方案接口

Web 端接入

基于 JWT-Token + iframe 效果如下图：

通用智能体	专业智能体

请求参数

参数	类型	是否必选	示例值	描述
domain	string	是	`https://console.volcengine.com/bi/datawind-open`	域名 Saas环境 domain: `https://console.volcengine.com/bi/datawind-open` 私有化domain: 实际部署的环境域名地址 `${domain}/bi`
APPID	number	是	1	项目 id ，获取方式见说明
jwtToken	string	是	`eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoib3BlbmFwaSIsInVzZXJuYW1lIjoiYWRtaW4iLCJ1c2VyX3BheWxvYWQiOnt9LCJleHAiOjE3NDM1NjY0OTEsImNsaWVudF9pZCI6ImYzMDE5ZGMzZmZmNTE1MzhkMjM5Nzc0ZmI3ZjI4Mzg4In0.gHN39Aq3XQkiZpCJmcvBLaH1eM******`	用户 jwtToken，获取方式见调用方式
AGENT_ID	number	是	1	智能体 id，获取方式见说明
feature	json	否	'{}'	详见特性配置。

说明

APPID和AGENT_ID获取方式见智能体网页链接：

请求示例

<iframe
    src={`${domain}?region=${region}/#/agent?agentId=${AGENT_ID}&appId=${APPID}&inline=true&jwtToken=${jwtToken}&region=${region}`}
/>

移动端接入

移动端视图可用于移动端 H5、侧边栏/浮窗唤起或者空间较小的时候进行接入。移动端视图与 PC 端视图会话完全一致，只是展示的效果不同。智能体页面做了自适应，在移动端访问时，会自动切换到移动端视图。
移动端接入效果预览，如下图所示：

接入方式：正常使用移动端设备访问时会自动切换到移动端视图，也可以使用参数强制切换到移动端视图。在 url的queryString后增加 &forceMobile=true。

请求参数

同上文 Web端接入 - 请求参数

请求示例

<iframe 
    src={`${domain}?region=${region}/#/agent?agentId=${agentId}&appId=${APPID}&jwtToken=${jwtToken}&region=${region}&inline=true&forceMobile=true`}
/>