AI答疑助手SDK
更新时间:2025-11-27 23:11:32
概述
AI答疑助手SDK是基于polyv AI知识库答疑助手的js sdk,提供了可嵌入到网页中的答疑助手组件,用户可以通过集成该组件内嵌到自己的网页中,从而向polyv AI知识库中的构建的知识库提问问题,获取答案。
快速集成
js demo
<script src="https://websdk.videocc.net/ai-chat-bot/latest/polyv-ai-chat-bot.umd.js"></script>
<script>
// AI聊天组件初始化
PolyvAIChatBot.polyvAIChat.init({
aiId: '1159',
getToken: async (viewerId) => {
const response = await fetch(`https://domain/token?viewerId=${viewerId}`); // 替换为实际的获取token的接口
const data = await response.json();
return data.data;
},
customText: {
title: '保利威直播 - 引领直播行业',
placeholder: '输入消息...',
sendButtonText: '发送',
},
customUi: {
themeColor: '#0067C8'
}
});
</script>
- 其中,获取token的接口需要客户自行实现,并以参数的方式传递给构建的对象。
以下是使用Python FastAPI 实现获取token的示例代码:
python实现获取token案例
from fastapi import FastAPI
app = FastAPI()
@app.get("/api/token")
async def get_chat_token(viewerId: str):
"""获取AI答疑助手Token的接口"""
form_data = {
"appId": "# 客户在保利威的appId",
"timestamp": int(time.time() * 1000),
"viewerId": viewerId
}
form_data["sign"] = create_api_sign("# 客户在保利威的secret_key", form_data)
# 发送请求到保利威获取
response = requests.post(
"https://api.polyv.net/live/v3/common/token/get-ai-token",
data=form_data
)
result = response.json()
# 只返回token值
if result.get("code") == 200:
return {
"code": 200,
"message": "success",
"data": result.get('data')
}
if __name__ == "__main__":
import uvicorn
uvicorn.run(app, host="0.0.0.0", port=8002)
- 其中,appId和secret_key需要客户在保利威申请,具体请联系保利威技术支持。
- 方法create_api_sign 签名生成规则参考签名生成规则
- 以上代码仅供参考,具体实现请根据实际情况进行调整。
参数说明
| 参数名 | 类型 | 说明 | 是否必填 | 默认值 |
|---|---|---|---|---|
| aiId | string | AI答疑助手ID,从保利威后台->AI应用 ->AI答疑助手 获取对应的aiId | 是 | 无 |
| getToken | function | 获取token的方法,需自行实现 | 是 | 无 |
| position | string | 挂件位置,支持 left、right | 否 | right |
| width | string | 挂件宽度 | 否 | 400px |
| height | string | 挂件高度 | 否 | 600px |
| customText | object | 用户可自定义的文本内容 | 否 | 无 |
| customText.title | string | 聊天窗口标题 | 否 | 保利威AI助手 |
| customText.placeholder | string | 输入框placeholder | 否 | 输入消息... |
| customText.sendButtonText | string | 发送按钮文案 | 否 | 发送 |
| customUi | object | 否 | 无 | |
| customUi.themeColor | string | 主题色 | 否 | #1890ff |
| customUi.widgetIcon | string | 挂件icon样式 | 否 | 默认图片 |
| customUi.userAvatar | string | 用户头像 | 否 | 默认图片 |
| customUi.assistantAvatar | string | AI助手头像 | 否 | 默认图片 |
一个完整的配置示例:
{
aiId: '1159',
getToken: async (viewerId) => {
const response = await fetch(`https://domain/token?viewerId=${viewerId}`); // 替换为实际的获取token的接口
const data = await response.json();
return data.data;
},
position: 'right',
width: '400px',
height: '600px',
customText: {
title: '保利威AI视频 - 引领视频新时代',
placeholder: '输入消息...',
sendButtonText: '发送',
},
customUi: {
themeColor: '#0067C8',
widgetIcon: 'https://domain/widgetIcon.png',
userAvatar: 'https://domain/userAvatar.png',
assistantAvatar: 'https://domain/assistantAvatar.png',
}
}
