一、集成方工作清单
1. 云账号托管能力建设:
客户要在云控制台生成 aksk,然后配置到集成商的数据库里面,并且授权给集成商进行调用;
托管客户 aksk 及映射自有账号体系和 uin 的对应关系;
2. 数智人平台菜单框架开发及集成:
集成商通过菜单接口获取菜单,集成数智人平台的页面;
集成数智人接口获取客户购买的菜单范围、生成菜单页面访问的 token 追加在 url 之后;
3. token 回调检查接口:
集成商进行 token 回调,返回客户托管的 aksk 信息;
当数智人页面打开时,会拿到 url 上的带参 token,回调集成商系统检查 token 合法有效性,并希望集成商返回该 token 对应的客户已托管的 uin、ak、sk 信息。
二、集成过程说明
1. 客户 uin、aksk 托管。![](https://qcloudimg.tencent-cloud.cn/image/document/97bc6cedf3f34f9702fcdaf5f1c421aa.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/97bc6cedf3f34f9702fcdaf5f1c421aa.png)
2. 集成商系统主框架加载![](https://qcloudimg.tencent-cloud.cn/image/document/b75797d4f663ced047f95c277d140062.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/b75797d4f663ced047f95c277d140062.png)
3. 集成商系统内打开数字人页面![](https://qcloudimg.tencent-cloud.cn/image/document/0397932a572325c4ca56373eb296e577.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/0397932a572325c4ca56373eb296e577.png)
三、页面嵌入规范
嵌入方式
通过 iframe 集成,使用下面的 URL 在客户业务系统中嵌入数智人平台页面。
参数:from 指来源系统标识,由数智人侧分配;token 由集成商生成,背后对应客户的 uin、aksk,当访问页面时数智人侧会回调接口通过 token 换取 uin 和 aksk。
嵌入范围
音视频播报列表
音视频制作页面-编辑
音视频制作页面-新建
会话互动列表
交互大模型页面
运营管理
资产管理
代码示例
menuData =
[
{
"Code"
:
"VideoBroadcastList"
,
"Url"
:
"/ivh/#/application?iframe=true&token=xxx"
,
"Name"
:
"音视频播报列表"
}
,
{
"Code"
:
"VideoBroadcastMake"
,
"Url"
:
"/ivh/#/bvh_page?iframe=true&page=xxx&name=xxx&token=xxx"
,
"Name"
:
"音视频制作页面-编辑"
}
,
{
"Code"
:
"VideoBroadcastMakeNew"
,
"Url"
:
"/ivh/#/bvh_page?iframe=true&page=xxx&token=xxx"
,
"Name"
:
"音视频制作页面-新建"
}
,
{
"Code"
:
"InteractionList"
,
"Url"
:
"/ivh/#/application?iframe=true&token=xxx"
,
"Name"
:
"会话互动列表"
}
,
{
"Code"
:
"InteractionCloudAI"
,
"Url"
:
"/ivh/#/lke/robot-manage/knowledge/qa-source?iframe=true&vkey=xxx&botid=xxx&token=xxx"
,
"Name"
:
"交互大模型页面"
}
,
{
"Code"
:
"OperationManagement"
,
"Url"
:
"/ivh/#/analysis?iframe=true&token=xxx"
,
"Name"
:
"运营管理"
}
,
{
"Code"
:
"AssetManagement"
,
"Url"
:
"/ivh/#/asserts_management?iframe=true&token=xxx"
,
"Name"
:
"资产管理"
}
]
;
token 回调检查接口规范
协议:http/https,建议https请求method:POST请求content-type:application/json请求body:{"token": "",// 集成商生成,在页面嵌入时在url中追加的token参数。}返回结构要求{"request_id": "", // 唯一请求id"code":0,"message":"ok","merchantID": "", // 集成商id,腾讯分配,在页面嵌入时在url中追加的from参数。"merchantUin": // 托管的客户uin"MerchantSubAccountUin": // 托管的客户子账号uin"sessionToken":{"secretId": // 秘钥id ,建议使用临时秘钥返回"secretKey": // 秘钥key,建议使用临时秘钥返回}}接口开发完成后,提交给产品运营人员进行相关配置,自助式配置方式研发中,敬请期待。
四、页面样式规范
可配置样式范围
针对 iframe 嵌入的页面,目前已支持一键更换主题色、logo 配置的功能。
配置方式
具体能力详见下面的配置内容:
{"iframeConfig": true, // 表示当前是iframe潜入,并且支持换肤能力"hideHeader": true, // 隐藏数智人平台的头部内容"hideSidebar": true, // 隐藏数智人平台的左侧菜单内容"logoUrl": "/logo.png",// 更换数智人头部的logo信息// 页面相关的tab可以通过权限控制隐藏显示。// 主题色配置"theme": {"primaryColor": "green","primaryColorHover": "green","primaryColorActive": "darkred","iconColor": "green"// ....antd支持的主题样式配置。}}