保利威文档中心

帮助中心

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',
        }
    }
联系客服,在线咨询
在线咨询